# mav1730/legal-metrology-project architecture

> Architecture diagram of the GitHub repository mav1730/legal-metrology-project, 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/mav1730/legal-metrology-project
- Repository: https://github.com/mav1730/legal-metrology-project

## Overview

This is a decision-support web app for screening e-commerce listings and packaging for potentially missing Legal Metrology declarations. Users submit a URL, text, image, or sample; the backend collects or OCRs text, extracts fields with regex and optional NER, evaluates configurable rules, persists evidence and findings, and supports review and JSON/PDF reports. The frontend also exposes rule and scan-history views, while DemoMart supplies reproducible example listings. Some subsystem links rely on README or SOURCE INDEX references because not all implementation files were excerpted.

Main entry points: [`backend/app/services/pipeline.py`](https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/services/pipeline.py) (Scan pipeline), [`backend/app/routes/api.py`](https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/routes/api.py) (REST endpoints), [`frontend/src/App.jsx`](https://github.com/mav1730/legal-metrology-project/blob/main/frontend/src/App.jsx) (Dashboard app), [`frontend/src/api/client.js`](https://github.com/mav1730/legal-metrology-project/blob/main/frontend/src/api/client.js) (API client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web experience"]
  node_frontend["Dashboard app<br/>[App.jsx]"]
  node_scan_page["Scan workspace"]
  node_scan_panel["Scan inputs<br/>[ScanPanel.jsx]"]
  node_history_page["Scan history"]
  node_rules_page["Rules view<br/>[RulesPage.jsx]"]
  node_api_client["API client<br/>[client.js]"]
end

subgraph group_api["API and orchestration"]
  node_api_routes["REST endpoints<br/>[api.py]"]
  node_app_entry["Flask application<br/>[main.py]"]
  node_pipeline["Scan pipeline<br/>[pipeline.py]"]
  node_samples["Demo samples<br/>[samples.py]"]
end

subgraph group_analysis["Scan analysis"]
  node_scraper["Page collection<br/>[scraper.py]"]
  node_ocr["Image OCR<br/>[ocr_service.py]"]
  node_regex_extract["Regex extraction<br/>[extractors.py]"]
  node_ner_extract["NER extraction<br/>[ner_extractor.py]"]
  node_field_merge["Field merging<br/>[merge.py]"]
  node_field_models["Field evidence model<br/>[models.py]"]
  node_rule_engine["Rule evaluation<br/>[rules.py]"]
  node_rules_data["Rule definitions<br/>[rulesData.js]"]
end

subgraph group_records["Records and review"]
  node_sqlite[("Scan database<br/>[storage.py]")]
  node_reports["Report generation<br/>[reports.py]"]
end

subgraph group_demo["DemoMart"]
  node_demo_catalog["Demo catalog<br/>[catalog.py]"]
  node_blind_catalog["Paraphrased listings<br/>[regex_blind.py]"]
  node_demo_render["Storefront rendering<br/>[render.py]"]
end

node_reviewer(("Reviewer"))
node_marketplace(("Product website"))

node_reviewer -->|"uses"| node_frontend
node_frontend -->|"shows"| node_scan_page
node_frontend -->|"shows"| node_history_page
node_frontend -->|"shows"| node_rules_page
node_scan_page -->|"renders"| node_scan_panel
node_frontend -->|"calls"| node_api_client
node_api_client -.->|"requests"| node_api_routes
node_api_routes -->|"dispatches scans"| node_pipeline
node_app_entry -->|"registers"| node_api_routes
node_app_entry -->|"serves pages"| node_demo_render
node_demo_render -->|"renders products"| node_demo_catalog
node_demo_catalog -->|"includes listings"| node_blind_catalog
node_pipeline -->|"collects page"| node_scraper
node_pipeline -->|"extracts image text"| node_ocr
node_pipeline -->|"extracts fields"| node_regex_extract
node_pipeline -.->|"uses optional NER"| node_ner_extract
node_pipeline -.->|"merges results"| node_field_merge
node_regex_extract -->|"returns fields"| node_field_models
node_pipeline -->|"evaluates fields"| node_rule_engine
node_pipeline -->|"saves scan"| node_sqlite
node_api_routes -->|"lists samples"| node_samples
node_samples -->|"builds samples"| node_demo_catalog
node_api_routes -->|"reads and reviews"| node_sqlite
node_api_routes -->|"generates reports"| node_reports
node_history_page -.->|"loads history"| node_api_client
node_rules_page -->|"displays rules"| node_rules_data
node_marketplace -.->|"provides listing"| node_scraper

click node_frontend "https://github.com/mav1730/legal-metrology-project/blob/main/frontend/src/App.jsx"
click node_scan_page "https://github.com/mav1730/legal-metrology-project/blob/main/frontend/src/pages/ComplianceScanPage.jsx"
click node_scan_panel "https://github.com/mav1730/legal-metrology-project/blob/main/frontend/src/components/ScanPanel.jsx"
click node_history_page "https://github.com/mav1730/legal-metrology-project/blob/main/frontend/src/pages/CatalogHistoryPage.jsx"
click node_rules_page "https://github.com/mav1730/legal-metrology-project/blob/main/frontend/src/pages/RulesPage.jsx"
click node_api_client "https://github.com/mav1730/legal-metrology-project/blob/main/frontend/src/api/client.js"
click node_api_routes "https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/routes/api.py"
click node_app_entry "https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/main.py"
click node_pipeline "https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/services/pipeline.py"
click node_scraper "https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/services/scraper.py"
click node_ocr "https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/services/ocr_service.py"
click node_regex_extract "https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/field_extractor/extractors.py"
click node_ner_extract "https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/field_extractor/ner_extractor.py"
click node_field_merge "https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/field_extractor/merge.py"
click node_field_models "https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/field_extractor/models.py"
click node_rule_engine "https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/services/rules.py"
click node_samples "https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/services/samples.py"
click node_sqlite "https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/services/storage.py"
click node_reports "https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/services/reports.py"
click node_demo_catalog "https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/demo_store/catalog.py"
click node_blind_catalog "https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/demo_store/regex_blind.py"
click node_demo_render "https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/demo_store/render.py"
click node_rules_data "https://github.com/mav1730/legal-metrology-project/blob/main/frontend/src/data/rulesData.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_frontend,node_scan_page,node_scan_panel,node_history_page,node_rules_page,node_api_client,node_reviewer toneBlue
class node_api_routes,node_app_entry,node_pipeline,node_samples toneAmber
class node_scraper,node_ocr,node_regex_extract,node_ner_extract,node_field_merge,node_field_models,node_rule_engine,node_rules_data toneMint
class node_sqlite,node_reports toneRose
class node_demo_catalog,node_blind_catalog,node_demo_render,node_marketplace toneIndigo
```

## Components

### Web experience

- [Dashboard app](https://github.com/mav1730/legal-metrology-project/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Scan workspace](https://github.com/mav1730/legal-metrology-project/blob/main/frontend/src/pages/ComplianceScanPage.jsx): `frontend/src/pages/ComplianceScanPage.jsx`
- [Scan inputs](https://github.com/mav1730/legal-metrology-project/blob/main/frontend/src/components/ScanPanel.jsx): `frontend/src/components/ScanPanel.jsx`
- [Scan history](https://github.com/mav1730/legal-metrology-project/blob/main/frontend/src/pages/CatalogHistoryPage.jsx): `frontend/src/pages/CatalogHistoryPage.jsx`
- [Rules view](https://github.com/mav1730/legal-metrology-project/blob/main/frontend/src/pages/RulesPage.jsx): `frontend/src/pages/RulesPage.jsx`
- [API client](https://github.com/mav1730/legal-metrology-project/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`

### API and orchestration

- [REST endpoints](https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/routes/api.py): `backend/app/routes/api.py`
- [Flask application](https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/main.py): `backend/app/main.py`
- [Scan pipeline](https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/services/pipeline.py): `backend/app/services/pipeline.py`
- [Demo samples](https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/services/samples.py): `backend/app/services/samples.py`

### Scan analysis

- [Page collection](https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/services/scraper.py): `backend/app/services/scraper.py`
- [Image OCR](https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/services/ocr_service.py): `backend/app/services/ocr_service.py`
- [Regex extraction](https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/field_extractor/extractors.py): `backend/app/field_extractor/extractors.py`
- [NER extraction](https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/field_extractor/ner_extractor.py): `backend/app/field_extractor/ner_extractor.py`
- [Field merging](https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/field_extractor/merge.py): `backend/app/field_extractor/merge.py`
- [Field evidence model](https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/field_extractor/models.py): `backend/app/field_extractor/models.py`
- [Rule evaluation](https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/services/rules.py): `backend/app/services/rules.py`
- [Rule definitions](https://github.com/mav1730/legal-metrology-project/blob/main/frontend/src/data/rulesData.js): `frontend/src/data/rulesData.js`

### Records and review

- [Scan database](https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/services/storage.py): `backend/app/services/storage.py`
- [Report generation](https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/services/reports.py): `backend/app/services/reports.py`

### DemoMart

- [Demo catalog](https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/demo_store/catalog.py): `backend/app/demo_store/catalog.py`
- [Paraphrased listings](https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/demo_store/regex_blind.py): `backend/app/demo_store/regex_blind.py`
- [Storefront rendering](https://github.com/mav1730/legal-metrology-project/blob/main/backend/app/demo_store/render.py): `backend/app/demo_store/render.py`

### Other components

- **Reviewer**
- **Product website**

## Connections

- Reviewer → Dashboard app: uses (evidence: `README.md`)
- Dashboard app → Scan workspace: shows (evidence: `frontend/src/App.jsx`)
- Dashboard app → Scan history: shows (evidence: `frontend/src/App.jsx`)
- Dashboard app → Rules view: shows (evidence: `frontend/src/App.jsx`)
- Scan workspace → Scan inputs: renders (evidence: `frontend/src/pages/ComplianceScanPage.jsx`)
- Dashboard app → API client: calls (evidence: `frontend/src/App.jsx`)
- API client → REST endpoints: requests (evidence: `README.md`)
- REST endpoints → Scan pipeline: dispatches scans (evidence: `backend/app/routes/api.py`)
- Flask application → REST endpoints: registers (evidence: `backend/app/main.py`)
- Flask application → Storefront rendering: serves pages (evidence: `backend/app/main.py`)
- Storefront rendering → Demo catalog: renders products (evidence: `backend/app/demo_store/render.py`)
- Demo catalog → Paraphrased listings: includes listings (evidence: `backend/app/demo_store/catalog.py`)
- Scan pipeline → Page collection: collects page (evidence: `backend/app/services/pipeline.py`)
- Scan pipeline → Image OCR: extracts image text (evidence: `backend/app/services/pipeline.py`)
- Scan pipeline → Regex extraction: extracts fields (evidence: `backend/app/services/pipeline.py`)
- Scan pipeline → NER extraction: uses optional NER (evidence: `backend/app/services/pipeline.py`)
- Scan pipeline → Field merging: merges results
- Regex extraction → Field evidence model: returns fields (evidence: `backend/app/field_extractor/extractors.py`)
- Scan pipeline → Rule evaluation: evaluates fields (evidence: `backend/app/services/pipeline.py`)
- Scan pipeline → Scan database: saves scan (evidence: `backend/app/services/pipeline.py`)
- REST endpoints → Demo samples: lists samples (evidence: `backend/app/routes/api.py`)
- Demo samples → Demo catalog: builds samples (evidence: `backend/app/services/samples.py`)
- REST endpoints → Scan database: reads and reviews (evidence: `backend/app/routes/api.py`)
- REST endpoints → Report generation: generates reports (evidence: `backend/app/routes/api.py`)
- Scan history → API client: loads history
- Rules view → Rule definitions: displays rules (evidence: `frontend/src/pages/RulesPage.jsx`)
- Product website → Page collection: provides listing (evidence: `README.md`)
