How nextdevelopernetwork/posta-fast works
Posta Fast is a parcel-delivery operations application spanning seller package creation, office intake and handling, courier transit and delivery, and finance settlement. Role-specific Next.js pages invoke server actions and queries; these access a shared PostgreSQL database. Admin tools cover office/user management and backup. Edges reflect sampled calls or SOURCE INDEX references; several listed capability pages were not sampled, so their internal links are omitted.
Main entry points: queries.ts Parcel queries · courier-system.ts Package actions · auth-guards.ts Role access guard · index.ts PostgreSQL database
Components 22
Access and identity
- Login and registration
app/(auth)/login/page.tsx - Authentication actions
app/actions/auth.ts - Session and providers
auth.ts - Role access guard
lib/auth-guards.ts
Parcel operations
- Seller portal
app/seller/new/page.tsx - Package actions
app/actions/courier-system.ts - Office intake
app/office/intake/page.tsx - Office handling
app/office/unloading/page.tsx - Courier bags
app/courier/bags/page.tsx - Courier delivery
app/courier/deliveries/page.tsx - Parcel queries
lib/queries.ts
Finance
- Finance dashboard
app/finance/page.tsx - Finance ledger
app/finance/ledger/page.tsx - Office payouts
app/finance/office-payouts/page.tsx - Payout processing
components/finance/office-payout-modal.tsx
Administration and data
- Office administration
app/admin/offices/page.tsx - Admin dashboard
app/admin/page.tsx - Backup management
app/admin/backup/page.tsx - Backup actions
app/actions/backup.ts - Backup export route
app/api/admin/backup/export/route.ts - PostgreSQL database
db/index.ts
Other components
- User
Connections 31
- User → Login and registration: signs in
app/(auth)/login/page.tsx - Login and registration → Authentication actions: submits credentials
app/(auth)/login/page.tsx - Authentication actions → Session and providers: calls sign-in
app/actions/auth.ts - Session and providers → PostgreSQL database: reads users
auth.ts - Seller portal → Package actions: creates packages
app/seller/new/page.tsx - Office intake → Package actions: accepts intake
app/office/intake/page.tsx - Office handling → Package actions: updates handling
app/office/unloading/page.tsx - Courier bags → Package actions: manages bags
app/courier/bags/page.tsx - Courier delivery → Package actions: records delivery
app/courier/deliveries/page.tsx - Seller portal → Parcel queries: loads packages
app/seller/new/page.tsx - Office handling → Parcel queries: loads operations
app/office/unloading/page.tsx - Courier bags → Parcel queries: loads bag data
app/courier/bags/page.tsx - Package actions → PostgreSQL database: updates parcel records
app/actions/courier-system.ts - Parcel queries → PostgreSQL database: queries records
lib/queries.ts - Finance dashboard → Role access guard: checks access
app/finance/page.tsx - Finance ledger → Role access guard: checks access
app/finance/ledger/page.tsx - Office payouts → Role access guard: checks access
app/finance/office-payouts/page.tsx - Role access guard → Session and providers: reads session
lib/auth-guards.ts - Role access guard → PostgreSQL database: loads office name
lib/auth-guards.ts - Finance dashboard → Parcel queries: loads finance data
app/finance/page.tsx - Finance ledger → Parcel queries: loads ledger data
app/finance/ledger/page.tsx - Office payouts → Parcel queries: loads payout data
app/finance/office-payouts/page.tsx - Office payouts → Payout processing: opens payout flow
app/finance/office-payouts/page.tsx - Payout processing → Package actions: submits payout
components/finance/office-payout-modal.tsx - Office administration → Package actions: manages offices
app/admin/offices/page.tsx - Office administration → Parcel queries: loads office data
app/admin/offices/page.tsx - Admin dashboard → Role access guard: checks access
app/admin/page.tsx - Admin dashboard → Parcel queries: loads overview
app/admin/page.tsx - Backup management → Backup actions: requests backup
app/admin/backup/page.tsx - Backup actions → PostgreSQL database: reads records
app/actions/backup.ts - Backup export route → PostgreSQL database: exports records
app/api/admin/backup/export/route.ts