KGL Groceries LTD Management System
A full-stack web system that digitizes KGL’s operations from procurement and stock management, to POS sales, credit exposure tracking, and executive analytics for branch performance.
director / password123 ·
Manager: manager / password123 ·
Agent: agent / password123
What this system covers
- Branch-based procurement, suppliers and produce management.
- POS checkout with automatic stock deduction and pricing controls.
- Formal credit sales, exposure dashboards and repayment tracking.
- Director-level reports: sales, credit, stock value and agent performance.
Core Modules
Designed around the real workflows of KGL Groceries LTD.
Procurement & Inventory
Capture produce purchases, suppliers, cost prices and tonnage per branch.
- Procurement orders and suppliers
- Branch-level stock and thresholds
- Stock value analytics
POS & Cash Sales
Modern POS for sales agents with category filters and live stock validation.
- Fast product search and filters
- Automatic stock deduction
- Agent performance stats
Credit Sales & Exposure
Formal credit module with buyer details, limits and repayments.
- Credit accounts and limits
- Outstanding balances
- Overdue and risk insights
Analytics & Reports
Executive dashboards for daily sales, credit, and stock health.
- Branch and global KPIs
- Recent transactions
- Downloadable reports
User & Branch Management
Central control of directors, managers and sales agents across branches.
- Role-based accounts
- Branch assignment
- Agent performance overview
Security & RBAC
JWT-based authentication and role-based access control for every module.
- JWT auth and protected APIs
- Director, manager, agent roles
- Per-page access enforcement
End-to-End Flow
From stock coming in, to sales going out, to insights for leadership.
1. Procurement & Stock In
Managers record deliveries from suppliers, set cost and sale prices, and assign stock to branches. The system tracks current tonnage, minimum levels, and total stock value automatically.
2. POS & Credit Sales
Sales agents use the POS to sell produce in cash or credit. Stock is reduced in real time, and credit exposure is tracked per buyer with formal records and due dates.
3. Reports & Decisions
Directors view consolidated dashboards: daily sales, outstanding credit, low-stock alerts, and branch comparisons, helping KGL plan procurement, pricing and collections.
Built as a Refactory Academy capstone project
This system was designed and implemented as a professional capstone project by a student of Refactory Academy, applying industry-level practices from requirements gathering, to data modelling, API design, frontend engineering and deployment.
The goal was not just to pass an assignment, but to simulate a real-world product for a growing agribusiness like KGL Groceries LTD: secure, role-based, and ready to grow with more branches and higher transaction volumes.
I am a learner from Refactory Academy, and this KGL Groceries LTD Management System is the result of the skills, mentorship and continuous support I received there. Many thanks to the instructors and the Refactory team for their commitment to high-quality, practical software training.
A note to anyone just starting out in software development:
Even if you are completely new to programming, a well-structured program like Refactory’s can give you a clear path, from fundamentals to building full systems like this one. By engaging seriously with the content, practicing consistently, and treating each project as if it were for a real client, you build skills that are valuable in the real job market. I am grateful for the quality of the learning content and the way it prepares us to contribute professionally.
Why this matters for KGL
- Reduces manual paperwork and reconciliation across branches.
- Gives management a single source of truth for stock, sales and credit.
- Improves accountability for agents and managers through clear roles.
- Prepares KGL for future integrations (mobile money, SMS reminders, etc.).
- Built with an architecture that can evolve as the business grows.