# adrienakilal/winmarket_ai architecture

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

- Interactive diagram: https://gitdiagram.com/adrienakilal/winmarket_ai
- Repository: https://github.com/adrienakilal/winmarket_ai

## Overview

WinMarket AI is a private, manually activated procurement-opportunity analysis application. The user registers and receives access only after operator activation, configures a profile, scoring policy and capacity, uploads private reference documents, then submits an opportunity for asynchronous analysis and receives scored results and generated deliverables. The graph preserves the documented dossier, knowledge, scoring, account and history capabilities. Edges use README statements or SOURCE INDEX references; unsampled route and job internals are not expanded into speculative calls.

Main entry points: [`src/web/routes_api.py`](https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/routes_api.py) (Analysis API), [`src/web/knowledge/documents_service.py`](https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/knowledge/documents_service.py) (Document management), [`src/web/jobs.py`](https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/jobs.py) (Analysis jobs), [`src/web/database/repositories/knowledge.py`](https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/database/repositories/knowledge.py) (Knowledge repository)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Web entry"]
  node_app["Web application<br/>[main.py]"]
  node_api["Analysis API<br/>[routes_api.py]"]
  node_pages["Account pages<br/>[routes_pages.py]"]
end

subgraph group_identity["Access and setup"]
  node_auth["Authentication<br/>[service.py]"]
  node_access["Access context<br/>[access_context.py]"]
  node_scoring_config["Scoring configuration"]
end

subgraph group_knowledge["Private knowledge"]
  node_documents["Document management"]
  node_extraction["Document extraction<br/>[extraction.py]"]
  node_private_files["Private file storage<br/>[storage.py]"]
  node_rag["Private RAG search"]
  node_hybrid_index["Hybrid indexing<br/>[hybrid_index.py]"]
  node_hybrid_search["Hybrid retrieval<br/>[hybrid_search.py]"]
end

subgraph group_analysis["Analysis and outputs"]
  node_dossier["Dossier intake<br/>[service.py]"]
  node_jobs["Analysis jobs<br/>[jobs.py]"]
  node_analysis_core["Analysis orchestration"]
  node_scoring["Scoring engine<br/>[scoring_engine.py]"]
  node_deliverables["Document generation"]
  node_llm["LLM adapter<br/>[llm_client.py]"]
end

subgraph group_persistence["Persistence"]
  node_db_session["Database sessions<br/>[session.py]"]
  node_db_models[("Application records<br/>[models.py]")]
  node_analysis_repo["Analysis repository<br/>[analyses.py]"]
  node_knowledge_repo["Knowledge repository<br/>[knowledge.py]"]
end

node_user(("Account user"))
node_operator(("Operator"))

node_user -->|"uses"| node_app
node_operator -->|"activates access"| node_auth
node_app -->|"routes requests"| node_api
node_app -->|"routes pages"| node_pages
node_pages -->|"uses access context"| node_access
node_api -->|"checks access"| node_access
node_auth -->|"manages identities"| node_db_models
node_access -->|"checks membership"| node_auth
node_user -->|"configures scoring"| node_scoring_config
node_scoring_config -->|"validates policy"| node_scoring
node_user -->|"uploads documents"| node_documents
node_documents -->|"extracts content"| node_extraction
node_documents -->|"stores files"| node_private_files
node_documents -->|"indexes documents"| node_hybrid_index
node_hybrid_index -->|"writes passages"| node_knowledge_repo
node_rag -->|"loads corpus"| node_knowledge_repo
node_hybrid_search -->|"uses private search"| node_rag
node_hybrid_search -->|"retrieves knowledge"| node_knowledge_repo
node_user -->|"submits opportunity"| node_api
node_api -->|"handles dossier intake"| node_dossier
node_api -->|"delegates analysis"| node_jobs
node_jobs -.->|"orchestrates analysis"| node_analysis_core
node_analysis_core -->|"scores opportunity"| node_scoring
node_scoring -->|"uses evidence"| node_rag
node_jobs -->|"generates deliverables"| node_deliverables
node_api -->|"configures dossier LLM"| node_llm
node_jobs -.->|"records analyses"| node_analysis_repo
node_db_session -->|"persists records"| node_db_models
node_analysis_repo -->|"reads and writes"| node_db_models
node_knowledge_repo -->|"reads and writes"| node_db_models

