# ahmedal-nono/production-and-manufacturing-management-system architecture

> Architecture diagram of the GitHub repository ahmedal-nono/production-and-manufacturing-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ahmedal-nono/production-and-manufacturing-management-system
- Repository: https://github.com/ahmedal-nono/production-and-manufacturing-management-system

## Overview

FPMS is a Django and Vue manufacturing-management system. Users sign in, then manage products, bills of materials, workflows, production orders, work-centre execution and quality; reports provide production and workflow analysis. The browser client presents role-oriented pages and communicates with Django APIs. Administration adds users, permissions, audit history, backups and queued jobs; browser RUM is another documented capability. The graph combines sampled implementation and documented features; several API routes and frontend domain pages were not sampled, so uncertain links are omitted or marked unverified.

Main entry points: [`administration/models.py`](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/administration/models.py) (Accounts and audit), [`workflow/models.py`](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/workflow/models.py) (Production orders), [`work_instructions/models.py`](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/work_instructions/models.py) (Work orders and instructions), [`reports/views.py`](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/reports/views.py) (Reports and exports)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Vue client"]
  node_vue["Vue application<br/>[main.ts]"]
  node_navigation["Navigation and pages<br/>[App.vue]"]
  node_clientstores["Client domain stores"]
  node_http["HTTP client<br/>[axios.ts]"]
  node_rum["RUM collection<br/>[rum.ts]"]
end

subgraph group_planning["Production planning"]
  node_workflow[("Workflows and stages<br/>[models.py]")]
  node_products[("Products and BOMs<br/>[models.py]")]
  node_orders[("Production orders<br/>[models.py]")]
end

subgraph group_execution["Shop-floor execution"]
  node_workcentres[("Work centres<br/>[models.py]")]
  node_instructions[("Work orders and instructions<br/>[models.py]")]
end

subgraph group_insight["Quality and reporting"]
  node_quality[("Quality inspections<br/>[models.py]")]
  node_reports["Reports and exports<br/>[views.py]"]
  node_reportcache["Report cache<br/>[cache.py]"]
end

subgraph group_platform["Administration and operations"]
  node_accounts[("Accounts and audit<br/>[models.py]")]
  node_permissions["Role permissions<br/>[permissions.py]"]
  node_jobs["Background jobs<br/>[jobs.py]"]
  node_jobstore[("Job records<br/>[models.py]")]
  node_rumstore[("RUM samples<br/>[models.py]")]
end

node_user(("User"))
node_database[("Application database")]

node_user -->|"uses"| node_vue
node_vue -->|"mounts"| node_navigation
node_navigation -.->|"uses"| node_clientstores
node_clientstores -.->|"requests data"| node_http
node_http -.->|"authenticates"| node_accounts
node_vue -->|"loads"| node_rum
node_rum -->|"submits metrics"| node_rumstore
node_user -->|"signs in"| node_accounts
node_accounts -.->|"grants roles"| node_permissions
node_accounts -.->|"stores jobs"| node_jobstore
node_jobs -->|"processes"| node_jobstore
node_workflow -->|"assigns stages"| node_workcentres
node_products -->|"associates workflow"| node_workflow
node_orders -->|"orders product"| node_products
node_orders -->|"traces work orders"| node_instructions
node_instructions -->|"assigns job cards"| node_workcentres
node_quality -->|"references instructions"| node_instructions
node_reports -->|"caches aggregates"| node_reportcache
node_reports -->|"summarizes orders"| node_orders
node_reports -->|"analyzes stages"| node_workflow
node_accounts -.->|"persists records"| node_database
node_workcentres -.->|"persists records"| node_database
node_workflow -.->|"persists records"| node_database
node_products -.->|"persists records"| node_database
node_orders -.->|"persists records"| node_database
node_instructions -.->|"persists records"| node_database
node_quality -.->|"persists records"| node_database
node_rumstore -.->|"persists samples"| node_database

