# shwet3728-ai/sih26100-gem-bid-compliance architecture

> Architecture diagram of the GitHub repository shwet3728-ai/sih26100-gem-bid-compliance, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/shwet3728-ai/sih26100-gem-bid-compliance
- Repository: https://github.com/shwet3728-ai/sih26100-gem-bid-compliance

## Overview

SIH26100 is an AI-assisted GeM bid-compliance platform. A bidder or officer works through tender setup, application and document submission; documents are processed and extracted, registry evidence is verified, deterministic compliance and risk recommendations are produced, then officers record decisions and review reports and audit history. The graph preserves the documented synthetic-data and cross-document consistency capabilities. Several API and engine internals were not excerpted, so those connections use README workflow evidence rather than implying inspection of their implementation.

Main entry points: [`backend/app/services/verification_service.py`](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/services/verification_service.py) (Verification orchestration), [`frontend/src/App.jsx`](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/frontend/src/App.jsx) (Web application), [`backend/app/api/applications.py`](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/api/applications.py) (Applications API), [`backend/app/api/document_upload.py`](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/api/document_upload.py) (Document upload API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_web["Web application<br/>[App.jsx]"]
  node_application_ui["Application form"]
  node_result_ui["Verification results"]
  node_dashboard_ui["Dashboard<br/>[Dashboard.jsx]"]
end

subgraph group_workflow["Tender workflow"]
  node_tender_api["Tender and requirements APIs<br/>[tenders.py]"]
  node_applications_api["Applications API<br/>[applications.py]"]
  node_upload_api["Document upload API<br/>[document_upload.py]"]
  node_document_api["Document processing API<br/>[documents.py]"]
end

subgraph group_intelligence["Document intelligence"]
  node_ai_service["AI service adapter<br/>[ai_service.py]"]
  node_ai_engine["AI document processor<br/>[main.py]"]
  node_ocr["OCR pipeline<br/>[pipeline.py]"]
  node_extraction["Classification, extraction, consistency"]
  node_field_extractor["Field extraction<br/>[field_extractor.py]"]
end

subgraph group_verification["Verification and compliance"]
  node_verification["Verification orchestration"]
  node_registry["Registry integrations"]
  node_compliance_api["Compliance API<br/>[compliance.py]"]
  node_rules["Deterministic compliance rules<br/>[rule_registry.py]"]
  node_consistency["Cross-document consistency"]
end

subgraph group_operations["Operations and data"]
  node_application_data[("Application records<br/>[application.py]")]
  node_storage[("Document storage<br/>[storage.py]")]
  node_reporting["Reports and explanations<br/>[report_service.py]"]
  node_audit["Audit trail<br/>[audit.py]"]
  node_synthetic["Synthetic test corpus<br/>[generators.py]"]
end

node_bidder(("Bidder / officer"))

node_bidder -->|"uses"| node_web
node_web -->|"routes to"| node_application_ui
node_web -->|"routes to"| node_result_ui
node_web -->|"routes to"| node_dashboard_ui
node_bidder -->|"creates tender"| node_tender_api
node_bidder -->|"submits application"| node_applications_api
node_bidder -->|"uploads documents"| node_upload_api
node_tender_api -->|"defines requirements"| node_applications_api
node_upload_api -->|"processes documents"| node_document_api
node_document_api -.->|"requests AI processing"| node_ai_service
node_ai_service -.->|"calls processor"| node_ai_engine
node_ai_engine -->|"runs OCR"| node_ocr
node_ai_engine -->|"builds AI result"| node_extraction
node_extraction -->|"extracts fields"| node_field_extractor
node_applications_api -->|"invokes verification"| node_verification
node_verification -->|"checks registries"| node_registry
node_verification -->|"checks consistency"| node_consistency
node_compliance_api -->|"evaluates compliance"| node_rules
node_verification -.->|"evaluates evidence"| node_compliance_api
node_applications_api -->|"stores application"| node_application_data
node_upload_api -->|"stores files"| node_storage
node_verification -->|"returns findings"| node_result_ui
node_result_ui -.->|"opens reports"| node_reporting
node_bidder -->|"reviews history"| node_audit
node_bidder -->|"reviews reports"| node_reporting
node_synthetic -->|"tests determinations"| node_verification

click node_web "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/frontend/src/App.jsx"
click node_application_ui "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/frontend/src/pages/ApplicationForm.jsx"
click node_result_ui "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/frontend/src/pages/VerificationResult.jsx"
click node_dashboard_ui "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/frontend/src/pages/Dashboard.jsx"
click node_tender_api "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/api/tenders.py"
click node_applications_api "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/api/applications.py"
click node_upload_api "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/api/document_upload.py"
click node_document_api "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/api/documents.py"
click node_ai_service "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/services/ai_service.py"
click node_ai_engine "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/ai-engine/app/main.py"
click node_ocr "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/ai-engine/app/ocr/pipeline.py"
click node_extraction "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/ai-engine/app/extraction/extraction_pipeline.py"
click node_field_extractor "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/ai-engine/app/extraction/field_extractor.py"
click node_verification "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/services/verification_service.py"
click node_registry "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/tree/main/integration/services"
click node_compliance_api "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/api/compliance.py"
click node_rules "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/compliance_engine/rule_registry.py"
click node_consistency "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/services/consistency_service.py"
click node_application_data "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/models/application.py"
click node_storage "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/core/storage.py"
click node_reporting "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/services/report_service.py"
click node_audit "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/api/audit.py"
click node_synthetic "https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/data_synthetic/generators.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_application_ui,node_result_ui,node_dashboard_ui toneBlue
class node_tender_api,node_applications_api,node_upload_api,node_document_api toneAmber
class node_ai_service,node_ai_engine,node_ocr,node_extraction,node_field_extractor toneMint
class node_verification,node_registry,node_compliance_api,node_rules,node_consistency toneRose
class node_application_data,node_storage,node_reporting,node_audit,node_synthetic,node_bidder toneIndigo
```

## Components

### User experience

- [Web application](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [Application form](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/frontend/src/pages/ApplicationForm.jsx): `frontend/src/pages/ApplicationForm.jsx`
- [Verification results](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/frontend/src/pages/VerificationResult.jsx): `frontend/src/pages/VerificationResult.jsx`
- [Dashboard](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/frontend/src/pages/Dashboard.jsx): `frontend/src/pages/Dashboard.jsx`

### Tender workflow

- [Tender and requirements APIs](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/api/tenders.py): `backend/app/api/tenders.py`
- [Applications API](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/api/applications.py): `backend/app/api/applications.py`
- [Document upload API](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/api/document_upload.py): `backend/app/api/document_upload.py`
- [Document processing API](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/api/documents.py): `backend/app/api/documents.py`

### Document intelligence

- [AI service adapter](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/services/ai_service.py): `backend/app/services/ai_service.py`
- [AI document processor](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/ai-engine/app/main.py): `ai-engine/app/main.py`
- [OCR pipeline](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/ai-engine/app/ocr/pipeline.py): `ai-engine/app/ocr/pipeline.py`
- [Classification, extraction, consistency](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/ai-engine/app/extraction/extraction_pipeline.py): `ai-engine/app/extraction/extraction_pipeline.py`
- [Field extraction](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/ai-engine/app/extraction/field_extractor.py): `ai-engine/app/extraction/field_extractor.py`

### Verification and compliance

- [Verification orchestration](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/services/verification_service.py): `backend/app/services/verification_service.py`
- [Registry integrations](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/tree/main/integration/services): `integration/services`
- [Compliance API](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/api/compliance.py): `backend/app/api/compliance.py`
- [Deterministic compliance rules](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/compliance_engine/rule_registry.py): `compliance_engine/rule_registry.py`
- [Cross-document consistency](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/services/consistency_service.py): `backend/app/services/consistency_service.py`

### Operations and data

- [Application records](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/models/application.py): `backend/app/models/application.py`
- [Document storage](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/core/storage.py): `backend/app/core/storage.py`
- [Reports and explanations](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/services/report_service.py): `backend/app/services/report_service.py`
- [Audit trail](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/api/audit.py): `backend/app/api/audit.py`
- [Synthetic test corpus](https://github.com/shwet3728-ai/sih26100-gem-bid-compliance/blob/main/backend/app/data_synthetic/generators.py): `backend/app/data_synthetic/generators.py`

### Other components

- **Bidder / officer**

## Connections

- Bidder / officer → Web application: uses (evidence: `README.md`)
- Web application → Application form: routes to (evidence: `frontend/src/App.jsx`)
- Web application → Verification results: routes to (evidence: `frontend/src/App.jsx`)
- Web application → Dashboard: routes to (evidence: `frontend/src/App.jsx`)
- Bidder / officer → Tender and requirements APIs: creates tender (evidence: `README.md`)
- Bidder / officer → Applications API: submits application (evidence: `README.md`)
- Bidder / officer → Document upload API: uploads documents (evidence: `README.md`)
- Tender and requirements APIs → Applications API: defines requirements (evidence: `README.md`)
- Document upload API → Document processing API: processes documents (evidence: `README.md`)
- Document processing API → AI service adapter: requests AI processing
- AI service adapter → AI document processor: calls processor
- AI document processor → OCR pipeline: runs OCR (evidence: `ai-engine/app/main.py`)
- AI document processor → Classification, extraction, consistency: builds AI result (evidence: `ai-engine/app/main.py`)
- Classification, extraction, consistency → Field extraction: extracts fields (evidence: `ai-engine/app/extraction/extraction_pipeline.py`)
- Applications API → Verification orchestration: invokes verification (evidence: `backend/app/api/applications.py`)
- Verification orchestration → Registry integrations: checks registries (evidence: `backend/app/services/verification_service.py`)
- Verification orchestration → Cross-document consistency: checks consistency (evidence: `backend/app/services/verification_service.py`)
- Compliance API → Deterministic compliance rules: evaluates compliance (evidence: `README.md`)
- Verification orchestration → Compliance API: evaluates evidence
- Applications API → Application records: stores application (evidence: `backend/app/api/applications.py`)
- Document upload API → Document storage: stores files (evidence: `README.md`)
- Verification orchestration → Verification results: returns findings (evidence: `README.md`)
- Verification results → Reports and explanations: opens reports
- Bidder / officer → Audit trail: reviews history (evidence: `README.md`)
- Bidder / officer → Reports and explanations: reviews reports (evidence: `README.md`)
- Synthetic test corpus → Verification orchestration: tests determinations (evidence: `README.md`)
