Overview
Asset Information Centre is a single-page application (SPA) that runs in the browser and connects to Google Firebase for authentication and data storage. There is no separate backend server — business logic lives in the React frontend and Firestore security rules.
What you need before starting
- A computer with Node.js 18+ installed
- A Firebase project with Authentication and Firestore enabled
- Git to clone the repository
- (Optional) Firebase CLI for deploying rules and hosting
High-level architecture
┌─────────────────┐ HTTPS ┌──────────────────┐
│ Web Browser │ ◄────────────► │ Firebase Auth │
│ (React + Vite) │ └──────────────────┘
│ │ HTTPS ┌──────────────────┐
│ │ ◄────────────► │ Cloud Firestore │
└─────────────────┘ └──────────────────┘
Application modules
| Module | Route | Description |
|---|---|---|
| Dashboard | /dashboard | Role-based overview |
| Assets | /assets | Asset registry & lifecycle |
| Asset Requests | /asset-requests | Request & approval workflow |
| Workflow Inbox | /workflow-inbox | Pending approvals |
| Mail Inbox | /mail-inbox | In-app mail |
| Departments | /departments | Org structure |
| Employees | /users | User management |
| Site Map | /location-map | Floor plans & zones |
| Locations | /locations | Branch master data |
| Organizations | /organizations | Company master data |
| Reports | /reports | Analytics & export |
| Activity Log | /activity-log | Audit trail |
| Automation Hub | /automation-hub | RFID, barcode, discovery |
| Settings | /settings | Platform configuration (Super Admin) |
Next steps
→ Prerequisites — software versions and accounts
→ Installation — clone, install, configure, run
→ Quick Start — create Super Admin and first login