How nasserelbacha2002/dinamic-gemini works
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: server.py v3 REST API · hybrid_inventory_pipeline.py Inventory pipeline · mobile/App.tsx Mobile capture · src/App.tsx Web application
Components 27
Client applications
- Web application
frontend/src/App.tsx - Mobile capture
mobile/App.tsx - Pi scanner
raspberry-scanner/app.py - Scanner context
raspberry-scanner/config/inventory_context_repository.py - Mobile feature flags
mobile/src/core/featureFlags.ts - Capture database
mobile/src/database/schema/captureSchema.ts - Frontend query keys
frontend/src/api/queryKeys.ts
API and operations
- v3 REST API
backend/src/api/server.py - Storage admin
backend/src/api/routes/v3/admin_storage.py - Runtime settings
backend/src/config.py - Cleanup use case
backend/src/application/use_cases/admin_storage_cleanup.py - Settings composition
backend/src/env_settings/grouped_settings.py
Job processing
- Job worker
backend/src/infrastructure/pipeline/v3_process_aisle_pipeline_runner.py - Inventory pipeline
backend/src/pipeline/hybrid_inventory_pipeline.py - Analysis providers
backend/src/pipeline/providers/registry.py - Provider resolver
backend/src/pipeline/services/pipeline_provider_resolver.py - Supplier prompts
backend/src/application/services/supplier_prompt_resolver.py - Structured logging
backend/src/io/logging.py
Persistence and artifacts
- Repository contracts
backend/src/application/ports/repositories.py - SQL Server
- Artifact storage
backend/src/storage/ports/artifact_storage.py - Storage maintenance
backend/src/infrastructure/storage/artifact_storage_maintenance.py
Inventory outcomes
- Result evidence
backend/src/application/services/result_evidence_query_service.py - Review queue
backend/src/api/routes/v3/review_queue.py - Inventory analytics
backend/src/api/routes/v3/analytics_api.py - Position model
backend/src/domain/positions/entities.py
Other components
- Operator
Connections 25
- 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
backend/src/infrastructure/pipeline/v3_process_aisle_pipeline_runner.py - Inventory pipeline → Provider resolver: resolves provider
backend/src/pipeline/hybrid_inventory_pipeline.py - Provider resolver → Analysis providers: selects executor
backend/src/pipeline/services/pipeline_provider_resolver.py - Inventory pipeline → Supplier prompts: uses prompts
backend/src/infrastructure/pipeline/v3_process_aisle_pipeline_runner.py - Runtime settings → Settings composition: composes settings
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
backend/src/application/use_cases/admin_storage_cleanup.py - Storage maintenance → Artifact storage: cleans storage
- Pi scanner → Scanner context: uses context store
raspberry-scanner/app.py - Mobile capture → Capture database: uses local schema
mobile/App.tsx - Mobile capture → Mobile feature flags: checks flags
- Web application → Frontend query keys: uses query keys
- Job worker → Structured logging: logs processing
backend/src/infrastructure/pipeline/v3_process_aisle_pipeline_runner.py - Result evidence → Position model: maps position data
backend/src/application/services/result_evidence_query_service.py