How toyin-elankey/application-software- works
This is a Next.js commerce backend with storefront pages and APIs for catalogue, carts, checkout, customer identity and orders, staff administration, Paystack payments, refunds, and scheduled payment jobs. A shopper’s checkout request is validated by the API, handled by checkout services, and connected to payment-provider selection; webhooks and return routes support payment verification. Staff routes expose operational and refund capabilities behind role checks. The README describes an earlier data-layer status and planned AI/WhatsApp capabilities; those integrations are not represented as implemented here. Arrows rely on excerpts or SOURCE INDEX references, so unsampled relationships are omitted.
Main entry points: checkout/route.ts Checkout API · api.ts API plumbing · checkout.ts Checkout service · staff/route.ts Staff APIs
Components 26
Shopping and checkout
- Storefront
src/app/page.tsx - Catalogue API
src/app/api/v1/catalog/products/route.ts - Cart API
src/app/api/v1/cart/items/route.ts - Cart service
src/server/cart/cart.ts - Checkout API
src/app/api/v1/checkout/route.ts - Checkout service
src/server/checkout/checkout.ts - Pricing
src/server/pricing/pricing.ts - Delivery quotes
src/server/delivery/quote.ts
Identity and administration
- Customer APIs
src/app/api/v1/auth/logout/route.ts - Customer authentication
src/server/customers/auth.ts - Customer sessions
src/server/customers/sessions.ts - Order lookup API
src/app/api/v1/orders/[orderNumber]/route.ts - Staff APIs
src/app/api/v1/admin/staff/route.ts - Staff access guard
src/server/auth/guard.ts - Admin reads
src/server/admin/reads.ts
Payments and refunds
- Provider selection
src/server/payments/resolve.ts - Paystack webhook
src/server/payments/webhook.ts - Webhook API
src/app/api/webhooks/paystack/route.ts - Payment job drain
src/server/payments/drain.ts - Refund service
src/server/refunds/service.ts
Runtime foundations
- API plumbing
src/server/http/api.ts - HTTP errors
src/server/http/problem.ts - Database client
src/server/db/client.ts - PostgreSQL
- Tenant scope
src/server/tenant.ts
Other components
- Shopper
Connections 29
- Shopper → Storefront: browses
- Shopper → Catalogue API: requests products
- Shopper → Cart API: updates cart
- Cart API → Cart service: calls
src/app/api/v1/cart/items/route.ts - Cart API → API plumbing: uses
src/app/api/v1/cart/items/route.ts - Shopper → Checkout API: submits checkout
- Checkout API → Checkout service: calls
src/app/api/v1/checkout/route.ts - Checkout API → Provider selection: selects provider
src/app/api/v1/checkout/route.ts - Checkout API → API plumbing: uses
src/app/api/v1/checkout/route.ts - Checkout service → Pricing: uses
src/server/checkout/checkout.ts - Checkout service → Delivery quotes: uses
src/server/checkout/checkout.ts - Customer APIs → Customer authentication: calls
src/app/api/v1/auth/logout/route.ts - Customer APIs → Customer sessions: uses
src/app/api/v1/auth/logout/route.ts - Customer authentication → Customer sessions: opens sessions
src/server/customers/auth.ts - Order lookup API → Customer sessions: resolves access
src/app/api/v1/orders/[orderNumber]/route.ts - Staff APIs → Staff access guard: checks access
src/app/api/v1/admin/staff/route.ts - Staff APIs → API plumbing: uses
src/app/api/v1/admin/staff/route.ts - Staff APIs → PostgreSQL: manages staff records
src/app/api/v1/admin/staff/route.ts - Admin reads → Tenant scope: scopes queries
src/server/admin/reads.ts - Admin reads → PostgreSQL: reads commerce data
src/server/admin/reads.ts - Webhook API → Paystack webhook: accepts events
src/app/api/webhooks/paystack/route.ts - Webhook API → Payment job drain: drains jobs
src/app/api/webhooks/paystack/route.ts - Paystack webhook → PostgreSQL: stores events and jobs
src/server/payments/webhook.ts - Payment job drain → Refund service: dispatches refund work
src/server/payments/drain.ts - Checkout service → PostgreSQL: places orders
src/server/checkout/checkout.ts - Database client → PostgreSQL: connects
src/server/db/client.ts - API plumbing → Database client: gets client
src/server/http/api.ts - API plumbing → HTTP errors: uses responses
src/server/http/api.ts - Checkout API → HTTP errors: handles errors
src/app/api/v1/checkout/route.ts