click node_app "https://github.com/adrienakilal/winmarket_ai/blob/main/main.py"
click node_api "https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/routes_api.py"
click node_pages "https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/routes_pages.py"
click node_auth "https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/auth/service.py"
click node_access "https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/auth/access_context.py"
click node_scoring_config "https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/routes_scoring_policy.py"
click node_documents "https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/knowledge/documents_service.py"
click node_extraction "https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/knowledge/extraction.py"
click node_private_files "https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/knowledge/storage.py"
click node_rag "https://github.com/adrienakilal/winmarket_ai/blob/main/src/rag/private_rag_manager.py"
click node_dossier "https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/ao_dossier/service.py"
click node_jobs "https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/jobs.py"
click node_analysis_core "https://github.com/adrienakilal/winmarket_ai/blob/main/src/core/analysis_service.py"
click node_scoring "https://github.com/adrienakilal/winmarket_ai/blob/main/src/agents/scoring_engine.py"
click node_deliverables "https://github.com/adrienakilal/winmarket_ai/blob/main/src/livrables/document_generator.py"
click node_db_session "https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/database/session.py"
click node_db_models "https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/database/models.py"
click node_analysis_repo "https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/database/repositories/analyses.py"
click node_knowledge_repo "https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/database/repositories/knowledge.py"
click node_hybrid_index "https://github.com/adrienakilal/winmarket_ai/blob/main/src/rag/hybrid_index.py"
click node_hybrid_search "https://github.com/adrienakilal/winmarket_ai/blob/main/src/rag/hybrid_search.py"
click node_llm "https://github.com/adrienakilal/winmarket_ai/blob/main/src/agents/llm_client.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_app,node_api,node_pages,node_user toneBlue
class node_auth,node_access,node_scoring_config toneAmber
class node_documents,node_extraction,node_private_files,node_rag,node_hybrid_index,node_hybrid_search toneMint
class node_dossier,node_jobs,node_analysis_core,node_scoring,node_deliverables,node_llm toneRose
class node_db_session,node_db_models,node_analysis_repo,node_knowledge_repo,node_operator toneIndigo
```

## Components

### Web entry

- [Web application](https://github.com/adrienakilal/winmarket_ai/blob/main/main.py): `main.py`
- [Analysis API](https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/routes_api.py): `src/web/routes_api.py`
- [Account pages](https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/routes_pages.py): `src/web/routes_pages.py`

### Access and setup

- [Authentication](https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/auth/service.py): `src/web/auth/service.py`
- [Access context](https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/auth/access_context.py): `src/web/auth/access_context.py`
- [Scoring configuration](https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/routes_scoring_policy.py): `src/web/routes_scoring_policy.py`

### Private knowledge

- [Document management](https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/knowledge/documents_service.py): `src/web/knowledge/documents_service.py`
- [Document extraction](https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/knowledge/extraction.py): `src/web/knowledge/extraction.py`
- [Private file storage](https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/knowledge/storage.py): `src/web/knowledge/storage.py`
- [Private RAG search](https://github.com/adrienakilal/winmarket_ai/blob/main/src/rag/private_rag_manager.py): `src/rag/private_rag_manager.py`
- [Hybrid indexing](https://github.com/adrienakilal/winmarket_ai/blob/main/src/rag/hybrid_index.py): `src/rag/hybrid_index.py`
- [Hybrid retrieval](https://github.com/adrienakilal/winmarket_ai/blob/main/src/rag/hybrid_search.py): `src/rag/hybrid_search.py`

### Analysis and outputs

- [Dossier intake](https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/ao_dossier/service.py): `src/web/ao_dossier/service.py`
- [Analysis jobs](https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/jobs.py): `src/web/jobs.py`
- [Analysis orchestration](https://github.com/adrienakilal/winmarket_ai/blob/main/src/core/analysis_service.py): `src/core/analysis_service.py`
- [Scoring engine](https://github.com/adrienakilal/winmarket_ai/blob/main/src/agents/scoring_engine.py): `src/agents/scoring_engine.py`
- [Document generation](https://github.com/adrienakilal/winmarket_ai/blob/main/src/livrables/document_generator.py): `src/livrables/document_generator.py`
- [LLM adapter](https://github.com/adrienakilal/winmarket_ai/blob/main/src/agents/llm_client.py): `src/agents/llm_client.py`

### Persistence

- [Database sessions](https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/database/session.py): `src/web/database/session.py`
- [Application records](https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/database/models.py): `src/web/database/models.py`
- [Analysis repository](https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/database/repositories/analyses.py): `src/web/database/repositories/analyses.py`
- [Knowledge repository](https://github.com/adrienakilal/winmarket_ai/blob/main/src/web/database/repositories/knowledge.py): `src/web/database/repositories/knowledge.py`

### Other components

- **Account user**
- **Operator**

## Connections

- Account user → Web application: uses (evidence: `README.md`)
- Operator → Authentication: activates access (evidence: `README.md`)
- Web application → Analysis API: routes requests (evidence: `main.py`)
- Web application → Account pages: routes pages (evidence: `main.py`)
- Account pages → Access context: uses access context (evidence: `src/web/routes_pages.py`)
- Analysis API → Access context: checks access (evidence: `src/web/routes_api.py`)
- Authentication → Application records: manages identities (evidence: `src/web/auth/service.py`)
- Access context → Authentication: checks membership (evidence: `src/web/auth/access_context.py`)
- Account user → Scoring configuration: configures scoring (evidence: `README.md`)
- Scoring configuration → Scoring engine: validates policy (evidence: `src/web/routes_scoring_policy.py`)
- Account user → Document management: uploads documents (evidence: `README.md`)
- Document management → Document extraction: extracts content (evidence: `src/web/knowledge/documents_service.py`)
- Document management → Private file storage: stores files (evidence: `src/web/knowledge/documents_service.py`)
- Document management → Hybrid indexing: indexes documents (evidence: `src/web/knowledge/documents_service.py`)
- Hybrid indexing → Knowledge repository: writes passages (evidence: `src/rag/hybrid_index.py`)
- Private RAG search → Knowledge repository: loads corpus (evidence: `src/rag/private_rag_manager.py`)
- Hybrid retrieval → Private RAG search: uses private search (evidence: `src/rag/hybrid_search.py`)
- Hybrid retrieval → Knowledge repository: retrieves knowledge (evidence: `src/rag/hybrid_search.py`)
- Account user → Analysis API: submits opportunity (evidence: `README.md`)
- Analysis API → Dossier intake: handles dossier intake (evidence: `src/web/routes_api.py`)
- Analysis API → Analysis jobs: delegates analysis (evidence: `src/web/routes_api.py`)
- Analysis jobs → Analysis orchestration: orchestrates analysis
- Analysis orchestration → Scoring engine: scores opportunity (evidence: `src/core/analysis_service.py`)
- Scoring engine → Private RAG search: uses evidence (evidence: `src/agents/scoring_engine.py`)
- Analysis jobs → Document generation: generates deliverables
- Analysis API → LLM adapter: configures dossier LLM (evidence: `src/web/routes_api.py`)
- Analysis jobs → Analysis repository: records analyses
- Database sessions → Application records: persists records (evidence: `src/web/database/session.py`)
- Analysis repository → Application records: reads and writes (evidence: `src/web/database/repositories/analyses.py`)
- Knowledge repository → Application records: reads and writes (evidence: `src/web/database/repositories/knowledge.py`)
