How ten101111/azs-mobile works
АЗС Mobile is a corporate-authenticated PWA for finding and analyzing fuel stations, with operational fuel data and an AI analytics assistant. The main user flow is sign-in, then station lookup or analytics; backend routes provide station and operational data, while AI questions pass through scoped SQL generation, validation, and execution. The README also documents maps, staff recommendations, and offline/PWA behavior. Some branches are documented but not represented by sampled implementation files, so their links are shown only where evidence supports them.
Main entry points: main.py API application · pipeline.py Question pipeline · api.py AI API · main.jsx PWA interface
Components 25
Mobile experience
- PWA interface
azs-mobile/src/main.jsx - AI orb
azs-mobile/src/orb/AiOrb.jsx - Orb renderer
azs-mobile/src/orb/orbEngine.js
Identity and access
- API application
azs-mobile/backend/main.py - Role scopes
azs-mobile/backend/roles.py - Auth database
azs-mobile/backend/main.py
Station operations
- Station registry
azs-mobile/backend/main.py - Fuel stock
azs-mobile/backend/fuel_stock.py - Fuel outages
azs-mobile/backend/fuel_outages.py - Staff recommendations
azs-mobile/backend/main.py
Analytics and AI
- Summary API
azs-mobile/backend/summary_api.py - KPI summaries
azs-mobile/backend/summary.py - AI API
azs-mobile/backend/ai/api.py - Question pipeline
azs-mobile/backend/ai/pipeline.py - Scope builder
azs-mobile/backend/ai/scope.py - SQL generator
azs-mobile/backend/ai/generator.py - Data contract
azs-mobile/backend/ai/contract.py - Schema catalog
azs-mobile/backend/ai/catalog.py - SQL validator
azs-mobile/backend/ai/validator.py - Query executor
azs-mobile/backend/ai/executor.py - AI journal
azs-mobile/backend/ai/journal.py - AI dialogs
azs-mobile/backend/ai/dialogs.py - AI quality reviews
azs-mobile/backend/ai/quality.py - Quality export
azs-mobile/backend/ai/quality_export.py
Other components
- Employee
Connections 24
- Employee → PWA interface: uses
- PWA interface → API application: requests API
- PWA interface → AI orb: renders
azs-mobile/src/main.jsx - AI orb → Orb renderer: creates orb
azs-mobile/src/orb/AiOrb.jsx - API application → Role scopes: uses roles
azs-mobile/backend/main.py - API application → Auth database: stores sessions
azs-mobile/backend/main.py - API application → Station registry: serves registry
azs-mobile/backend/main.py - API application → Fuel stock: routes fuel data
azs-mobile/backend/main.py - API application → Fuel outages: routes outage data
azs-mobile/backend/main.py - API application → Staff recommendations: serves recommendations
azs-mobile/backend/main.py - API application → Summary API: mounts routes
azs-mobile/backend/main.py - Summary API → KPI summaries: builds summaries
azs-mobile/backend/summary_api.py - API application → AI API: mounts routes
azs-mobile/backend/main.py - AI API → Question pipeline: asks question
azs-mobile/backend/ai/api.py - Question pipeline → Scope builder: builds scope
azs-mobile/backend/ai/pipeline.py - Question pipeline → SQL generator: generates SQL
azs-mobile/backend/ai/pipeline.py - SQL generator → Data contract: uses prompt contract
azs-mobile/backend/ai/generator.py - Data contract → Schema catalog: uses catalog
azs-mobile/backend/ai/contract.py - Question pipeline → SQL validator: validates SQL
azs-mobile/backend/ai/pipeline.py - Question pipeline → Query executor: runs checked SQL
azs-mobile/backend/ai/pipeline.py - Question pipeline → AI journal: logs answer
azs-mobile/backend/ai/pipeline.py - AI API → AI dialogs: manages dialogs
azs-mobile/backend/ai/api.py - AI API → AI quality reviews: records reviews
azs-mobile/backend/ai/api.py - AI API → Quality export: exports reviews
azs-mobile/backend/ai/api.py