How bikrambox/readybill_webapp works
ReadyBill is a multi-region grocery point-of-sale and shop-management application, with a Vue SPA and modular Laravel API. The main workflow is shop/staff access, inventory and customer management, cart checkout and billing, then transaction and report review; India and Germany have parallel domain modules with regional tax and unit configuration. Separate capabilities include account and subscription management, agent sales, and administrative oversight. The graph uses README-described capabilities where source excerpts were not sampled; those links are not presented as inspected call chains.
Main entry points: main.js Vue application · API/BillingController.php India billing · API/BillingController.php Germany billing · sell.blade.php Shop and staff
Components 22
Client experience
- Shop and staff
backend/Modules/CoreWeb/Resources/views/GroceryIndia/sell.blade.php - Vue application
frontend/src/main.js - Agent subscriptions
frontend/src/modules/AuthorizedAgents/components/subscription/SubscriptionManager.vue - Web experience
backend/Modules/CoreWeb/Http/Controllers/IndexController.php
Identity and access
- Authentication API
backend/Modules/Authentication/Http/Controllers/API/AuthController.php - Authentication routes
backend/Modules/Authentication/Routes/api.php - User accounts
backend/Modules/Authentication/Entities/User.php
Regional shop operations
- India operations
backend/Modules/GroceryIndia/Http/Controllers/API/ItemController.php - India billing
backend/Modules/GroceryIndia/Http/Controllers/API/BillingController.php - India commerce logic
backend/Modules/GroceryIndia/Helpers/BillingHelpher.php - India shop records
backend/Modules/GroceryIndia/Entities/Billing.php - Germany operations
backend/Modules/GroceryGermany/Http/Controllers/API/ItemController.php - Germany billing
backend/Modules/GroceryGermany/Http/Controllers/API/BillingController.php - Germany commerce logic
backend/Modules/GroceryGermany/Helpers/BillingHelpher.php - Germany shop records
backend/Modules/GroceryGermany/Entities/Billing.php
Shared services
- Shared API services
backend/Modules/Core/Http/Controllers/API/OTPController.php - Reports and exports
backend/Modules/GroceryIndia/Http/Controllers/API/ReportController.php
Administration and agents
- Admin console
backend/Modules/Admin/Http/Controllers/AdminDashboardController.php - Agent services
backend/Modules/Agent/Http/Controllers/API/AssignSubscriptionController.php - Subscription commissions
backend/Modules/Agent/Entities/SubscriptionCommission.php
Other components
- Shop or agent user
- Realtime delivery
Connections 23
- Shop or agent user → Vue application: uses
- Vue application → Authentication API: requests access
- Authentication routes → Authentication API: routes to
- Authentication API → User accounts: reads and updates
- Vue application → Shop and staff: uses shop screens
- Shop and staff → India operations: manages India shop
- Shop and staff → Germany operations: manages Germany shop
- India operations → India shop records: manages records
- India billing → India commerce logic: builds bill response
- India billing → India shop records: creates and updates bills
- India billing → Realtime delivery: broadcasts sale
- Germany operations → Germany shop records: manages records
- Germany billing → Germany commerce logic: builds bill response
- Germany billing → Germany shop records: creates and updates bills
- Germany billing → Realtime delivery: broadcasts sale
- India operations → Reports and exports: serves shop data
- Vue application → Shared API services: loads shared data
- Shop or agent user → Web experience: uses web pages
- Shop or agent user → Admin console: administers shops
- Shop or agent user → Agent subscriptions: manages subscriptions
- Agent subscriptions → Agent services: assigns plans
- Agent services → Subscription commissions: reads earnings
- Admin console → User accounts: reviews accounts