How hainhtat/lotayapos works
Lotaya is an internal Myanmar COD-delivery ERP and rider app. The principal workflow runs from shop pickup and batch/advance recording, through parcel intake and dispatch, to rider delivery outcomes, returns, settlements, cashbook close, and reporting. The backend API coordinates these domain services and persists shared operational and accounting state. The README documents the major capabilities and business stages; sampled source and the SOURCE INDEX support selected API-to-service relationships, but not every UI/API call or finance implementation detail.
Main entry points: app.ts HTTP API · ledger.service.ts Double-Entry Ledger · parcel.service.ts Parcel Lifecycle · operations.controller.ts Dispatch and Handover
Components 22
ERP and Rider Apps
- ERP Workspaces
frontend/src/pages/operations-page.tsx - Rider App
mobile/app/(tabs)/index.tsx
API and Access
- HTTP API
backend/src/app.ts - Authentication and Roles
backend/src/middleware/auth.ts - Session Service
backend/src/services/auth.service.ts - Operational Database
backend/src/config/database.ts
Delivery Operations
- Master Data
backend/src/services/master-data.service.ts - Batches and Advances
backend/src/services/operations.service.ts - Manifest Import
backend/src/services/manifest-import.service.ts - Parcel Lifecycle
backend/src/services/parcel.service.ts - Dispatch and Handover
backend/src/controllers/operations.controller.ts - Rider Outcomes
backend/src/services/parcel.service.ts - Shop Returns
backend/src/services/finance/os-returns.ts - Manifest Documents
backend/src/utils/manifest-pdf.ts
Finance and Reporting
- Shop Accounts
backend/src/services/os-account.service.ts - Rider Settlements
backend/src/services/finance/rider-settlements.ts - Shop Settlements
backend/src/services/finance/os-settlements.ts - Cashbook Close
backend/src/services/finance/cashbook-close.ts - Double-Entry Ledger
backend/src/services/ledger.service.ts - Reports
backend/src/services/reports.service.ts
Other components
- Operations and Finance Staff
- Rider
Connections 27
- Operations and Finance Staff → ERP Workspaces: uses
README.md - Rider → Rider App: uses
README.md - ERP Workspaces → HTTP API: accesses
README.md - Rider App → HTTP API: accesses
README.md - HTTP API → Authentication and Roles: guards routes
- HTTP API → Operational Database: configures
backend/src/app.ts - Authentication and Roles → Operational Database: checks user
backend/src/middleware/auth.ts - HTTP API → Session Service: routes requests
- HTTP API → Master Data: routes requests
- HTTP API → Batches and Advances: routes operations
- HTTP API → Parcel Lifecycle: routes operations
- HTTP API → Manifest Import: previews import
- HTTP API → Dispatch and Handover: routes requests
- Dispatch and Handover → Batches and Advances: calls
backend/src/controllers/operations.controller.ts - Dispatch and Handover → Manifest Documents: generates
backend/src/controllers/operations.controller.ts - Parcel Lifecycle → Rider Outcomes: records outcomes
README.md - Rider Outcomes → Shop Returns: queues failed parcels
README.md - Batches and Advances → Shop Accounts: finalizes accounting
backend/src/services/operations.service.ts - Parcel Lifecycle → Double-Entry Ledger: posts corrections
backend/src/services/parcel.service.ts - Shop Returns → Shop Accounts: credits returns
- Rider Settlements → Double-Entry Ledger: posts settlements
- Shop Settlements → Double-Entry Ledger: posts settlements
- Cashbook Close → Double-Entry Ledger: closes accounting
- Operations and Finance Staff → Rider Settlements: settles riders
README.md - Operations and Finance Staff → Shop Settlements: settles shops
README.md - Operations and Finance Staff → Cashbook Close: closes day
README.md - Operations and Finance Staff → Reports: reviews
README.md