# abdulbaseer135/adil-petrolium architecture

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

- Interactive diagram: https://gitdiagram.com/abdulbaseer135/adil-petrolium
- Repository: https://github.com/abdulbaseer135/adil-petrolium

## Overview

Tail Website is a petroleum-dealer fuel management and customer-statement platform. Admins manage customers and fuel transactions, then review daily/monthly/yearly reports or export statements; customers sign in to view balances and statements. The React app uses a protected API backed by MongoDB. The graph preserves authentication, transaction/customer management, reporting/export, audit, and SSE capabilities. Some routes and services were not sampled, so uncertain wiring is omitted; dashed links indicate frontend-to-API interactions not shown directly in the excerpts.

Main entry points: [`backend/src/models`](https://github.com/abdulbaseer135/adil-petrolium/tree/main/backend/src/models) (MongoDB models), [`backend/src/routes/index.js`](https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/routes/index.js) (Route registry), [`backend/src/controllers/reportController.js`](https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/controllers/reportController.js) (Report handling), [`frontend/src/App.js`](https://github.com/abdulbaseer135/adil-petrolium/blob/main/frontend/src/App.js) (App routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["React application"]
  node_app["App routing<br/>[App.js]"]
  node_auth_state["Auth state<br/>[authSlice.js]"]
  node_api_client["HTTP client<br/>[axiosClient.js]"]
  node_admin_ui["Admin workflows"]
  node_customer_ui["Customer statements"]
end

subgraph group_api["API and security"]
  node_backend_entry["API server<br/>[server.js]"]
  node_route_registry["Route registry<br/>[index.js]"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_auth_logic["Authentication<br/>[authService.js]"]
  node_auth_guard["Access control<br/>[auth.js]"]
  node_customer_routes["Customer routes<br/>[customerRoutes.js]"]
  node_transaction_routes["Transaction routes"]
  node_report_routes["Report routes<br/>[reportRoutes.js]"]
  node_sse["SSE updates<br/>[eventsRoutes.js]"]
end

subgraph group_domain["Dealer operations"]
  node_customer_ops["Customer management<br/>[customerService.js]"]
  node_transaction_ops["Transaction operations"]
  node_daily_ops["Daily records"]
end

subgraph group_reporting["Statements and reports"]
  node_report_controller["Report handling"]
  node_excel_export["Excel exports<br/>[excelService.js]"]
  node_statement_export["Statement exports"]
end

subgraph group_persistence["Persistence and activity"]
  node_audit["Audit logging<br/>[auditService.js]"]
  node_models["MongoDB models"]
  node_mongo[("MongoDB<br/>[database.js]")]
end

node_admin(("Admin"))
node_customer(("Customer"))

node_admin -->|"uses"| node_app
node_customer -->|"uses"| node_app
node_app -->|"routes to"| node_admin_ui
node_app -->|"routes to"| node_customer_ui
node_app -->|"loads session"| node_auth_state
node_auth_state -->|"resets tokens"| node_api_client
node_admin_ui -.->|"requests API"| node_api_client
node_customer_ui -.->|"requests API"| node_api_client
node_api_client -.->|"calls API"| node_backend_entry
node_backend_entry -->|"mounts routes"| node_route_registry
node_route_registry -->|"registers"| node_auth_routes
node_route_registry -->|"registers"| node_customer_routes
node_route_registry -->|"registers"| node_transaction_routes
node_route_registry -->|"registers"| node_report_routes
node_route_registry -->|"registers"| node_sse
node_auth_routes -.->|"delegates to"| node_auth_logic
node_auth_logic -->|"reads and writes"| node_models
node_auth_logic -->|"records activity"| node_audit
node_customer_routes -->|"protects routes"| node_auth_guard
node_transaction_routes -->|"protects routes"| node_auth_guard
node_report_routes -->|"protects routes"| node_auth_guard
node_customer_routes -->|"delegates to"| node_customer_ops
node_transaction_routes -->|"dispatches to"| node_transaction_ops
node_transaction_ops -.->|"uses records"| node_models
node_daily_ops -.->|"uses records"| node_models
node_report_routes -->|"dispatches to"| node_report_controller
node_report_controller -->|"generates workbook"| node_excel_export
node_report_controller -->|"generates statement"| node_statement_export
node_report_controller -->|"queries transactions"| node_models
node_report_controller -->|"audits exports"| node_audit
node_excel_export -->|"reads records"| node_models
node_statement_export -->|"reads records"| node_models
node_models -.->|"persists data"| node_mongo
node_sse -.->|"streams updates"| node_customer

click node_app "https://github.com/abdulbaseer135/adil-petrolium/blob/main/frontend/src/App.js"
click node_auth_state "https://github.com/abdulbaseer135/adil-petrolium/blob/main/frontend/src/store/authSlice.js"
click node_api_client "https://github.com/abdulbaseer135/adil-petrolium/blob/main/frontend/src/api/axiosClient.js"
click node_admin_ui "https://github.com/abdulbaseer135/adil-petrolium/tree/main/frontend/src/pages/admin"
click node_customer_ui "https://github.com/abdulbaseer135/adil-petrolium/tree/main/frontend/src/pages/customer"
click node_backend_entry "https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/server.js"
click node_route_registry "https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/routes/index.js"
click node_auth_routes "https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/routes/authRoutes.js"
click node_auth_logic "https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/services/authService.js"
click node_auth_guard "https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/middleware/auth.js"
click node_customer_routes "https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/routes/customerRoutes.js"
click node_customer_ops "https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/services/customerService.js"
click node_transaction_routes "https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/routes/transactionRoutes.js"
click node_transaction_ops "https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/services/transactionService.js"
click node_daily_ops "https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/services/dailyRecordService.js"
click node_report_routes "https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/routes/reportRoutes.js"
click node_report_controller "https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/controllers/reportController.js"
click node_excel_export "https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/services/excelService.js"
click node_statement_export "https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/services/professionalStatementService.js"
click node_audit "https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/services/auditService.js"
click node_models "https://github.com/abdulbaseer135/adil-petrolium/tree/main/backend/src/models"
click node_mongo "https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/config/database.js"
click node_sse "https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/routes/eventsRoutes.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_auth_state,node_api_client,node_admin_ui,node_customer_ui toneBlue
class node_backend_entry,node_route_registry,node_auth_routes,node_auth_logic,node_auth_guard,node_customer_routes,node_transaction_routes,node_report_routes,node_sse toneAmber
class node_customer_ops,node_transaction_ops,node_daily_ops toneMint
class node_report_controller,node_excel_export,node_statement_export toneRose
class node_audit,node_models,node_mongo,node_admin,node_customer toneIndigo
```

## Components

### React application

- [App routing](https://github.com/abdulbaseer135/adil-petrolium/blob/main/frontend/src/App.js): `frontend/src/App.js`
- [Auth state](https://github.com/abdulbaseer135/adil-petrolium/blob/main/frontend/src/store/authSlice.js): `frontend/src/store/authSlice.js`
- [HTTP client](https://github.com/abdulbaseer135/adil-petrolium/blob/main/frontend/src/api/axiosClient.js): `frontend/src/api/axiosClient.js`
- [Admin workflows](https://github.com/abdulbaseer135/adil-petrolium/tree/main/frontend/src/pages/admin): `frontend/src/pages/admin`
- [Customer statements](https://github.com/abdulbaseer135/adil-petrolium/tree/main/frontend/src/pages/customer): `frontend/src/pages/customer`

### API and security

- [API server](https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/server.js): `backend/src/server.js`
- [Route registry](https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/routes/index.js): `backend/src/routes/index.js`
- [Auth routes](https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/routes/authRoutes.js): `backend/src/routes/authRoutes.js`
- [Authentication](https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/services/authService.js): `backend/src/services/authService.js`
- [Access control](https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/middleware/auth.js): `backend/src/middleware/auth.js`
- [Customer routes](https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/routes/customerRoutes.js): `backend/src/routes/customerRoutes.js`
- [Transaction routes](https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/routes/transactionRoutes.js): `backend/src/routes/transactionRoutes.js`
- [Report routes](https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/routes/reportRoutes.js): `backend/src/routes/reportRoutes.js`
- [SSE updates](https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/routes/eventsRoutes.js): `backend/src/routes/eventsRoutes.js`

### Dealer operations

- [Customer management](https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/services/customerService.js): `backend/src/services/customerService.js`
- [Transaction operations](https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/services/transactionService.js): `backend/src/services/transactionService.js`
- [Daily records](https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/services/dailyRecordService.js): `backend/src/services/dailyRecordService.js`

### Statements and reports

- [Report handling](https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/controllers/reportController.js): `backend/src/controllers/reportController.js`
- [Excel exports](https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/services/excelService.js): `backend/src/services/excelService.js`
- [Statement exports](https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/services/professionalStatementService.js): `backend/src/services/professionalStatementService.js`

### Persistence and activity

- [Audit logging](https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/services/auditService.js): `backend/src/services/auditService.js`
- [MongoDB models](https://github.com/abdulbaseer135/adil-petrolium/tree/main/backend/src/models): `backend/src/models`
- [MongoDB](https://github.com/abdulbaseer135/adil-petrolium/blob/main/backend/src/config/database.js): `backend/src/config/database.js`

### Other components

- **Admin**
- **Customer**

## Connections

- Admin → App routing: uses (evidence: `frontend/src/App.js`)
- Customer → App routing: uses (evidence: `frontend/src/App.js`)
- App routing → Admin workflows: routes to (evidence: `frontend/src/App.js`)
- App routing → Customer statements: routes to (evidence: `frontend/src/App.js`)
- App routing → Auth state: loads session (evidence: `frontend/src/App.js`)
- Auth state → HTTP client: resets tokens (evidence: `frontend/src/store/authSlice.js`)
- Admin workflows → HTTP client: requests API
- Customer statements → HTTP client: requests API
- HTTP client → API server: calls API
- API server → Route registry: mounts routes (evidence: `backend/src/server.js`)
- Route registry → Auth routes: registers (evidence: `backend/src/routes/index.js`)
- Route registry → Customer routes: registers (evidence: `backend/src/routes/index.js`)
- Route registry → Transaction routes: registers (evidence: `backend/src/routes/index.js`)
- Route registry → Report routes: registers (evidence: `backend/src/routes/index.js`)
- Route registry → SSE updates: registers (evidence: `backend/src/routes/index.js`)
- Auth routes → Authentication: delegates to
- Authentication → MongoDB models: reads and writes (evidence: `backend/src/services/authService.js`)
- Authentication → Audit logging: records activity (evidence: `backend/src/services/authService.js`)
- Customer routes → Access control: protects routes (evidence: `backend/src/routes/customerRoutes.js`)
- Transaction routes → Access control: protects routes (evidence: `backend/src/routes/transactionRoutes.js`)
- Report routes → Access control: protects routes (evidence: `backend/src/routes/reportRoutes.js`)
- Customer routes → Customer management: delegates to
- Transaction routes → Transaction operations: dispatches to (evidence: `backend/src/routes/transactionRoutes.js`)
- Transaction operations → MongoDB models: uses records
- Daily records → MongoDB models: uses records
- Report routes → Report handling: dispatches to (evidence: `backend/src/routes/reportRoutes.js`)
- Report handling → Excel exports: generates workbook (evidence: `backend/src/controllers/reportController.js`)
- Report handling → Statement exports: generates statement (evidence: `backend/src/controllers/reportController.js`)
- Report handling → MongoDB models: queries transactions (evidence: `backend/src/controllers/reportController.js`)
- Report handling → Audit logging: audits exports (evidence: `backend/src/controllers/reportController.js`)
- Excel exports → MongoDB models: reads records (evidence: `backend/src/services/excelService.js`)
- Statement exports → MongoDB models: reads records (evidence: `backend/src/services/professionalStatementService.js`)
- MongoDB models → MongoDB: persists data
- SSE updates → Customer: streams updates
