# nasserelbacha2002/dinamic-gemini architecture

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

- Interactive diagram: https://gitdiagram.com/nasserelbacha2002/dinamic-gemini
- Repository: https://github.com/nasserelbacha2002/dinamic-gemini

## Overview

Dinamic Inventory is an inventory-operations platform whose main workflow runs from an operator using the web app, through the v3 REST API and job processing, to inventory results and review. Processing combines computer-vision and configurable LLM stages; the platform also supports mobile capture, a Raspberry Pi scanner, analytics, and administrative storage maintenance. The README documents the API, worker, SQL Server, and artifact-storage roles. Some subsystem links below are documented at a high level rather than verified in sampled implementation code.

Main entry points: [`backend/src/api/server.py`](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/api/server.py) (v3 REST API), [`backend/src/pipeline/hybrid_inventory_pipeline.py`](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/pipeline/hybrid_inventory_pipeline.py) (Inventory pipeline), [`mobile/App.tsx`](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/mobile/App.tsx) (Mobile capture), [`frontend/src/App.tsx`](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/frontend/src/App.tsx) (Web application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_clients["Client applications"]
  node_web["Web application<br/>[App.tsx]"]
  node_mobile["Mobile capture<br/>[App.tsx]"]
  node_pi["Pi scanner<br/>[app.py]"]
  node_local_scanner_context["Scanner context"]
  node_mobile_flags["Mobile feature flags<br/>[featureFlags.ts]"]
  node_capture_schema[("Capture database<br/>[captureSchema.ts]")]
  node_query_keys["Frontend query keys<br/>[queryKeys.ts]"]
end

subgraph group_api["API and operations"]
  node_api["v3 REST API<br/>[server.py]"]
  node_admin["Storage admin<br/>[admin_storage.py]"]
  node_settings["Runtime settings<br/>[config.py]"]
  node_cleanup_use_case["Cleanup use case"]
  node_app_settings["Settings composition"]
end

subgraph group_processing["Job processing"]
  node_worker["Job worker"]
  node_pipeline["Inventory pipeline"]
  node_provider["Analysis providers<br/>[registry.py]"]
  node_provider_resolver["Provider resolver"]
  node_prompt["Supplier prompts"]
  node_logging["Structured logging<br/>[logging.py]"]
end

subgraph group_data["Persistence and artifacts"]
  node_repositories["Repository contracts<br/>[repositories.py]"]
  node_sql[("SQL Server")]
  node_artifacts[("Artifact storage")]
  node_maintenance["Storage maintenance"]
end

subgraph group_results["Inventory outcomes"]
  node_evidence["Result evidence"]
  node_review["Review queue<br/>[review_queue.py]"]
  node_analytics["Inventory analytics<br/>[analytics_api.py]"]
  node_position_domain["Position model<br/>[entities.py]"]
end

node_operator(("Operator"))

node_operator -->|"uses"| node_web
node_web -->|"calls"| node_api
node_mobile -.->|"syncs with"| node_api
node_pi -.->|"uploads to"| node_api
node_api -.->|"dispatches jobs"| node_worker
node_worker -->|"runs"| node_pipeline
node_pipeline -->|"resolves provider"| node_provider_resolver
node_provider_resolver -->|"selects executor"| node_provider
node_pipeline -->|"uses prompts"| node_prompt
node_settings -->|"composes settings"| node_app_settings
node_api -.->|"uses contracts"| node_repositories
node_repositories -.->|"persists through"| node_sql
node_pipeline -.->|"writes artifacts"| node_artifacts
node_api -.->|"queries results"| node_evidence
node_api -->|"serves review"| node_review
node_api -->|"serves analytics"| node_analytics
node_admin -.->|"requests cleanup"| node_cleanup_use_case
node_cleanup_use_case -->|"delegates cleanup"| node_maintenance
node_maintenance -.->|"cleans storage"| node_artifacts
node_pi -->|"uses context store"| node_local_scanner_context
node_mobile -->|"uses local schema"| node_capture_schema
node_mobile -.->|"checks flags"| node_mobile_flags
node_web -.->|"uses query keys"| node_query_keys
node_worker -.->|"logs processing"| node_logging
node_evidence -.->|"maps position data"| node_position_domain

click node_web "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/frontend/src/App.tsx"
click node_mobile "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/mobile/App.tsx"
click node_pi "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/raspberry-scanner/app.py"
click node_api "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/api/server.py"
click node_admin "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/api/routes/v3/admin_storage.py"
click node_worker "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/infrastructure/pipeline/v3_process_aisle_pipeline_runner.py"
click node_pipeline "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/pipeline/hybrid_inventory_pipeline.py"
click node_provider "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/pipeline/providers/registry.py"
click node_provider_resolver "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/pipeline/services/pipeline_provider_resolver.py"
click node_settings "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/config.py"
click node_prompt "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/application/services/supplier_prompt_resolver.py"
click node_repositories "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/application/ports/repositories.py"
click node_artifacts "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/storage/ports/artifact_storage.py"
click node_maintenance "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/infrastructure/storage/artifact_storage_maintenance.py"
click node_cleanup_use_case "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/application/use_cases/admin_storage_cleanup.py"
click node_evidence "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/application/services/result_evidence_query_service.py"
click node_review "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/api/routes/v3/review_queue.py"
click node_analytics "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/api/routes/v3/analytics_api.py"
click node_local_scanner_context "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/raspberry-scanner/config/inventory_context_repository.py"
click node_app_settings "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/env_settings/grouped_settings.py"
click node_position_domain "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/domain/positions/entities.py"
click node_logging "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/io/logging.py"
click node_mobile_flags "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/mobile/src/core/featureFlags.ts"
click node_capture_schema "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/mobile/src/database/schema/captureSchema.ts"
click node_query_keys "https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/frontend/src/api/queryKeys.ts"

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_mobile,node_pi,node_local_scanner_context,node_mobile_flags,node_capture_schema,node_query_keys toneBlue
class node_api,node_admin,node_settings,node_cleanup_use_case,node_app_settings toneAmber
class node_worker,node_pipeline,node_provider,node_provider_resolver,node_prompt,node_logging toneMint
class node_repositories,node_sql,node_artifacts,node_maintenance toneRose
class node_evidence,node_review,node_analytics,node_position_domain,node_operator toneIndigo
```

## Components

### Client applications

- [Web application](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Mobile capture](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/mobile/App.tsx): `mobile/App.tsx`
- [Pi scanner](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/raspberry-scanner/app.py): `raspberry-scanner/app.py`
- [Scanner context](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/raspberry-scanner/config/inventory_context_repository.py): `raspberry-scanner/config/inventory_context_repository.py`
- [Mobile feature flags](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/mobile/src/core/featureFlags.ts): `mobile/src/core/featureFlags.ts`
- [Capture database](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/mobile/src/database/schema/captureSchema.ts): `mobile/src/database/schema/captureSchema.ts`
- [Frontend query keys](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/frontend/src/api/queryKeys.ts): `frontend/src/api/queryKeys.ts`

### API and operations

- [v3 REST API](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/api/server.py): `backend/src/api/server.py`
- [Storage admin](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/api/routes/v3/admin_storage.py): `backend/src/api/routes/v3/admin_storage.py`
- [Runtime settings](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/config.py): `backend/src/config.py`
- [Cleanup use case](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/application/use_cases/admin_storage_cleanup.py): `backend/src/application/use_cases/admin_storage_cleanup.py`
- [Settings composition](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/env_settings/grouped_settings.py): `backend/src/env_settings/grouped_settings.py`

### Job processing

- [Job worker](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/infrastructure/pipeline/v3_process_aisle_pipeline_runner.py): `backend/src/infrastructure/pipeline/v3_process_aisle_pipeline_runner.py`
- [Inventory pipeline](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/pipeline/hybrid_inventory_pipeline.py): `backend/src/pipeline/hybrid_inventory_pipeline.py`
- [Analysis providers](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/pipeline/providers/registry.py): `backend/src/pipeline/providers/registry.py`
- [Provider resolver](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/pipeline/services/pipeline_provider_resolver.py): `backend/src/pipeline/services/pipeline_provider_resolver.py`
- [Supplier prompts](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/application/services/supplier_prompt_resolver.py): `backend/src/application/services/supplier_prompt_resolver.py`
- [Structured logging](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/io/logging.py): `backend/src/io/logging.py`

### Persistence and artifacts

- [Repository contracts](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/application/ports/repositories.py): `backend/src/application/ports/repositories.py`
- **SQL Server**
- [Artifact storage](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/storage/ports/artifact_storage.py): `backend/src/storage/ports/artifact_storage.py`
- [Storage maintenance](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/infrastructure/storage/artifact_storage_maintenance.py): `backend/src/infrastructure/storage/artifact_storage_maintenance.py`

### Inventory outcomes

- [Result evidence](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/application/services/result_evidence_query_service.py): `backend/src/application/services/result_evidence_query_service.py`
- [Review queue](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/api/routes/v3/review_queue.py): `backend/src/api/routes/v3/review_queue.py`
- [Inventory analytics](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/api/routes/v3/analytics_api.py): `backend/src/api/routes/v3/analytics_api.py`
- [Position model](https://github.com/nasserelbacha2002/dinamic-gemini/blob/main/backend/src/domain/positions/entities.py): `backend/src/domain/positions/entities.py`

### Other components

- **Operator**

## Connections

- Operator → Web application: uses
- Web application → v3 REST API: calls
- Mobile capture → v3 REST API: syncs with
- Pi scanner → v3 REST API: uploads to
- v3 REST API → Job worker: dispatches jobs
- Job worker → Inventory pipeline: runs (evidence: `backend/src/infrastructure/pipeline/v3_process_aisle_pipeline_runner.py`)
- Inventory pipeline → Provider resolver: resolves provider (evidence: `backend/src/pipeline/hybrid_inventory_pipeline.py`)
- Provider resolver → Analysis providers: selects executor (evidence: `backend/src/pipeline/services/pipeline_provider_resolver.py`)
- Inventory pipeline → Supplier prompts: uses prompts (evidence: `backend/src/infrastructure/pipeline/v3_process_aisle_pipeline_runner.py`)
- Runtime settings → Settings composition: composes settings (evidence: `backend/src/config.py`)
- v3 REST API → Repository contracts: uses contracts
- Repository contracts → SQL Server: persists through
- Inventory pipeline → Artifact storage: writes artifacts
- v3 REST API → Result evidence: queries results
- v3 REST API → Review queue: serves review
- v3 REST API → Inventory analytics: serves analytics
- Storage admin → Cleanup use case: requests cleanup
- Cleanup use case → Storage maintenance: delegates cleanup (evidence: `backend/src/application/use_cases/admin_storage_cleanup.py`)
- Storage maintenance → Artifact storage: cleans storage
- Pi scanner → Scanner context: uses context store (evidence: `raspberry-scanner/app.py`)
- Mobile capture → Capture database: uses local schema (evidence: `mobile/App.tsx`)
- Mobile capture → Mobile feature flags: checks flags
- Web application → Frontend query keys: uses query keys
- Job worker → Structured logging: logs processing (evidence: `backend/src/infrastructure/pipeline/v3_process_aisle_pipeline_runner.py`)
- Result evidence → Position model: maps position data (evidence: `backend/src/application/services/result_evidence_query_service.py`)
