# omsainikaul/metrcheck-ai architecture

> Architecture diagram of the GitHub repository omsainikaul/metrcheck-ai, 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/omsainikaul/metrcheck-ai
- Repository: https://github.com/omsainikaul/metrcheck-ai

## Overview

MetrCheck AI is a packaged-product compliance platform. Users submit packaging images or product information; the backend extracts declarations, evaluates regulatory rules, scores and reports findings, then supports officer review and enforcement. The graph combines the documented analysis pipeline and workspaces with source-index-confirmed module relationships. Several service and API implementations were not excerpted, so their uncertain connections are omitted or marked unverified.

Main entry points: [`backend/compliance/engine.py`](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/compliance/engine.py) (Rules Evaluation), [`backend/database/db.py`](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/database/db.py) (Application Records), [`backend/main.py`](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/main.py) (Application Server), [`backend/services/analysis_service.py`](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/services/analysis_service.py) (Analysis Workflow)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspaces["User Workspaces"]
  node_web["Web Workspaces<br/>[App.tsx]"]
  node_api_client["API Client<br/>[api.ts]"]
  node_review_ui["Officer Review"]
end

subgraph group_api["API &amp; Access"]
  node_server["Application Server<br/>[main.py]"]
  node_auth["Identity &amp; Roles<br/>[security.py]"]
  node_analysis_api["Analysis Routes<br/>[analyze.py]"]
  node_compliance_api["Compliance Routes"]
  node_review_api["Review Routes<br/>[review_routes.py]"]
end

subgraph group_analysis["Image Analysis"]
  node_ocr["OCR Engine<br/>[paddle_engine.py]"]
  node_extraction["Declaration Extraction<br/>[extractor.py]"]
  node_vision["Packaging Vision<br/>[pipeline.py]"]
  node_analysis_service["Analysis Workflow"]
end

subgraph group_compliance["Compliance &amp; Review"]
  node_rules_engine["Rules Evaluation<br/>[engine.py]"]
  node_rule_catalog["Regulatory Rules<br/>[legal_metrology.py]"]
  node_scoring["Risk Scoring<br/>[scorer.py]"]
  node_verification["External Verification<br/>[cross_checker.py]"]
  node_review_service["Review Workflow<br/>[review_service.py]"]
  node_enforcement["Enforcement Workflow<br/>[enforcement.py]"]
end

subgraph group_operations["Records &amp; Outputs"]
  node_database[("Application Records<br/>[db.py]")]
  node_report["Compliance Reports<br/>[report.py]"]
  node_report_service["Report Generation<br/>[report_service.py]"]
  node_versioning["Version Comparison"]
  node_preprint["Pre-print Checks"]
end

node_users(("Consumers &amp; Staff"))

node_users -->|"use workspaces"| node_web
node_web -->|"request operations"| node_api_client
node_review_ui -->|"load review data"| node_api_client
node_api_client -.->|"call API"| node_server
node_server -->|"register routes"| node_analysis_api
node_server -->|"register routes"| node_compliance_api
node_server -->|"register routes"| node_review_api
node_analysis_api -.->|"delegate analysis"| node_analysis_service
node_analysis_service -.->|"recognize text"| node_ocr
node_analysis_service -.->|"extract declarations"| node_extraction
node_analysis_service -.->|"analyze packaging"| node_vision
node_extraction -->|"repair OCR output"| node_ocr
node_compliance_api -->|"evaluate compliance"| node_rules_engine
node_compliance_api -->|"read and write"| node_database
node_rules_engine -->|"load rule evaluators"| node_rule_catalog
node_rules_engine -->|"calculate score"| node_scoring
node_rules_engine -.->|"cross-check data"| node_verification
node_review_api -->|"delegate review"| node_review_service
node_review_api -->|"read and write"| node_database
node_review_service -->|"re-evaluate corrections"| node_rules_engine
node_review_ui -.->|"submit corrections"| node_review_api
node_review_service -.->|"escalate cases"| node_enforcement
node_report -->|"generate reports"| node_report_service
node_report -->|"read report records"| node_database
node_report_service -.->|"load stored findings"| node_database
node_preprint -->|"process artwork text"| node_ocr
node_preprint -->|"extract declarations"| node_extraction
node_preprint -->|"check declarations"| node_rules_engine
node_versioning -.->|"store comparisons"| node_database

