- Initialize Git repository
- Create folder structure (
/client,/server) - Initialize root
package.jsonfor unified workflow - Create root
.envwith mandatory variables - Advice user on git commit strategy (stable features/fixes)
- Setup Client dependencies (Vite, React, Tailwind, Router, Hook Form, Axios)
- Setup Server dependencies (Express, Mongoose, Axios, Dotenv, Cors, etc.)
- Setup
concurrentlyfor root dev script
- Configure Tailwind for client
- Implement
index.csswith handoff design tokens (Greens, Amber, Red) - Ensure mobile-first typography and spacing
- Setup Express app skeleton
- Setup MondoDB connection (Mongoose)
- Implement basic route structure
- Implement
Tradermodel - Implement
Customermodel - Implement
Debtmodel
- Implement
interswitch.service.ts(BVN/Credit API) - Implement
mock.service.ts(Deterministic scenarios) - Implement
customer.service.ts(Orchestration logic) - Implement
debt.service.ts
- Implement
POST /api/customer/verify - Ensure proper response shape for history vs no-history
- Implement
POST /api/debts(Create) - Implement
GET /api/debts(List + Summary) - Implement
PATCH /api/debts/:id/status(Update)
- Setup React Router (
/,/verify,/result,/debts/:id) - Setup basic API client (Axios instance)
- Create placeholder pages for all routes
-
TopBar -
TotalOwedCard -
DebtorRow -
StatusBadge -
ResultCard(Trust Theater) -
EmptyLedgerState,LoadingState
-
LedgerPage(Dashboard) -
VerifyPage(Identity Check) -
ResultPage(Verdict + Record Debt) -
DebtPage(Collect Payment)
- Implement Demo Seed path/data
- Final UI/UX audit (one-thumb, high contrast)
- Error handling review (no-history state check)
- Implement Pre-login Onboarding (3 marketing screens)
- Create High-fidelity SVG assets for onboarding
- Implement PWA Splash Screen and fade-out logic
- Configure PWA manifest and theme colors
- Optimize viewport and safe-area support
- End-to-end flow test (Pitch Rehearsal)
- Mock mode verification
- Submission cleanup
- Final /ship clearance