# cecep-darjo/work-order-sparepart architecture

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

- Interactive diagram: https://gitdiagram.com/cecep-darjo/work-order-sparepart
- Repository: https://github.com/cecep-darjo/work-order-sparepart

## Overview

EngWO Inventory is a role-aware work-order and spare-parts inventory application. Users sign in, then use the dashboard and navigation to manage work orders, parts, stock transactions, purchase requirements, goods receipts, and issue slips; administrators also manage master data and review activity. The React app routes to these domain pages, which use a shared Supabase client for persistence. Work-order part requests, action-item notifications, and PDF reports/slips provide supporting workflows. Relationships below follow the app routing and source-index references; unsampled implementation details are not inferred.

Main entry points: [`src/App.tsx`](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/App.tsx) (App routing), [`src/lib/supabase.ts`](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/lib/supabase.ts) (Supabase services), [`src/pages/WorkOrderDetail.tsx`](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/WorkOrderDetail.tsx) (Work order detail), [`src/pages/Transactions.tsx`](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/Transactions.tsx) (Stock transactions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application shell"]
  node_app["App routing<br/>[App.tsx]"]
  node_auth["Authentication<br/>[AuthContext.tsx]"]
  node_login["Login<br/>[Login.tsx]"]
  node_layout["Navigation layout<br/>[Layout.tsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.tsx]"]
  node_activity["Activity log"]
end

subgraph group_work["Work orders"]
  node_workorders["Work orders<br/>[WorkOrders.tsx]"]
  node_detail["Work order detail"]
  node_partrequests["Part requests<br/>[PartRequests.tsx]"]
  node_workreport["WO report PDF<br/>[woReportPdf.ts]"]
end

subgraph group_inventory["Inventory operations"]
  node_spareparts["Spare parts<br/>[SpareParts.tsx]"]
  node_transactions["Stock transactions<br/>[Transactions.tsx]"]
  node_receipts["Goods receipts<br/>[GoodsReceipts.tsx]"]
  node_requirements["Purchase requirements"]
  node_bons["Issue slips<br/>[Bons.tsx]"]
  node_bonlib["Slip calculations<br/>[bons.ts]"]
  node_manualissue["Manual issue slips<br/>[manualIssue.ts]"]
  node_slippdf["Slip PDF<br/>[slipPdf.ts]"]
  node_admin["Admin master data<br/>[AdminPanel.tsx]"]
end

subgraph group_support["Shared services"]
  node_actions["Action items<br/>[actionItems.ts]"]
  node_actionctx["Action context"]
  node_notifications["Notifications"]
  node_pickers["Search pickers<br/>[Pickers.tsx]"]
  node_ui["UI components<br/>[ui.tsx]"]
  node_username["Username mapping<br/>[authUsername.ts]"]
  node_backend["Supabase services<br/>[supabase.ts]"]
end

node_user(("User"))
node_db[("Supabase data store")]

node_user -->|"opens app"| node_app
node_app -->|"provides auth"| node_auth
node_auth -->|"loads session"| node_backend
node_app -->|"routes unauthenticated"| node_login
node_login -->|"authenticates"| node_backend
node_login -->|"maps username"| node_username
node_app -->|"renders shell"| node_layout
node_app -->|"routes dashboard"| node_dashboard
node_app -->|"routes work orders"| node_workorders
node_app -->|"opens selected WO"| node_detail
node_app -->|"routes inventory"| node_spareparts
node_app -->|"routes transactions"| node_transactions
node_app -->|"routes receipts"| node_receipts
node_app -->|"routes requirements"| node_requirements
node_app -->|"routes issue slips"| node_bons
node_app -->|"routes administration"| node_admin
node_app -->|"routes activity"| node_activity
node_layout -->|"reads profile"| node_auth
node_layout -->|"reads action state"| node_actionctx
node_actionctx -->|"loads action items"| node_actions
node_layout -->|"displays counts"| node_notifications
node_dashboard -->|"shows pending work"| node_actions
node_workorders -->|"queries work orders"| node_backend
node_detail -->|"reads and updates WO"| node_backend
node_detail -->|"renders requests"| node_partrequests
node_detail -->|"generates report"| node_workreport
node_detail -->|"uses selectors"| node_pickers
node_spareparts -->|"queries parts"| node_backend
node_transactions -->|"records stock moves"| node_backend
node_transactions -->|"checks remaining items"| node_bonlib
node_transactions -->|"prints saved issue"| node_manualissue
node_manualissue -->|"creates PDF"| node_slippdf
node_receipts -->|"manages receipts"| node_backend
node_requirements -->|"manages requirements"| node_backend
node_bons -->|"loads issue slips"| node_backend
node_bons -->|"calculates balances"| node_bonlib
node_admin -->|"manages master data"| node_backend
node_activity -->|"loads activity"| node_backend
node_backend -->|"reads and writes"| node_db
node_receipts -->|"uses selectors"| node_pickers
node_requirements -->|"uses selectors"| node_pickers
node_bons -->|"uses selectors"| node_pickers
node_transactions -->|"uses selectors"| node_pickers
node_detail -->|"uses controls"| node_ui
node_transactions -->|"uses controls"| node_ui

click node_app "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/App.tsx"
click node_auth "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/context/AuthContext.tsx"
click node_login "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/Login.tsx"
click node_layout "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/components/Layout.tsx"
click node_dashboard "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/Dashboard.tsx"
click node_activity "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/ActivityLogPage.tsx"
click node_workorders "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/WorkOrders.tsx"
click node_detail "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/WorkOrderDetail.tsx"
click node_partrequests "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/components/PartRequests.tsx"
click node_workreport "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/lib/woReportPdf.ts"
click node_spareparts "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/SpareParts.tsx"
click node_transactions "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/Transactions.tsx"
click node_receipts "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/GoodsReceipts.tsx"
click node_requirements "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/PurchaseRequirements.tsx"
click node_bons "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/Bons.tsx"
click node_bonlib "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/lib/bons.ts"
click node_manualissue "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/lib/manualIssue.ts"
click node_slippdf "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/lib/slipPdf.ts"
click node_admin "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/AdminPanel.tsx"
click node_actions "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/lib/actionItems.ts"
click node_actionctx "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/context/ActionItemsContext.tsx"
click node_notifications "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/components/NotificationBell.tsx"
click node_pickers "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/components/Pickers.tsx"
click node_ui "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/components/ui.tsx"
click node_username "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/lib/authUsername.ts"
click node_backend "https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/lib/supabase.ts"

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,node_login,node_layout,node_dashboard,node_activity,node_user toneBlue
class node_workorders,node_detail,node_partrequests,node_workreport,node_db toneAmber
class node_spareparts,node_transactions,node_receipts,node_requirements,node_bons,node_bonlib,node_manualissue,node_slippdf,node_admin toneMint
class node_actions,node_actionctx,node_notifications,node_pickers,node_ui,node_username,node_backend toneRose
```

## Components

### Application shell

- [App routing](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/App.tsx): `src/App.tsx`
- [Authentication](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/context/AuthContext.tsx): `src/context/AuthContext.tsx`
- [Login](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/Login.tsx): `src/pages/Login.tsx`
- [Navigation layout](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/components/Layout.tsx): `src/components/Layout.tsx`
- [Dashboard](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/Dashboard.tsx): `src/pages/Dashboard.tsx`
- [Activity log](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/ActivityLogPage.tsx): `src/pages/ActivityLogPage.tsx`

### Work orders

- [Work orders](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/WorkOrders.tsx): `src/pages/WorkOrders.tsx`
- [Work order detail](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/WorkOrderDetail.tsx): `src/pages/WorkOrderDetail.tsx`
- [Part requests](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/components/PartRequests.tsx): `src/components/PartRequests.tsx`
- [WO report PDF](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/lib/woReportPdf.ts): `src/lib/woReportPdf.ts`

### Inventory operations

- [Spare parts](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/SpareParts.tsx): `src/pages/SpareParts.tsx`
- [Stock transactions](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/Transactions.tsx): `src/pages/Transactions.tsx`
- [Goods receipts](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/GoodsReceipts.tsx): `src/pages/GoodsReceipts.tsx`
- [Purchase requirements](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/PurchaseRequirements.tsx): `src/pages/PurchaseRequirements.tsx`
- [Issue slips](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/Bons.tsx): `src/pages/Bons.tsx`
- [Slip calculations](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/lib/bons.ts): `src/lib/bons.ts`
- [Manual issue slips](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/lib/manualIssue.ts): `src/lib/manualIssue.ts`
- [Slip PDF](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/lib/slipPdf.ts): `src/lib/slipPdf.ts`
- [Admin master data](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/pages/AdminPanel.tsx): `src/pages/AdminPanel.tsx`

### Shared services

- [Action items](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/lib/actionItems.ts): `src/lib/actionItems.ts`
- [Action context](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/context/ActionItemsContext.tsx): `src/context/ActionItemsContext.tsx`
- [Notifications](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/components/NotificationBell.tsx): `src/components/NotificationBell.tsx`
- [Search pickers](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/components/Pickers.tsx): `src/components/Pickers.tsx`
- [UI components](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/components/ui.tsx): `src/components/ui.tsx`
- [Username mapping](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/lib/authUsername.ts): `src/lib/authUsername.ts`
- [Supabase services](https://github.com/cecep-darjo/work-order-sparepart/blob/main/src/lib/supabase.ts): `src/lib/supabase.ts`

### Other components

- **User**
- **Supabase data store**

## Connections

- User → App routing: opens app (evidence: `src/App.tsx`)
- App routing → Authentication: provides auth (evidence: `src/App.tsx`)
- Authentication → Supabase services: loads session (evidence: `src/context/AuthContext.tsx`)
- App routing → Login: routes unauthenticated (evidence: `src/App.tsx`)
- Login → Supabase services: authenticates (evidence: `src/pages/Login.tsx`)
- Login → Username mapping: maps username (evidence: `src/pages/Login.tsx`)
- App routing → Navigation layout: renders shell (evidence: `src/App.tsx`)
- App routing → Dashboard: routes dashboard (evidence: `src/App.tsx`)
- App routing → Work orders: routes work orders (evidence: `src/App.tsx`)
- App routing → Work order detail: opens selected WO (evidence: `src/App.tsx`)
- App routing → Spare parts: routes inventory (evidence: `src/App.tsx`)
- App routing → Stock transactions: routes transactions (evidence: `src/App.tsx`)
- App routing → Goods receipts: routes receipts (evidence: `src/App.tsx`)
- App routing → Purchase requirements: routes requirements (evidence: `src/App.tsx`)
- App routing → Issue slips: routes issue slips (evidence: `src/App.tsx`)
- App routing → Admin master data: routes administration (evidence: `src/App.tsx`)
- App routing → Activity log: routes activity (evidence: `src/App.tsx`)
- Navigation layout → Authentication: reads profile (evidence: `src/components/Layout.tsx`)
- Navigation layout → Action context: reads action state (evidence: `src/components/Layout.tsx`)
- Action context → Action items: loads action items (evidence: `src/context/ActionItemsContext.tsx`)
- Navigation layout → Notifications: displays counts (evidence: `src/components/Layout.tsx`)
- Dashboard → Action items: shows pending work (evidence: `src/pages/Dashboard.tsx`)
- Work orders → Supabase services: queries work orders (evidence: `src/pages/WorkOrders.tsx`)
- Work order detail → Supabase services: reads and updates WO (evidence: `src/pages/WorkOrderDetail.tsx`)
- Work order detail → Part requests: renders requests (evidence: `src/pages/WorkOrderDetail.tsx`)
- Work order detail → WO report PDF: generates report (evidence: `src/pages/WorkOrderDetail.tsx`)
- Work order detail → Search pickers: uses selectors (evidence: `src/pages/WorkOrderDetail.tsx`)
- Spare parts → Supabase services: queries parts (evidence: `src/pages/SpareParts.tsx`)
- Stock transactions → Supabase services: records stock moves (evidence: `src/pages/Transactions.tsx`)
- Stock transactions → Slip calculations: checks remaining items (evidence: `src/pages/Transactions.tsx`)
- Stock transactions → Manual issue slips: prints saved issue (evidence: `src/pages/Transactions.tsx`)
- Manual issue slips → Slip PDF: creates PDF (evidence: `src/lib/manualIssue.ts`)
- Goods receipts → Supabase services: manages receipts (evidence: `src/pages/GoodsReceipts.tsx`)
- Purchase requirements → Supabase services: manages requirements (evidence: `src/pages/PurchaseRequirements.tsx`)
- Issue slips → Supabase services: loads issue slips (evidence: `src/pages/Bons.tsx`)
- Issue slips → Slip calculations: calculates balances (evidence: `src/pages/Bons.tsx`)
- Admin master data → Supabase services: manages master data (evidence: `src/pages/AdminPanel.tsx`)
- Activity log → Supabase services: loads activity (evidence: `src/pages/ActivityLogPage.tsx`)
- Supabase services → Supabase data store: reads and writes (evidence: `src/lib/supabase.ts`)
- Goods receipts → Search pickers: uses selectors (evidence: `src/pages/GoodsReceipts.tsx`)
- Purchase requirements → Search pickers: uses selectors (evidence: `src/pages/PurchaseRequirements.tsx`)
- Issue slips → Search pickers: uses selectors (evidence: `src/pages/Bons.tsx`)
- Stock transactions → Search pickers: uses selectors (evidence: `src/pages/Transactions.tsx`)
- Work order detail → UI components: uses controls (evidence: `src/pages/WorkOrderDetail.tsx`)
- Stock transactions → UI components: uses controls (evidence: `src/pages/Transactions.tsx`)
