How rosboyboy/ta-system works
TAPS is a role-based travel-authority request and approval system. Its principal workflow is an employee submitting a TA request, successive reviewers acting on it, and notifications informing the employee and next approver; approved requests can also produce travel-order documents. Separate workspaces support employees, approvers, administrators, and account managers, alongside profile management, destination mapping, audit history, and overdue checks. The API, notification, document, and UI links shown below are supported by excerpts or the source index; dashboard-to-API wiring is not shown, so those links are omitted.
Main entry points: prisma.ts Prisma Data Access · auth.ts Authentication · sms.ts Notifications · route.ts Travel Order API
Components 34
User Workspaces
- Employee Workspace
src/app/(dashboard)/employee/page.tsx - Staff Workspace
src/app/(dashboard)/staff/page.tsx - Admin Workspace
src/app/(dashboard)/admin/page.tsx - Account Manager
src/app/(dashboard)/account-manager/page.tsx - Login
src/app/(auth)/login/page.tsx
TA Workflow
- TA Request Wizard
src/components/wizard/TARequestWizard.tsx - Destination Picker
src/components/map/MapPicker.tsx - Dynamic Map Picker
src/components/map/DynamicMapPicker.tsx - TA Request API
src/app/api/ta-requests/route.ts - Resubmit API
src/app/api/ta-requests/[id]/resubmit/route.ts - Approval API
src/app/api/approvals/route.ts - Approval Trail
src/components/approval-trail/ApprovalTrail.tsx - Travel Order Modal
src/components/travel-order/TravelOrderModal.tsx - Travel Order API
src/app/api/travel-order/[id]/route.ts - Document Generator
src/lib/travelOrderDocx.ts
Administration
- Account Management API
src/app/api/account-manager/users/route.ts - Account Activation API
src/app/api/account-manager/activate/route.ts - Profile Editor
src/components/profile/ProfileModal.tsx - Profile API
src/app/api/user/profile/route.ts - Audit Log API
src/app/api/admin/audit-logs/route.ts
Shared Services
- Authentication
src/lib/auth.ts - Prisma Data Access
src/lib/prisma.ts - Notifications
src/lib/sms.ts - Email Delivery
src/lib/email.ts - Email Map Image
src/lib/email-map.ts - Address Resolver
src/utils/address.ts - Overdue Check
src/app/api/cron/check-overdue/route.ts - Notification API
src/app/api/notifications/route.ts - Read Notification API
src/app/api/notifications/read/route.ts - Employee Directory API
src/app/api/employees/route.ts - Data Export
src/utils/export.ts - Date Utilities
src/lib/date.ts
External Services
- Supabase Data Service
Other components
- System User
Connections 41
- System User → Login: signs in
- System User → TA Request Wizard: submits request
- TA Request Wizard → Dynamic Map Picker: loads picker
src/components/wizard/TARequestWizard.tsx - Dynamic Map Picker → Destination Picker: loads map
src/components/map/DynamicMapPicker.tsx - TA Request API → Authentication: checks session
src/app/api/ta-requests/route.ts - TA Request API → Prisma Data Access: creates request
src/app/api/ta-requests/route.ts - TA Request API → Notifications: sends notices
src/app/api/ta-requests/route.ts - Approval API → Authentication: checks session
src/app/api/approvals/route.ts - Approval API → Prisma Data Access: reads workflow
src/app/api/approvals/route.ts - Approval API → Notifications: sends notices
src/app/api/approvals/route.ts - Resubmit API → Authentication: checks session
src/app/api/ta-requests/[id]/resubmit/route.ts - Resubmit API → Prisma Data Access: updates request
src/app/api/ta-requests/[id]/resubmit/route.ts - Resubmit API → Notifications: sends notice
src/app/api/ta-requests/[id]/resubmit/route.ts - Travel Order API → Authentication: checks session
src/app/api/travel-order/[id]/route.ts - Travel Order API → Prisma Data Access: reads request
src/app/api/travel-order/[id]/route.ts - Travel Order API → Document Generator: generates document
src/app/api/travel-order/[id]/route.ts - Travel Order Modal → Date Utilities: uses dates
src/components/travel-order/TravelOrderModal.tsx - Account Management API → Authentication: checks session
src/app/api/account-manager/users/route.ts - Account Management API → Prisma Data Access: manages users
src/app/api/account-manager/users/route.ts - Account Activation API → Authentication: checks session
src/app/api/account-manager/activate/route.ts - Account Activation API → Prisma Data Access: updates account
src/app/api/account-manager/activate/route.ts - Account Activation API → Notifications: sends activation
src/app/api/account-manager/activate/route.ts - Profile API → Authentication: checks session
src/app/api/user/profile/route.ts - Profile API → Prisma Data Access: updates profile
src/app/api/user/profile/route.ts - Audit Log API → Authentication: checks session
src/app/api/admin/audit-logs/route.ts - Audit Log API → Prisma Data Access: reads audit data
src/app/api/admin/audit-logs/route.ts - Notifications → Prisma Data Access: stores notices
src/lib/sms.ts - Notifications → Email Delivery: sends email
src/lib/sms.ts - Notifications → Email Map Image: builds map image
src/lib/sms.ts - Notifications → Address Resolver: resolves address
src/lib/sms.ts - Overdue Check → Prisma Data Access: checks deadlines
src/app/api/cron/check-overdue/route.ts - Overdue Check → Notifications: sends reminders
src/app/api/cron/check-overdue/route.ts - Notification API → Authentication: checks session
src/app/api/notifications/route.ts - Notification API → Prisma Data Access: reads notices
src/app/api/notifications/route.ts - Read Notification API → Authentication: checks session
src/app/api/notifications/read/route.ts - Read Notification API → Prisma Data Access: marks read
src/app/api/notifications/read/route.ts - Employee Directory API → Prisma Data Access: lists employees
src/app/api/employees/route.ts - Data Export → Date Utilities: uses dates
src/utils/export.ts - Approval Trail → System User: shows approvals
- Profile Editor → Profile API: updates profile
- Travel Order Modal → Travel Order API: requests document