How drowlands60/poles-apart works
Poles Apart is a Next.js operations app for managing customers, recurring rounds, scheduled cleaning runs, field completion, and payments. Staff work from dashboard pages and forms; run details assemble customers and rounds, while the round view supports completion, skipping, notes, and reordering. Payment screens track due and received charges. Supabase provides application data and authentication; Twilio-backed SMS, geocoding, and JSON backup are additional capabilities visible in the tree. Several feature implementations are unsampled, so their internal data flows are not expanded here.
Main entry points: server.ts Server Supabase client · actions.ts Payment operations · customers Customer screens · runs Run screens
Components 24
Customer & Rounds
- Customer records
src/app/dashboard/customers/actions.ts - Customer screens
src/app/dashboard/customers - Round management
src/app/dashboard/rounds/actions.ts - Round screens
src/app/dashboard/rounds - Cleaner management
src/app/dashboard/cleaners/actions.ts
Run Operations
- Run management
src/app/dashboard/runs/actions.ts - Run screens
src/app/dashboard/runs - Field updates
src/app/dashboard/round-view/actions.ts - Field workflow
src/app/dashboard/round-view/round-view-client.tsx - Run map
src/app/dashboard/runs/[id]/run-map.tsx
Payments
- Payment operations
src/app/dashboard/payments/actions.ts - Payment screens
src/app/dashboard/payments/payments-client.tsx - Add customer charge
src/app/dashboard/customers/add-charge-button.tsx
Platform Services
- Login
src/app/login/login-form.tsx - Auth routes
src/app/auth/callback/route.ts - Session middleware
src/middleware.ts - Server Supabase client
src/lib/supabase/server.ts - Browser Supabase client
src/lib/supabase/client.ts - Admin Supabase client
src/lib/supabase/admin.ts - Geocode cache API
src/app/api/geocode-cache/route.ts - Backup API
src/app/api/backup/route.ts - SMS service
src/lib/sms.ts
Other components
- Staff
- Supabase
Connections 24
- Staff → Login: signs in
- Login → Browser Supabase client: authenticates with
src/app/login/login-form.tsx - Auth routes → Server Supabase client: creates client
src/app/auth/callback/route.ts - Session middleware → Server Supabase client: refreshes session
src/middleware.ts - Customer records → Server Supabase client: creates client
src/app/dashboard/customers/actions.ts - Customer screens → Customer records: invokes actions
src/app/dashboard/customers/[id]/page.tsx - Customer screens → Add customer charge: renders
src/app/dashboard/customers/[id]/page.tsx - Add customer charge → Payment operations: calls
src/app/dashboard/customers/add-charge-button.tsx - Round management → Server Supabase client: creates client
src/app/dashboard/rounds/actions.ts - Round screens → Round management: invokes actions
src/app/dashboard/rounds/[id]/page.tsx - Cleaner management → Server Supabase client: creates client
- Run management → Server Supabase client: creates client
src/app/dashboard/runs/actions.ts - Run screens → Run management: calls
src/app/dashboard/runs/[id]/run-detail-client.tsx - Field workflow → Field updates: calls
src/app/dashboard/round-view/round-view-client.tsx - Field workflow → Run map: uses
src/app/dashboard/round-view/round-view-client.tsx - Field updates → Server Supabase client: creates client
src/app/dashboard/round-view/actions.ts - Payment screens → Payment operations: calls
src/app/dashboard/payments/payments-client.tsx - Payment operations → Server Supabase client: creates client
src/app/dashboard/payments/actions.ts - Server Supabase client → Supabase: connects to
- Browser Supabase client → Supabase: connects to
- Geocode cache API → Server Supabase client: creates client
src/app/api/geocode-cache/route.ts - Backup API → Admin Supabase client: creates client
src/app/api/backup/route.ts - Staff → Backup API: requests export
src/app/api/backup/route.ts - Run screens → SMS service: sends messages