click node_vue "https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/FPMS/client/src/main.ts"
click node_navigation "https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/FPMS/client/src/App.vue"
click node_clientstores "https://github.com/ahmedal-nono/production-and-manufacturing-management-system/tree/main/FPMS/client/src/stores"
click node_http "https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/FPMS/client/src/api/axios.ts"
click node_rum "https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/FPMS/client/src/rum.ts"
click node_accounts "https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/administration/models.py"
click node_permissions "https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/administration/permissions.py"
click node_jobs "https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/administration/jobs.py"
click node_jobstore "https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/administration/models.py"
click node_workcentres "https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/workcentre/models.py"
click node_workflow "https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/workflow/models.py"
click node_products "https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/workflow/models.py"
click node_orders "https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/workflow/models.py"
click node_instructions "https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/work_instructions/models.py"
click node_quality "https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/quality_control/models.py"
click node_reports "https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/reports/views.py"
click node_reportcache "https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/reports/cache.py"
click node_rumstore "https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/administration/models.py"

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_vue,node_navigation,node_clientstores,node_http,node_rum,node_user toneBlue
class node_workflow,node_products,node_orders,node_database toneAmber
class node_workcentres,node_instructions toneMint
class node_quality,node_reports,node_reportcache toneRose
class node_accounts,node_permissions,node_jobs,node_jobstore,node_rumstore toneIndigo
```

## Components

### Vue client

- [Vue application](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/FPMS/client/src/main.ts): `FPMS/client/src/main.ts`
- [Navigation and pages](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/FPMS/client/src/App.vue): `FPMS/client/src/App.vue`
- [Client domain stores](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/tree/main/FPMS/client/src/stores): `FPMS/client/src/stores`
- [HTTP client](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/FPMS/client/src/api/axios.ts): `FPMS/client/src/api/axios.ts`
- [RUM collection](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/FPMS/client/src/rum.ts): `FPMS/client/src/rum.ts`

### Production planning

- [Workflows and stages](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/workflow/models.py): `workflow/models.py`
- [Products and BOMs](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/workflow/models.py): `workflow/models.py`
- [Production orders](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/workflow/models.py): `workflow/models.py`

### Shop-floor execution

- [Work centres](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/workcentre/models.py): `workcentre/models.py`
- [Work orders and instructions](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/work_instructions/models.py): `work_instructions/models.py`

### Quality and reporting

- [Quality inspections](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/quality_control/models.py): `quality_control/models.py`
- [Reports and exports](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/reports/views.py): `reports/views.py`
- [Report cache](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/reports/cache.py): `reports/cache.py`

### Administration and operations

- [Accounts and audit](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/administration/models.py): `administration/models.py`
- [Role permissions](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/administration/permissions.py): `administration/permissions.py`
- [Background jobs](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/administration/jobs.py): `administration/jobs.py`
- [Job records](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/administration/models.py): `administration/models.py`
- [RUM samples](https://github.com/ahmedal-nono/production-and-manufacturing-management-system/blob/main/administration/models.py): `administration/models.py`

### Other components

- **User**
- **Application database**

## Connections

- User → Vue application: uses
- Vue application → Navigation and pages: mounts (evidence: `FPMS/client/src/main.ts`)
- Navigation and pages → Client domain stores: uses (evidence: `FPMS/client/src/App.vue`)
- Client domain stores → HTTP client: requests data
- HTTP client → Accounts and audit: authenticates
- Vue application → RUM collection: loads (evidence: `FPMS/client/src/main.ts`)
- RUM collection → RUM samples: submits metrics
- User → Accounts and audit: signs in
- Accounts and audit → Role permissions: grants roles
- Accounts and audit → Job records: stores jobs (evidence: `administration/models.py`)
- Background jobs → Job records: processes (evidence: `administration/jobs.py`)
- Workflows and stages → Work centres: assigns stages (evidence: `workflow/models.py`)
- Products and BOMs → Workflows and stages: associates workflow (evidence: `workflow/models.py`)
- Production orders → Products and BOMs: orders product (evidence: `workflow/models.py`)
- Production orders → Work orders and instructions: traces work orders (evidence: `work_instructions/models.py`)
- Work orders and instructions → Work centres: assigns job cards (evidence: `work_instructions/models.py`)
- Quality inspections → Work orders and instructions: references instructions (evidence: `quality_control/models.py`)
- Reports and exports → Report cache: caches aggregates (evidence: `reports/views.py`)
- Reports and exports → Production orders: summarizes orders (evidence: `reports/views.py`)
- Reports and exports → Workflows and stages: analyzes stages (evidence: `reports/views.py`)
- Accounts and audit → Application database: persists records
- Work centres → Application database: persists records
- Workflows and stages → Application database: persists records
- Products and BOMs → Application database: persists records
- Production orders → Application database: persists records
- Work orders and instructions → Application database: persists records
- Quality inspections → Application database: persists records
- RUM samples → Application database: persists samples