click node_web "https://github.com/omsainikaul/metrcheck-ai/blob/main/frontend/src/App.tsx"
click node_api_client "https://github.com/omsainikaul/metrcheck-ai/blob/main/frontend/src/services/api.ts"
click node_review_ui "https://github.com/omsainikaul/metrcheck-ai/blob/main/frontend/src/pages/ReviewWorkspace.tsx"
click node_server "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/main.py"
click node_auth "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/auth/security.py"
click node_analysis_api "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/api/analyze.py"
click node_ocr "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/ocr/paddle_engine.py"
click node_extraction "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/extraction/extractor.py"
click node_vision "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/vision/pipeline.py"
click node_analysis_service "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/services/analysis_service.py"
click node_compliance_api "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/api/compliance_routes.py"
click node_rules_engine "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/compliance/engine.py"
click node_rule_catalog "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/compliance/rules/legal_metrology.py"
click node_scoring "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/compliance/scorer.py"
click node_verification "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/integrations/cross_checker.py"
click node_review_api "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/api/review_routes.py"
click node_review_service "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/services/review_service.py"
click node_enforcement "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/api/enforcement.py"
click node_database "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/database/db.py"
click node_report "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/api/report.py"
click node_report_service "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/services/report_service.py"
click node_versioning "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/services/version_comparison_service.py"
click node_preprint "https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/services/preprint_service.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_web,node_api_client,node_review_ui toneBlue
class node_server,node_auth,node_analysis_api,node_compliance_api,node_review_api toneAmber
class node_ocr,node_extraction,node_vision,node_analysis_service toneMint
class node_rules_engine,node_rule_catalog,node_scoring,node_verification,node_review_service,node_enforcement toneRose
class node_database,node_report,node_report_service,node_versioning,node_preprint,node_users toneIndigo
```

## Components

### User Workspaces

- [Web Workspaces](https://github.com/omsainikaul/metrcheck-ai/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [API Client](https://github.com/omsainikaul/metrcheck-ai/blob/main/frontend/src/services/api.ts): `frontend/src/services/api.ts`
- [Officer Review](https://github.com/omsainikaul/metrcheck-ai/blob/main/frontend/src/pages/ReviewWorkspace.tsx): `frontend/src/pages/ReviewWorkspace.tsx`

### API & Access

- [Application Server](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/main.py): `backend/main.py`
- [Identity & Roles](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/auth/security.py): `backend/auth/security.py`
- [Analysis Routes](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/api/analyze.py): `backend/api/analyze.py`
- [Compliance Routes](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/api/compliance_routes.py): `backend/api/compliance_routes.py`
- [Review Routes](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/api/review_routes.py): `backend/api/review_routes.py`

### Image Analysis

- [OCR Engine](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/ocr/paddle_engine.py): `backend/ocr/paddle_engine.py`
- [Declaration Extraction](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/extraction/extractor.py): `backend/extraction/extractor.py`
- [Packaging Vision](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/vision/pipeline.py): `backend/vision/pipeline.py`
- [Analysis Workflow](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/services/analysis_service.py): `backend/services/analysis_service.py`

### Compliance & Review

- [Rules Evaluation](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/compliance/engine.py): `backend/compliance/engine.py`
- [Regulatory Rules](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/compliance/rules/legal_metrology.py): `backend/compliance/rules/legal_metrology.py`
- [Risk Scoring](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/compliance/scorer.py): `backend/compliance/scorer.py`
- [External Verification](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/integrations/cross_checker.py): `backend/integrations/cross_checker.py`
- [Review Workflow](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/services/review_service.py): `backend/services/review_service.py`
- [Enforcement Workflow](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/api/enforcement.py): `backend/api/enforcement.py`

### Records & Outputs

- [Application Records](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/database/db.py): `backend/database/db.py`
- [Compliance Reports](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/api/report.py): `backend/api/report.py`
- [Report Generation](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/services/report_service.py): `backend/services/report_service.py`
- [Version Comparison](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/services/version_comparison_service.py): `backend/services/version_comparison_service.py`
- [Pre-print Checks](https://github.com/omsainikaul/metrcheck-ai/blob/main/backend/services/preprint_service.py): `backend/services/preprint_service.py`

### Other components

- **Consumers & Staff**

## Connections

- Consumers & Staff → Web Workspaces: use workspaces (evidence: `README.md`)
- Web Workspaces → API Client: request operations (evidence: `frontend/src/App.tsx`)
- Officer Review → API Client: load review data (evidence: `frontend/src/pages/ReviewWorkspace.tsx`)
- API Client → Application Server: call API (evidence: `README.md`)
- Application Server → Analysis Routes: register routes (evidence: `backend/main.py`)
- Application Server → Compliance Routes: register routes (evidence: `backend/main.py`)
- Application Server → Review Routes: register routes (evidence: `backend/main.py`)
- Analysis Routes → Analysis Workflow: delegate analysis
- Analysis Workflow → OCR Engine: recognize text (evidence: `README.md`)
- Analysis Workflow → Declaration Extraction: extract declarations (evidence: `README.md`)
- Analysis Workflow → Packaging Vision: analyze packaging (evidence: `README.md`)
- Declaration Extraction → OCR Engine: repair OCR output (evidence: `backend/extraction/extractor.py`)
- Compliance Routes → Rules Evaluation: evaluate compliance (evidence: `backend/api/compliance_routes.py`)
- Compliance Routes → Application Records: read and write (evidence: `backend/api/compliance_routes.py`)
- Rules Evaluation → Regulatory Rules: load rule evaluators (evidence: `backend/compliance/engine.py`)
- Rules Evaluation → Risk Scoring: calculate score (evidence: `backend/compliance/engine.py`)
- Rules Evaluation → External Verification: cross-check data
- Review Routes → Review Workflow: delegate review (evidence: `backend/api/review_routes.py`)
- Review Routes → Application Records: read and write (evidence: `backend/api/review_routes.py`)
- Review Workflow → Rules Evaluation: re-evaluate corrections (evidence: `backend/services/review_service.py`)
- Officer Review → Review Routes: submit corrections (evidence: `README.md`)
- Review Workflow → Enforcement Workflow: escalate cases (evidence: `README.md`)
- Compliance Reports → Report Generation: generate reports (evidence: `backend/api/report.py`)
- Compliance Reports → Application Records: read report records (evidence: `backend/api/report.py`)
- Report Generation → Application Records: load stored findings
- Pre-print Checks → OCR Engine: process artwork text (evidence: `backend/services/preprint_service.py`)
- Pre-print Checks → Declaration Extraction: extract declarations (evidence: `backend/services/preprint_service.py`)
- Pre-print Checks → Rules Evaluation: check declarations (evidence: `backend/services/preprint_service.py`)
- Version Comparison → Application Records: store comparisons
