# deena-root-user/mouldshop architecture

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

- Interactive diagram: https://gitdiagram.com/deena-root-user/mouldshop
- Repository: https://github.com/deena-root-user/mouldshop

## Overview

MRF Tyre Mould Shop is a Flask inventory and tracking system for locating moulds, managing rack occupancy and shop-floor status, recording mould-shop lifecycle activity, and auditing/exporting operations. The main workflow is operator/admin requests into Flask routes, with inventory operations delegated to mould services and persisted as domain records; users can then inspect dashboards, search, reports, or exports. README documents heatmaps, RBAC, cleanliness checks, bulk import, and exports. Several route/service excerpts are partial, so unverified subsystem wiring is omitted rather than inferred.

Main entry points: [`app/__init__.py`](https://github.com/deena-root-user/mouldshop/blob/main/app/__init__.py) (Flask application), [`app/services/mould_service.py`](https://github.com/deena-root-user/mouldshop/blob/main/app/services/mould_service.py) (Inventory workflows), [`app/services/audit_service.py`](https://github.com/deena-root-user/mouldshop/blob/main/app/services/audit_service.py) (Audit writer), [`app/models/rack.py`](https://github.com/deena-root-user/mouldshop/blob/main/app/models/rack.py) (Racks and slots)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web workflows"]
  node_flask["Flask application<br/>[__init__.py]"]
  node_auth["Authentication<br/>[routes.py]"]
  node_dashboard["Dashboard and health<br/>[routes.py]"]
  node_search["Mould finder<br/>[routes.py]"]
  node_rackmap["Rack map<br/>[rack-map.js]"]
end

subgraph group_operations["Inventory operations"]
  node_mouldroutes["Mould management<br/>[routes.py]"]
  node_rackroutes["Rack management<br/>[routes.py]"]
  node_maintenance["Maintenance updates<br/>[routes.py]"]
  node_shop["Mould-shop lifecycle<br/>[routes.py]"]
  node_adminroutes["Administration<br/>[routes.py]"]
  node_mouldservice["Inventory workflows<br/>[mould_service.py]"]
  node_import["Bulk import<br/>[import_service.py]"]
end

subgraph group_domain["Domain records"]
  node_moulddata[("Mould inventory<br/>[mould.py]")]
  node_rackdata[("Racks and slots<br/>[rack.py]")]
  node_movementdata[("Movement history<br/>[movement.py]")]
  node_shopdata[("Shop records<br/>[mould_shop.py]")]
  node_auditdata[("Audit records<br/>[audit.py]")]
  node_userdata[("User accounts<br/>[user.py]")]
end

subgraph group_support["Access and reporting"]
  node_reports["Reports and exports<br/>[routes.py]"]
  node_export["Export formats<br/>[export_service.py]"]
  node_auditroute["Audit history<br/>[routes.py]"]
  node_auditservice["Audit writer<br/>[audit_service.py]"]
  node_rbac["Role enforcement<br/>[decorators.py]"]
end

node_operator(("Shop-floor user"))
node_admin(("Administrator"))

node_operator -->|"uses"| node_flask
node_admin -->|"uses"| node_flask
node_flask -->|"registers routes"| node_auth
node_flask -->|"registers routes"| node_dashboard
node_flask -->|"registers routes"| node_search
node_flask -->|"registers routes"| node_mouldroutes
node_flask -->|"registers routes"| node_rackroutes
node_flask -->|"registers routes"| node_maintenance
node_flask -->|"registers routes"| node_shop
node_flask -->|"registers routes"| node_adminroutes
node_flask -->|"registers routes"| node_reports
node_flask -->|"registers routes"| node_auditroute
node_mouldroutes -->|"invokes workflows"| node_mouldservice
node_maintenance -->|"invokes updates"| node_mouldservice
node_shop -->|"queries and edits"| node_shopdata
node_shop -->|"queries moulds"| node_moulddata
node_mouldroutes -->|"queries slots"| node_rackdata
node_mouldservice -->|"updates moulds"| node_moulddata
node_mouldservice -->|"updates slots"| node_rackdata
node_mouldservice -->|"records movements"| node_movementdata
node_mouldservice -->|"logs actions"| node_auditservice
node_auditservice -->|"writes entries"| node_auditdata
node_auth -->|"checks accounts"| node_userdata
node_adminroutes -->|"guards access"| node_rbac
node_adminroutes -->|"logs changes"| node_auditservice
node_search -->|"queries locations"| node_rackdata
node_dashboard -->|"reads inventory"| node_moulddata
node_dashboard -->|"reads occupancy"| node_rackdata
node_reports -->|"dispatches exports"| node_export
node_reports -->|"executes imports"| node_import
node_import -->|"uses workflows"| node_mouldservice
node_import -->|"logs imports"| node_auditservice
node_auditroute -->|"reads history"| node_movementdata
node_auditroute -->|"reads audit logs"| node_auditdata
node_operator -->|"views heatmap"| node_rackmap

click node_flask "https://github.com/deena-root-user/mouldshop/blob/main/app/__init__.py"
click node_auth "https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/auth/routes.py"
click node_dashboard "https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/dashboard/routes.py"
click node_search "https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/search/routes.py"
click node_rackmap "https://github.com/deena-root-user/mouldshop/blob/main/app/static/js/rack-map.js"
click node_mouldroutes "https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/mould/routes.py"
click node_rackroutes "https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/rack/routes.py"
click node_maintenance "https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/maintenance/routes.py"
click node_shop "https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/mould_shop/routes.py"
click node_adminroutes "https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/admin/routes.py"
click node_mouldservice "https://github.com/deena-root-user/mouldshop/blob/main/app/services/mould_service.py"
click node_import "https://github.com/deena-root-user/mouldshop/blob/main/app/services/import_service.py"
click node_reports "https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/reports/routes.py"
click node_export "https://github.com/deena-root-user/mouldshop/blob/main/app/services/export_service.py"
click node_auditroute "https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/audit/routes.py"
click node_auditservice "https://github.com/deena-root-user/mouldshop/blob/main/app/services/audit_service.py"
click node_rbac "https://github.com/deena-root-user/mouldshop/blob/main/app/utils/decorators.py"
click node_moulddata "https://github.com/deena-root-user/mouldshop/blob/main/app/models/mould.py"
click node_rackdata "https://github.com/deena-root-user/mouldshop/blob/main/app/models/rack.py"
click node_movementdata "https://github.com/deena-root-user/mouldshop/blob/main/app/models/movement.py"
click node_shopdata "https://github.com/deena-root-user/mouldshop/blob/main/app/models/mould_shop.py"
click node_auditdata "https://github.com/deena-root-user/mouldshop/blob/main/app/models/audit.py"
click node_userdata "https://github.com/deena-root-user/mouldshop/blob/main/app/models/user.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_flask,node_auth,node_dashboard,node_search,node_rackmap,node_operator toneBlue
class node_mouldroutes,node_rackroutes,node_maintenance,node_shop,node_adminroutes,node_mouldservice,node_import toneAmber
class node_moulddata,node_rackdata,node_movementdata,node_shopdata,node_auditdata,node_userdata toneMint
class node_reports,node_export,node_auditroute,node_auditservice,node_rbac toneRose
class node_admin toneIndigo
```

## Components

### Web workflows

- [Flask application](https://github.com/deena-root-user/mouldshop/blob/main/app/__init__.py): `app/__init__.py`
- [Authentication](https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/auth/routes.py): `app/blueprints/auth/routes.py`
- [Dashboard and health](https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/dashboard/routes.py): `app/blueprints/dashboard/routes.py`
- [Mould finder](https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/search/routes.py): `app/blueprints/search/routes.py`
- [Rack map](https://github.com/deena-root-user/mouldshop/blob/main/app/static/js/rack-map.js): `app/static/js/rack-map.js`

### Inventory operations

- [Mould management](https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/mould/routes.py): `app/blueprints/mould/routes.py`
- [Rack management](https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/rack/routes.py): `app/blueprints/rack/routes.py`
- [Maintenance updates](https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/maintenance/routes.py): `app/blueprints/maintenance/routes.py`
- [Mould-shop lifecycle](https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/mould_shop/routes.py): `app/blueprints/mould_shop/routes.py`
- [Administration](https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/admin/routes.py): `app/blueprints/admin/routes.py`
- [Inventory workflows](https://github.com/deena-root-user/mouldshop/blob/main/app/services/mould_service.py): `app/services/mould_service.py`
- [Bulk import](https://github.com/deena-root-user/mouldshop/blob/main/app/services/import_service.py): `app/services/import_service.py`

### Domain records

- [Mould inventory](https://github.com/deena-root-user/mouldshop/blob/main/app/models/mould.py): `app/models/mould.py`
- [Racks and slots](https://github.com/deena-root-user/mouldshop/blob/main/app/models/rack.py): `app/models/rack.py`
- [Movement history](https://github.com/deena-root-user/mouldshop/blob/main/app/models/movement.py): `app/models/movement.py`
- [Shop records](https://github.com/deena-root-user/mouldshop/blob/main/app/models/mould_shop.py): `app/models/mould_shop.py`
- [Audit records](https://github.com/deena-root-user/mouldshop/blob/main/app/models/audit.py): `app/models/audit.py`
- [User accounts](https://github.com/deena-root-user/mouldshop/blob/main/app/models/user.py): `app/models/user.py`

### Access and reporting

- [Reports and exports](https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/reports/routes.py): `app/blueprints/reports/routes.py`
- [Export formats](https://github.com/deena-root-user/mouldshop/blob/main/app/services/export_service.py): `app/services/export_service.py`
- [Audit history](https://github.com/deena-root-user/mouldshop/blob/main/app/blueprints/audit/routes.py): `app/blueprints/audit/routes.py`
- [Audit writer](https://github.com/deena-root-user/mouldshop/blob/main/app/services/audit_service.py): `app/services/audit_service.py`
- [Role enforcement](https://github.com/deena-root-user/mouldshop/blob/main/app/utils/decorators.py): `app/utils/decorators.py`

### Other components

- **Shop-floor user**
- **Administrator**

## Connections

- Shop-floor user → Flask application: uses (evidence: `README.md`)
- Administrator → Flask application: uses (evidence: `README.md`)
- Flask application → Authentication: registers routes (evidence: `app/__init__.py`)
- Flask application → Dashboard and health: registers routes (evidence: `app/__init__.py`)
- Flask application → Mould finder: registers routes (evidence: `app/__init__.py`)
- Flask application → Mould management: registers routes (evidence: `app/__init__.py`)
- Flask application → Rack management: registers routes (evidence: `app/__init__.py`)
- Flask application → Maintenance updates: registers routes (evidence: `app/__init__.py`)
- Flask application → Mould-shop lifecycle: registers routes (evidence: `app/__init__.py`)
- Flask application → Administration: registers routes (evidence: `app/__init__.py`)
- Flask application → Reports and exports: registers routes (evidence: `app/__init__.py`)
- Flask application → Audit history: registers routes (evidence: `app/__init__.py`)
- Mould management → Inventory workflows: invokes workflows (evidence: `app/blueprints/mould/routes.py`)
- Maintenance updates → Inventory workflows: invokes updates (evidence: `app/blueprints/maintenance/routes.py`)
- Mould-shop lifecycle → Shop records: queries and edits (evidence: `app/blueprints/mould_shop/routes.py`)
- Mould-shop lifecycle → Mould inventory: queries moulds (evidence: `app/blueprints/mould_shop/routes.py`)
- Mould management → Racks and slots: queries slots (evidence: `app/blueprints/mould/routes.py`)
- Inventory workflows → Mould inventory: updates moulds (evidence: `app/services/mould_service.py`)
- Inventory workflows → Racks and slots: updates slots (evidence: `app/services/mould_service.py`)
- Inventory workflows → Movement history: records movements (evidence: `app/services/mould_service.py`)
- Inventory workflows → Audit writer: logs actions (evidence: `app/services/mould_service.py`)
- Audit writer → Audit records: writes entries (evidence: `app/services/audit_service.py`)
- Authentication → User accounts: checks accounts (evidence: `app/blueprints/auth/routes.py`)
- Administration → Role enforcement: guards access (evidence: `app/blueprints/admin/routes.py`)
- Administration → Audit writer: logs changes (evidence: `app/blueprints/admin/routes.py`)
- Mould finder → Racks and slots: queries locations (evidence: `app/blueprints/search/routes.py`)
- Dashboard and health → Mould inventory: reads inventory (evidence: `app/blueprints/dashboard/routes.py`)
- Dashboard and health → Racks and slots: reads occupancy (evidence: `app/blueprints/dashboard/routes.py`)
- Reports and exports → Export formats: dispatches exports (evidence: `app/blueprints/reports/routes.py`)
- Reports and exports → Bulk import: executes imports (evidence: `app/blueprints/reports/routes.py`)
- Bulk import → Inventory workflows: uses workflows (evidence: `app/services/import_service.py`)
- Bulk import → Audit writer: logs imports (evidence: `app/services/import_service.py`)
- Audit history → Movement history: reads history (evidence: `app/blueprints/audit/routes.py`)
- Audit history → Audit records: reads audit logs (evidence: `app/blueprints/audit/routes.py`)
- Shop-floor user → Rack map: views heatmap (evidence: `README.md`)
