How ragavendra0604/atomid works
Atomid is an offline-first, cross-platform retail POS. The principal workflow is an operator action that updates local Hive data, queues the change, and synchronizes it with Firestore when connectivity returns; signing in also supports pulling store history. The graph preserves the README’s billing, inventory, CRM, reporting/export, tax/loyalty, hardware, and sync capabilities. Dart implementation excerpts were not provided, so internal links beyond documented sync behavior are left unasserted or marked unverified.
Main entry points: storage_repository.dart Hive local storage · billing POS and billing · sync_service.dart Sync service · firebase_repository.dart Firebase repository
Components 22
App composition
- App bootstrap
lib/bootstrap.dart - State providers
lib/presentation/providers
Retail workflows
- POS and billing
lib/presentation/features/billing - Inventory management
lib/presentation/features/inventory - Customer CRM
lib/presentation/features/customers - Purchases
lib/presentation/features/purchases - Dashboard and reports
lib/presentation/features/reports - Tax and loyalty settings
lib/presentation/features/settings
Business logic
- Pricing and GST
lib/domain/pricing.dart - Sales service
lib/domain/services/sale_service.dart - Sync service
lib/domain/services/sync_service.dart
Persistence and sync
- Retail data models
lib/data/models - Hive local storage
lib/data/repositories/storage_repository.dart - Sync queue
lib/data/models/sync_queue_model.dart - Entity codec
lib/data/sync/entity_codec.dart - Firebase repository
lib/data/repositories/firebase_repository.dart
Device and cloud
- Retail hardware
lib/core/hardware - PDF export
lib/core/services/export_service.dart - Cloud Firestore
- Connectivity
- Firebase Auth
Other components
- Shop operator
Connections 18
- Shop operator → POS and billing: uses
README.md - POS and billing → Hive local storage: writes locally
README.md - Hive local storage → Sync queue: queues writes
README.md - Sync service → Sync queue: uploads queued data
- Sync service → Firebase repository: dispatches sync
- Firebase repository → Cloud Firestore: syncs data
README.md - Firebase Auth → Sync service: gates cloud sync
README.md - Sync service → Connectivity: waits for connectivity
- Inventory management → Hive local storage: records stock
- Customer CRM → Hive local storage: stores customer data
- Purchases → Hive local storage: stores purchases
- Dashboard and reports → PDF export: exports documents
- POS and billing → Pricing and GST: calculates totals
- POS and billing → Sales service: records sales
- POS and billing → Retail hardware: scans and prints
- App bootstrap → State providers: composes app
- Hive local storage → Retail data models: persists entities
- Sync service → Entity codec: encodes entities