# anay-alai/assetflow-odoo architecture

> Architecture diagram of the GitHub repository anay-alai/assetflow-odoo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/anay-alai/assetflow-odoo
- Repository: https://github.com/anay-alai/assetflow-odoo

## Overview

AssetFlow is an organization-wide asset and shared-resource management product. Employees and managers use its web screens to manage assets, allocations and transfers, bookings, maintenance, audits, organization settings, and reports; backend routes and controllers handle requests, with Sequelize-backed records and notifications/activity logs. Scheduled jobs support overdue checks and reminders. The README documents broader workflows than the excerpts demonstrate; uncertain frontend-to-endpoint wiring is therefore left unasserted.

Main entry points: [`frontend/src/App.jsx`](https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/App.jsx) (Screen routing), [`backend/src/app.js`](https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/app.js) (Express API), [`frontend/src/api/client.js`](https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/api/client.js) (API client), [`backend/src/models/index.js`](https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/models/index.js) (Domain records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["Screen routing<br/>[App.jsx]"]
  node_authctx["Session context<br/>[AuthContext.jsx]"]
  node_apiclient["API client<br/>[client.js]"]
  node_dashboard["Dashboard<br/>[Dashboard.jsx]"]
  node_orgsetup["Organization setup<br/>[OrgSetup.jsx]"]
  node_assets["Asset directory<br/>[Assets.jsx]"]
  node_allocations["Allocations<br/>[Allocations.jsx]"]
  node_bookings["Bookings<br/>[Bookings.jsx]"]
  node_maintenance["Maintenance<br/>[Maintenance.jsx]"]
  node_audits["Audit cycles<br/>[Audits.jsx]"]
  node_reports["Reports<br/>[Reports.jsx]"]
end

subgraph group_api["API and workflows"]
  node_api["Express API<br/>[app.js]"]
  node_auth["Authentication<br/>[authMiddleware.js]"]
  node_orgctrl["Organization management<br/>[orgController.js]"]
  node_assetctrl["Asset management<br/>[assetController.js]"]
  node_allocationctrl["Allocation and transfer"]
  node_auditctrl["Audit workflow<br/>[auditController.js]"]
  node_maintctrl["Maintenance workflow"]
  node_reportctrl["Analytics and exports"]
  node_server["API process<br/>[server.js]"]
end

subgraph group_data["Persistence and records"]
  node_models[("Domain records<br/>[index.js]")]
end

subgraph group_ops["Notifications and jobs"]
  node_notify["Notification service"]
  node_activity["Activity logging<br/>[activityLogger.js]"]
  node_jobs["Scheduled checks<br/>[index.js]"]
end

node_user(("Organization users"))

node_user -->|"uses"| node_app
node_app -->|"routes to"| node_dashboard
node_app -->|"routes to"| node_orgsetup
node_app -->|"routes to"| node_assets
node_app -->|"routes to"| node_allocations
node_app -->|"routes to"| node_bookings
node_app -->|"routes to"| node_maintenance
node_app -->|"routes to"| node_audits
node_app -->|"routes to"| node_reports
node_app -->|"provides"| node_authctx
node_authctx -->|"requests identity"| node_apiclient
node_assets -->|"requests data"| node_apiclient
node_allocations -->|"requests data"| node_apiclient
node_bookings -->|"requests data"| node_apiclient
node_maintenance -->|"requests data"| node_apiclient
node_audits -->|"requests data"| node_apiclient
node_orgsetup -->|"requests data"| node_apiclient
node_reports -->|"requests data"| node_apiclient
node_apiclient -.->|"sends requests"| node_api
node_server -->|"starts"| node_api
node_server -->|"starts jobs"| node_jobs
node_api -.->|"routes through"| node_auth
node_api -->|"dispatches to"| node_orgctrl
node_api -->|"dispatches to"| node_assetctrl
node_api -->|"dispatches to"| node_allocationctrl
node_api -->|"dispatches to"| node_auditctrl
node_api -->|"dispatches to"| node_maintctrl
node_api -->|"dispatches to"| node_reportctrl
node_orgctrl -->|"reads and writes"| node_models
node_assetctrl -->|"reads and writes"| node_models
node_allocationctrl -->|"reads and writes"| node_models
node_auditctrl -->|"reads and writes"| node_models
node_maintctrl -->|"reads and writes"| node_models
node_reportctrl -->|"reads"| node_models
node_allocationctrl -->|"creates alerts"| node_notify
node_auditctrl -->|"creates alerts"| node_notify
node_maintctrl -->|"creates alerts"| node_notify
node_allocationctrl -->|"logs actions"| node_activity
node_auditctrl -->|"logs actions"| node_activity
node_maintctrl -->|"logs actions"| node_activity
node_jobs -.->|"sends reminders"| node_notify

click node_app "https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/App.jsx"
click node_authctx "https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/context/AuthContext.jsx"
click node_apiclient "https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/api/client.js"
click node_dashboard "https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/pages/Dashboard.jsx"
click node_orgsetup "https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/pages/OrgSetup.jsx"
click node_assets "https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/pages/Assets.jsx"
click node_allocations "https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/pages/Allocations.jsx"
click node_bookings "https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/pages/Bookings.jsx"
click node_maintenance "https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/pages/Maintenance.jsx"
click node_audits "https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/pages/Audits.jsx"
click node_reports "https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/pages/Reports.jsx"
click node_api "https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/app.js"
click node_auth "https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/middleware/authMiddleware.js"
click node_orgctrl "https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/controllers/orgController.js"
click node_assetctrl "https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/controllers/assetController.js"
click node_allocationctrl "https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/controllers/allocationController.js"
click node_auditctrl "https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/controllers/auditController.js"
click node_maintctrl "https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/controllers/maintenanceController.js"
click node_reportctrl "https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/controllers/reportController.js"
click node_models "https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/models/index.js"
click node_notify "https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/services/notification.service.js"
click node_activity "https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/utils/activityLogger.js"
click node_jobs "https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/jobs/index.js"
click node_server "https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/server.js"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app,node_authctx,node_apiclient,node_dashboard,node_orgsetup,node_assets,node_allocations,node_bookings,node_maintenance,node_audits,node_reports,node_user toneBlue
class node_api,node_auth,node_orgctrl,node_assetctrl,node_allocationctrl,node_auditctrl,node_maintctrl,node_reportctrl,node_server toneAmber
class node_models toneMint
class node_notify,node_activity,node_jobs toneRose
```

## Components

### Web application

- [Screen routing](https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Session context](https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [API client](https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`
- [Dashboard](https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`
- [Organization setup](https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/pages/OrgSetup.jsx): `frontend/src/pages/OrgSetup.jsx`
- [Asset directory](https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/pages/Assets.jsx): `frontend/src/pages/Assets.jsx`
- [Allocations](https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/pages/Allocations.jsx): `frontend/src/pages/Allocations.jsx`
- [Bookings](https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/pages/Bookings.jsx): `frontend/src/pages/Bookings.jsx`
- [Maintenance](https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/pages/Maintenance.jsx): `frontend/src/pages/Maintenance.jsx`
- [Audit cycles](https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/pages/Audits.jsx): `frontend/src/pages/Audits.jsx`
- [Reports](https://github.com/anay-alai/assetflow-odoo/blob/main/frontend/src/pages/Reports.jsx): `frontend/src/pages/Reports.jsx`

### API and workflows

- [Express API](https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/app.js): `backend/src/app.js`
- [Authentication](https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/middleware/authMiddleware.js): `backend/src/middleware/authMiddleware.js`
- [Organization management](https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/controllers/orgController.js): `backend/src/controllers/orgController.js`
- [Asset management](https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/controllers/assetController.js): `backend/src/controllers/assetController.js`
- [Allocation and transfer](https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/controllers/allocationController.js): `backend/src/controllers/allocationController.js`
- [Audit workflow](https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/controllers/auditController.js): `backend/src/controllers/auditController.js`
- [Maintenance workflow](https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/controllers/maintenanceController.js): `backend/src/controllers/maintenanceController.js`
- [Analytics and exports](https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/controllers/reportController.js): `backend/src/controllers/reportController.js`
- [API process](https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/server.js): `backend/src/server.js`

### Persistence and records

- [Domain records](https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/models/index.js): `backend/src/models/index.js`

### Notifications and jobs

- [Notification service](https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/services/notification.service.js): `backend/src/services/notification.service.js`
- [Activity logging](https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/utils/activityLogger.js): `backend/src/utils/activityLogger.js`
- [Scheduled checks](https://github.com/anay-alai/assetflow-odoo/blob/main/backend/src/jobs/index.js): `backend/src/jobs/index.js`

### Other components

- **Organization users**

## Connections

- Organization users → Screen routing: uses (evidence: `frontend/src/App.jsx`)
- Screen routing → Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Screen routing → Organization setup: routes to (evidence: `frontend/src/App.jsx`)
- Screen routing → Asset directory: routes to (evidence: `frontend/src/App.jsx`)
- Screen routing → Allocations: routes to (evidence: `frontend/src/App.jsx`)
- Screen routing → Bookings: routes to (evidence: `frontend/src/App.jsx`)
- Screen routing → Maintenance: routes to (evidence: `frontend/src/App.jsx`)
- Screen routing → Audit cycles: routes to (evidence: `frontend/src/App.jsx`)
- Screen routing → Reports: routes to (evidence: `frontend/src/App.jsx`)
- Screen routing → Session context: provides (evidence: `frontend/src/App.jsx`)
- Session context → API client: requests identity (evidence: `frontend/src/context/AuthContext.jsx`)
- Asset directory → API client: requests data (evidence: `frontend/src/pages/Assets.jsx`)
- Allocations → API client: requests data (evidence: `frontend/src/pages/Allocations.jsx`)
- Bookings → API client: requests data (evidence: `frontend/src/pages/Bookings.jsx`)
- Maintenance → API client: requests data (evidence: `frontend/src/pages/Maintenance.jsx`)
- Audit cycles → API client: requests data (evidence: `frontend/src/pages/Audits.jsx`)
- Organization setup → API client: requests data (evidence: `frontend/src/pages/OrgSetup.jsx`)
- Reports → API client: requests data (evidence: `frontend/src/pages/Reports.jsx`)
- API client → Express API: sends requests
- API process → Express API: starts (evidence: `backend/src/server.js`)
- API process → Scheduled checks: starts jobs (evidence: `backend/src/server.js`)
- Express API → Authentication: routes through
- Express API → Organization management: dispatches to (evidence: `backend/src/app.js`)
- Express API → Asset management: dispatches to (evidence: `backend/src/app.js`)
- Express API → Allocation and transfer: dispatches to (evidence: `backend/src/app.js`)
- Express API → Audit workflow: dispatches to (evidence: `backend/src/app.js`)
- Express API → Maintenance workflow: dispatches to (evidence: `backend/src/app.js`)
- Express API → Analytics and exports: dispatches to (evidence: `backend/src/app.js`)
- Organization management → Domain records: reads and writes (evidence: `backend/src/controllers/orgController.js`)
- Asset management → Domain records: reads and writes (evidence: `backend/src/controllers/assetController.js`)
- Allocation and transfer → Domain records: reads and writes (evidence: `backend/src/controllers/allocationController.js`)
- Audit workflow → Domain records: reads and writes (evidence: `backend/src/controllers/auditController.js`)
- Maintenance workflow → Domain records: reads and writes (evidence: `backend/src/controllers/maintenanceController.js`)
- Analytics and exports → Domain records: reads (evidence: `backend/src/controllers/reportController.js`)
- Allocation and transfer → Notification service: creates alerts (evidence: `backend/src/controllers/allocationController.js`)
- Audit workflow → Notification service: creates alerts (evidence: `backend/src/controllers/auditController.js`)
- Maintenance workflow → Notification service: creates alerts (evidence: `backend/src/controllers/maintenanceController.js`)
- Allocation and transfer → Activity logging: logs actions (evidence: `backend/src/controllers/allocationController.js`)
- Audit workflow → Activity logging: logs actions (evidence: `backend/src/controllers/auditController.js`)
- Maintenance workflow → Activity logging: logs actions (evidence: `backend/src/controllers/maintenanceController.js`)
- Scheduled checks → Notification service: sends reminders
