Skip to main content

Quick Start

Get from zero to a working demo in under 15 minutes.

1. Clone and run​

git clone https://github.com/Raj010505/Asset-Management.git
cd Asset-Management
npm install
cp .env.example .env
# Edit .env with Firebase credentials
npm run dev

2. Create Super Admin​

Firebase Auth user + Firestore users/{uid} document with role: "super_admin".

3. Initial platform setup (Super Admin)​

After first login, complete these in order:

Settings → Platform​

  1. Firebase Backend Setup — confirm project connection
  2. Reliance demo seed (optional) — loads sample orgs, locations, departments, employees, assets

Settings → Authentication​

  1. Enable SSO providers if needed (Google, Microsoft, OIDC)
  2. Configure MFA and passkey policies under Security tab

Settings → Roles & Permissions​

  1. Open the Role & Permission Matrix
  2. Review default permissions for Administrator, IT Manager, Finance, etc.
  3. Save any customizations

4. Organization master data​

MenuAction
OrganizationsAdd your company
LocationsAdd branch offices
DepartmentsAdd departments with Branch and Zone fields
EmployeesImport or add users with roles

Zones on the Site Map are derived automatically from department zone fields.

5. Site map setup​

  1. Go to Site Map
  2. Select Company → Branch → Zone
  3. Add floors (requires sitemap.floors permission)
  4. Select a floor → Design mode → draw cabins and assign employees

6. Assets and requests​

  1. Assets — add or import IT assets
  2. Asset Requests — employees submit requests; approvers use Workflow Inbox

7. Reports​

Reports → choose report type → export Excel or PDF.

Demo data shortcut​

Super Admin → Settings → Platform → Reliance demo seed creates:

  • 4 organizations (Reliance, Jio, Trends, Digital)
  • 8 locations, 5 departments, 30 employees, 50 assets
  • Site map nodes

Use this for demos and UAT without manual data entry.

Next steps​

→ Firebase Setup
→ Role Permissions
→ Assets Module