# ashfaq-ahamed-a/complicart architecture

> Architecture diagram of the GitHub repository ashfaq-ahamed-a/complicart, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/ashfaq-ahamed-a/complicart
- Repository: https://github.com/ashfaq-ahamed-a/complicart

## Overview

ComplyCart is a mobile-led Legal Metrology compliance auditing platform. The documented workflow is a seller or auditor submitting a listing URL, the backend scraping the listing, extracting declaration fields, evaluating rules, and returning a compliance result; it also exposes catalog management. The README documents a seller dashboard and physical label scanning, but the Flutter source is not present in the supplied tree, so those capabilities are represented only at the app level. Backend relationships follow the excerpts and source index; the database and REST boundary are documented in the README.

Main entry points: [`ComplyCart-backend/app/services/analysis_service.py`](https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/services/analysis_service.py) (Analysis orchestration), [`ComplyCart-backend/app/main.py`](https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/main.py) (FastAPI application), [`ComplyCart-backend/app/api/catalog.py`](https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/api/catalog.py) (Catalog routes), [`ComplyCart-backend/app/api/analyze.py`](https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/api/analyze.py) (URL analysis routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_mobile["Mobile App"]
  node_mobile_app["Seller dashboard and scanners"]
end

subgraph group_api["Backend API"]
  node_api_entry["FastAPI application<br/>[main.py]"]
  node_analysis_routes["URL analysis routes<br/>[analyze.py]"]
  node_catalog_routes["Catalog routes<br/>[catalog.py]"]
  node_health_routes["Health route<br/>[health.py]"]
end

subgraph group_analysis["Compliance Analysis"]
  node_analysis_orchestrator["Analysis orchestration"]
  node_scraper["Listing scraper<br/>[scraper_service.py]"]
  node_extractor["Field extraction"]
  node_rule_engine["Compliance rules<br/>[rule_engine.py]"]
end

subgraph group_data["Catalog and Data"]
  node_models["Seller and analysis models<br/>[models.py]"]
  node_db_session["Database session<br/>[session.py]"]
  node_catalog_schema["Catalog schemas<br/>[catalog.py]"]
  node_database[("PostgreSQL")]
end

node_seller_auditor(("Seller or auditor"))
node_listing_sites["E-commerce listing sites"]
node_gemini["Gemini API"]

node_seller_auditor -->|"uses"| node_mobile_app
node_mobile_app -->|"REST requests"| node_api_entry
node_api_entry -->|"registers"| node_analysis_routes
node_api_entry -->|"registers"| node_catalog_routes
node_api_entry -->|"registers"| node_health_routes
node_analysis_routes -->|"calls"| node_analysis_orchestrator
node_analysis_orchestrator -->|"scrapes listing"| node_scraper
node_analysis_orchestrator -->|"extracts fields"| node_extractor
node_analysis_orchestrator -->|"validates fields"| node_rule_engine
node_scraper -->|"fetches pages"| node_listing_sites
node_extractor -.->|"extracts fields"| node_gemini
node_analysis_orchestrator -->|"queries and saves"| node_models
node_analysis_routes -->|"uses models"| node_models
node_catalog_routes -->|"queries catalog"| node_models
node_catalog_routes -->|"uses schemas"| node_catalog_schema
node_db_session -->|"connects to"| node_database
node_analysis_orchestrator -->|"reads and writes"| node_database
node_catalog_routes -->|"reads and writes"| node_database

click node_mobile_app "https://github.com/ashfaq-ahamed-a/complicart/tree/main/ComplyCart-app"
click node_api_entry "https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/main.py"
click node_analysis_routes "https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/api/analyze.py"
click node_catalog_routes "https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/api/catalog.py"
click node_health_routes "https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/api/health.py"
click node_analysis_orchestrator "https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/services/analysis_service.py"
click node_scraper "https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/services/scraper_service.py"
click node_extractor "https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/services/field_extraction_service.py"
click node_rule_engine "https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/services/rule_engine.py"
click node_models "https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/models/models.py"
click node_db_session "https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/db/session.py"
click node_catalog_schema "https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/schemas/catalog.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_mobile_app toneBlue
class node_api_entry,node_analysis_routes,node_catalog_routes,node_health_routes toneAmber
class node_analysis_orchestrator,node_scraper,node_extractor,node_rule_engine,node_gemini toneMint
class node_models,node_db_session,node_catalog_schema,node_database toneRose
class node_seller_auditor,node_listing_sites toneIndigo
```

## Components

### Mobile App

- [Seller dashboard and scanners](https://github.com/ashfaq-ahamed-a/complicart/tree/main/ComplyCart-app): `ComplyCart-app`

### Backend API

- [FastAPI application](https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/main.py): `ComplyCart-backend/app/main.py`
- [URL analysis routes](https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/api/analyze.py): `ComplyCart-backend/app/api/analyze.py`
- [Catalog routes](https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/api/catalog.py): `ComplyCart-backend/app/api/catalog.py`
- [Health route](https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/api/health.py): `ComplyCart-backend/app/api/health.py`

### Compliance Analysis

- [Analysis orchestration](https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/services/analysis_service.py): `ComplyCart-backend/app/services/analysis_service.py`
- [Listing scraper](https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/services/scraper_service.py): `ComplyCart-backend/app/services/scraper_service.py`
- [Field extraction](https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/services/field_extraction_service.py): `ComplyCart-backend/app/services/field_extraction_service.py`
- [Compliance rules](https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/services/rule_engine.py): `ComplyCart-backend/app/services/rule_engine.py`

### Catalog and Data

- [Seller and analysis models](https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/models/models.py): `ComplyCart-backend/app/models/models.py`
- [Database session](https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/db/session.py): `ComplyCart-backend/app/db/session.py`
- [Catalog schemas](https://github.com/ashfaq-ahamed-a/complicart/blob/main/ComplyCart-backend/app/schemas/catalog.py): `ComplyCart-backend/app/schemas/catalog.py`
- **PostgreSQL**

### Other components

- **Seller or auditor**
- **E-commerce listing sites**
- **Gemini API**

## Connections

- Seller or auditor → Seller dashboard and scanners: uses
- Seller dashboard and scanners → FastAPI application: REST requests
- FastAPI application → URL analysis routes: registers (evidence: `ComplyCart-backend/app/main.py`)
- FastAPI application → Catalog routes: registers (evidence: `ComplyCart-backend/app/main.py`)
- FastAPI application → Health route: registers (evidence: `ComplyCart-backend/app/main.py`)
- URL analysis routes → Analysis orchestration: calls (evidence: `ComplyCart-backend/app/api/analyze.py`)
- Analysis orchestration → Listing scraper: scrapes listing (evidence: `ComplyCart-backend/app/services/analysis_service.py`)
- Analysis orchestration → Field extraction: extracts fields (evidence: `ComplyCart-backend/app/services/analysis_service.py`)
- Analysis orchestration → Compliance rules: validates fields (evidence: `ComplyCart-backend/app/services/analysis_service.py`)
- Listing scraper → E-commerce listing sites: fetches pages (evidence: `ComplyCart-backend/app/services/scraper_service.py`)
- Field extraction → Gemini API: extracts fields (evidence: `ComplyCart-backend/app/services/field_extraction_service.py`)
- Analysis orchestration → Seller and analysis models: queries and saves (evidence: `ComplyCart-backend/app/services/analysis_service.py`)
- URL analysis routes → Seller and analysis models: uses models (evidence: `ComplyCart-backend/app/api/analyze.py`)
- Catalog routes → Seller and analysis models: queries catalog (evidence: `ComplyCart-backend/app/api/catalog.py`)
- Catalog routes → Catalog schemas: uses schemas (evidence: `ComplyCart-backend/app/api/catalog.py`)
- Database session → PostgreSQL: connects to
- Analysis orchestration → PostgreSQL: reads and writes (evidence: `ComplyCart-backend/app/services/analysis_service.py`)
- Catalog routes → PostgreSQL: reads and writes (evidence: `ComplyCart-backend/app/api/catalog.py`)
