# rosboyboy/ta-system architecture

> Architecture diagram of the GitHub repository rosboyboy/ta-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/rosboyboy/ta-system
- Repository: https://github.com/rosboyboy/ta-system

## Overview

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: [`src/lib/prisma.ts`](https://github.com/rosboyboy/ta-system/blob/main/src/lib/prisma.ts) (Prisma Data Access), [`src/lib/auth.ts`](https://github.com/rosboyboy/ta-system/blob/main/src/lib/auth.ts) (Authentication), [`src/lib/sms.ts`](https://github.com/rosboyboy/ta-system/blob/main/src/lib/sms.ts) (Notifications), [`src/app/api/travel-order/[id]/route.ts`](https://github.com/rosboyboy/ta-system/blob/main/src/app/api/travel-order/%5Bid%5D/route.ts) (Travel Order API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_workspaces["User Workspaces"]
  node_employee["Employee Workspace<br/>[page.tsx]"]
  node_staff["Staff Workspace<br/>[page.tsx]"]
  node_adminui["Admin Workspace<br/>[page.tsx]"]
  node_accountmanager["Account Manager<br/>[page.tsx]"]
  node_login["Login<br/>[page.tsx]"]
end

subgraph group_requests["TA Workflow"]
  node_wizard["TA Request Wizard"]
  node_map_picker["Destination Picker<br/>[MapPicker.tsx]"]
  node_dynamic_picker["Dynamic Map Picker"]
  node_ta_api["TA Request API<br/>[route.ts]"]
  node_resubmit_api["Resubmit API<br/>[route.ts]"]
  node_approval_api["Approval API<br/>[route.ts]"]
  node_approval_trail["Approval Trail<br/>[ApprovalTrail.tsx]"]
  node_travel_modal["Travel Order Modal"]
  node_travel_api["Travel Order API<br/>[route.ts]"]
  node_docx["Document Generator<br/>[travelOrderDocx.ts]"]
end

subgraph group_admin["Administration"]
  node_account_api["Account Management API<br/>[route.ts]"]
  node_activate_api["Account Activation API<br/>[route.ts]"]
  node_profile_modal["Profile Editor<br/>[ProfileModal.tsx]"]
  node_profile_api["Profile API<br/>[route.ts]"]
  node_audit_api["Audit Log API<br/>[route.ts]"]
end

subgraph group_services["Shared Services"]
  node_auth["Authentication<br/>[auth.ts]"]
  node_database[("Prisma Data Access<br/>[prisma.ts]")]
  node_notify["Notifications<br/>[sms.ts]"]
  node_email["Email Delivery<br/>[email.ts]"]
  node_email_map["Email Map Image<br/>[email-map.ts]"]
  node_address["Address Resolver<br/>[address.ts]"]
  node_overdue["Overdue Check<br/>[route.ts]"]
  node_notifications_api["Notification API<br/>[route.ts]"]
  node_notification_read["Read Notification API<br/>[route.ts]"]
  node_employee_api["Employee Directory API<br/>[route.ts]"]
  node_export["Data Export<br/>[export.ts]"]
  node_date["Date Utilities<br/>[date.ts]"]
end

subgraph group_integrations["External Services"]
  node_map_service[("Supabase Data Service")]
end

node_user(("System User"))

node_user -.->|"signs in"| node_login
node_user -.->|"submits request"| node_wizard
node_wizard -->|"loads picker"| node_dynamic_picker
node_dynamic_picker -->|"loads map"| node_map_picker
node_ta_api -->|"checks session"| node_auth
node_ta_api -->|"creates request"| node_database
node_ta_api -->|"sends notices"| node_notify
node_approval_api -->|"checks session"| node_auth
node_approval_api -->|"reads workflow"| node_database
node_approval_api -->|"sends notices"| node_notify
node_resubmit_api -->|"checks session"| node_auth
node_resubmit_api -->|"updates request"| node_database
node_resubmit_api -->|"sends notice"| node_notify
node_travel_api -->|"checks session"| node_auth
node_travel_api -->|"reads request"| node_database
node_travel_api -->|"generates document"| node_docx
node_travel_modal -->|"uses dates"| node_date
node_account_api -->|"checks session"| node_auth
node_account_api -->|"manages users"| node_database
node_activate_api -->|"checks session"| node_auth
node_activate_api -->|"updates account"| node_database
node_activate_api -->|"sends activation"| node_notify
node_profile_api -->|"checks session"| node_auth
node_profile_api -->|"updates profile"| node_database
node_audit_api -->|"checks session"| node_auth
node_audit_api -->|"reads audit data"| node_database
node_notify -->|"stores notices"| node_database
node_notify -->|"sends email"| node_email
node_notify -->|"builds map image"| node_email_map
node_notify -->|"resolves address"| node_address
node_overdue -->|"checks deadlines"| node_database
node_overdue -->|"sends reminders"| node_notify
node_notifications_api -->|"checks session"| node_auth
node_notifications_api -->|"reads notices"| node_database
node_notification_read -->|"checks session"| node_auth
node_notification_read -->|"marks read"| node_database
node_employee_api -->|"lists employees"| node_database
node_export -->|"uses dates"| node_date
node_approval_trail -.->|"shows approvals"| node_user
node_profile_modal -.->|"updates profile"| node_profile_api
node_travel_modal -.->|"requests document"| node_travel_api

click node_employee "https://github.com/rosboyboy/ta-system/blob/main/src/app/(dashboard)/employee/page.tsx"
click node_staff "https://github.com/rosboyboy/ta-system/blob/main/src/app/(dashboard)/staff/page.tsx"
click node_adminui "https://github.com/rosboyboy/ta-system/blob/main/src/app/(dashboard)/admin/page.tsx"
click node_accountmanager "https://github.com/rosboyboy/ta-system/blob/main/src/app/(dashboard)/account-manager/page.tsx"
click node_login "https://github.com/rosboyboy/ta-system/blob/main/src/app/(auth)/login/page.tsx"
click node_wizard "https://github.com/rosboyboy/ta-system/blob/main/src/components/wizard/TARequestWizard.tsx"
click node_map_picker "https://github.com/rosboyboy/ta-system/blob/main/src/components/map/MapPicker.tsx"
click node_dynamic_picker "https://github.com/rosboyboy/ta-system/blob/main/src/components/map/DynamicMapPicker.tsx"
click node_ta_api "https://github.com/rosboyboy/ta-system/blob/main/src/app/api/ta-requests/route.ts"
click node_resubmit_api "https://github.com/rosboyboy/ta-system/blob/main/src/app/api/ta-requests/%5Bid%5D/resubmit/route.ts"
click node_approval_api "https://github.com/rosboyboy/ta-system/blob/main/src/app/api/approvals/route.ts"
click node_approval_trail "https://github.com/rosboyboy/ta-system/blob/main/src/components/approval-trail/ApprovalTrail.tsx"
click node_travel_modal "https://github.com/rosboyboy/ta-system/blob/main/src/components/travel-order/TravelOrderModal.tsx"
click node_travel_api "https://github.com/rosboyboy/ta-system/blob/main/src/app/api/travel-order/%5Bid%5D/route.ts"
click node_docx "https://github.com/rosboyboy/ta-system/blob/main/src/lib/travelOrderDocx.ts"
click node_account_api "https://github.com/rosboyboy/ta-system/blob/main/src/app/api/account-manager/users/route.ts"
click node_activate_api "https://github.com/rosboyboy/ta-system/blob/main/src/app/api/account-manager/activate/route.ts"
click node_profile_modal "https://github.com/rosboyboy/ta-system/blob/main/src/components/profile/ProfileModal.tsx"
click node_profile_api "https://github.com/rosboyboy/ta-system/blob/main/src/app/api/user/profile/route.ts"
click node_audit_api "https://github.com/rosboyboy/ta-system/blob/main/src/app/api/admin/audit-logs/route.ts"
click node_auth "https://github.com/rosboyboy/ta-system/blob/main/src/lib/auth.ts"
click node_database "https://github.com/rosboyboy/ta-system/blob/main/src/lib/prisma.ts"
click node_notify "https://github.com/rosboyboy/ta-system/blob/main/src/lib/sms.ts"
click node_email "https://github.com/rosboyboy/ta-system/blob/main/src/lib/email.ts"
click node_email_map "https://github.com/rosboyboy/ta-system/blob/main/src/lib/email-map.ts"
click node_address "https://github.com/rosboyboy/ta-system/blob/main/src/utils/address.ts"
click node_overdue "https://github.com/rosboyboy/ta-system/blob/main/src/app/api/cron/check-overdue/route.ts"
click node_notifications_api "https://github.com/rosboyboy/ta-system/blob/main/src/app/api/notifications/route.ts"
click node_notification_read "https://github.com/rosboyboy/ta-system/blob/main/src/app/api/notifications/read/route.ts"
click node_employee_api "https://github.com/rosboyboy/ta-system/blob/main/src/app/api/employees/route.ts"
click node_export "https://github.com/rosboyboy/ta-system/blob/main/src/utils/export.ts"
click node_date "https://github.com/rosboyboy/ta-system/blob/main/src/lib/date.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_employee,node_staff,node_adminui,node_accountmanager,node_login,node_user toneBlue
class node_wizard,node_map_picker,node_dynamic_picker,node_ta_api,node_resubmit_api,node_approval_api,node_approval_trail,node_travel_modal,node_travel_api,node_docx toneAmber
class node_account_api,node_activate_api,node_profile_modal,node_profile_api,node_audit_api toneMint
class node_auth,node_database,node_notify,node_email,node_email_map,node_address,node_overdue,node_notifications_api,node_notification_read,node_employee_api,node_export,node_date toneRose
class node_map_service toneIndigo
```

## Components

### User Workspaces

- [Employee Workspace](https://github.com/rosboyboy/ta-system/blob/main/src/app/(dashboard)/employee/page.tsx): `src/app/(dashboard)/employee/page.tsx`
- [Staff Workspace](https://github.com/rosboyboy/ta-system/blob/main/src/app/(dashboard)/staff/page.tsx): `src/app/(dashboard)/staff/page.tsx`
- [Admin Workspace](https://github.com/rosboyboy/ta-system/blob/main/src/app/(dashboard)/admin/page.tsx): `src/app/(dashboard)/admin/page.tsx`
- [Account Manager](https://github.com/rosboyboy/ta-system/blob/main/src/app/(dashboard)/account-manager/page.tsx): `src/app/(dashboard)/account-manager/page.tsx`
- [Login](https://github.com/rosboyboy/ta-system/blob/main/src/app/(auth)/login/page.tsx): `src/app/(auth)/login/page.tsx`

### TA Workflow

- [TA Request Wizard](https://github.com/rosboyboy/ta-system/blob/main/src/components/wizard/TARequestWizard.tsx): `src/components/wizard/TARequestWizard.tsx`
- [Destination Picker](https://github.com/rosboyboy/ta-system/blob/main/src/components/map/MapPicker.tsx): `src/components/map/MapPicker.tsx`
- [Dynamic Map Picker](https://github.com/rosboyboy/ta-system/blob/main/src/components/map/DynamicMapPicker.tsx): `src/components/map/DynamicMapPicker.tsx`
- [TA Request API](https://github.com/rosboyboy/ta-system/blob/main/src/app/api/ta-requests/route.ts): `src/app/api/ta-requests/route.ts`
- [Resubmit API](https://github.com/rosboyboy/ta-system/blob/main/src/app/api/ta-requests/%5Bid%5D/resubmit/route.ts): `src/app/api/ta-requests/[id]/resubmit/route.ts`
- [Approval API](https://github.com/rosboyboy/ta-system/blob/main/src/app/api/approvals/route.ts): `src/app/api/approvals/route.ts`
- [Approval Trail](https://github.com/rosboyboy/ta-system/blob/main/src/components/approval-trail/ApprovalTrail.tsx): `src/components/approval-trail/ApprovalTrail.tsx`
- [Travel Order Modal](https://github.com/rosboyboy/ta-system/blob/main/src/components/travel-order/TravelOrderModal.tsx): `src/components/travel-order/TravelOrderModal.tsx`
- [Travel Order API](https://github.com/rosboyboy/ta-system/blob/main/src/app/api/travel-order/%5Bid%5D/route.ts): `src/app/api/travel-order/[id]/route.ts`
- [Document Generator](https://github.com/rosboyboy/ta-system/blob/main/src/lib/travelOrderDocx.ts): `src/lib/travelOrderDocx.ts`

### Administration

- [Account Management API](https://github.com/rosboyboy/ta-system/blob/main/src/app/api/account-manager/users/route.ts): `src/app/api/account-manager/users/route.ts`
- [Account Activation API](https://github.com/rosboyboy/ta-system/blob/main/src/app/api/account-manager/activate/route.ts): `src/app/api/account-manager/activate/route.ts`
- [Profile Editor](https://github.com/rosboyboy/ta-system/blob/main/src/components/profile/ProfileModal.tsx): `src/components/profile/ProfileModal.tsx`
- [Profile API](https://github.com/rosboyboy/ta-system/blob/main/src/app/api/user/profile/route.ts): `src/app/api/user/profile/route.ts`
- [Audit Log API](https://github.com/rosboyboy/ta-system/blob/main/src/app/api/admin/audit-logs/route.ts): `src/app/api/admin/audit-logs/route.ts`

### Shared Services

- [Authentication](https://github.com/rosboyboy/ta-system/blob/main/src/lib/auth.ts): `src/lib/auth.ts`
- [Prisma Data Access](https://github.com/rosboyboy/ta-system/blob/main/src/lib/prisma.ts): `src/lib/prisma.ts`
- [Notifications](https://github.com/rosboyboy/ta-system/blob/main/src/lib/sms.ts): `src/lib/sms.ts`
- [Email Delivery](https://github.com/rosboyboy/ta-system/blob/main/src/lib/email.ts): `src/lib/email.ts`
- [Email Map Image](https://github.com/rosboyboy/ta-system/blob/main/src/lib/email-map.ts): `src/lib/email-map.ts`
- [Address Resolver](https://github.com/rosboyboy/ta-system/blob/main/src/utils/address.ts): `src/utils/address.ts`
- [Overdue Check](https://github.com/rosboyboy/ta-system/blob/main/src/app/api/cron/check-overdue/route.ts): `src/app/api/cron/check-overdue/route.ts`
- [Notification API](https://github.com/rosboyboy/ta-system/blob/main/src/app/api/notifications/route.ts): `src/app/api/notifications/route.ts`
- [Read Notification API](https://github.com/rosboyboy/ta-system/blob/main/src/app/api/notifications/read/route.ts): `src/app/api/notifications/read/route.ts`
- [Employee Directory API](https://github.com/rosboyboy/ta-system/blob/main/src/app/api/employees/route.ts): `src/app/api/employees/route.ts`
- [Data Export](https://github.com/rosboyboy/ta-system/blob/main/src/utils/export.ts): `src/utils/export.ts`
- [Date Utilities](https://github.com/rosboyboy/ta-system/blob/main/src/lib/date.ts): `src/lib/date.ts`

### External Services

- **Supabase Data Service**

### Other components

- **System User**

## Connections

- System User → Login: signs in
- System User → TA Request Wizard: submits request
- TA Request Wizard → Dynamic Map Picker: loads picker (evidence: `src/components/wizard/TARequestWizard.tsx`)
- Dynamic Map Picker → Destination Picker: loads map (evidence: `src/components/map/DynamicMapPicker.tsx`)
- TA Request API → Authentication: checks session (evidence: `src/app/api/ta-requests/route.ts`)
- TA Request API → Prisma Data Access: creates request (evidence: `src/app/api/ta-requests/route.ts`)
- TA Request API → Notifications: sends notices (evidence: `src/app/api/ta-requests/route.ts`)
- Approval API → Authentication: checks session (evidence: `src/app/api/approvals/route.ts`)
- Approval API → Prisma Data Access: reads workflow (evidence: `src/app/api/approvals/route.ts`)
- Approval API → Notifications: sends notices (evidence: `src/app/api/approvals/route.ts`)
- Resubmit API → Authentication: checks session (evidence: `src/app/api/ta-requests/[id]/resubmit/route.ts`)
- Resubmit API → Prisma Data Access: updates request (evidence: `src/app/api/ta-requests/[id]/resubmit/route.ts`)
- Resubmit API → Notifications: sends notice (evidence: `src/app/api/ta-requests/[id]/resubmit/route.ts`)
- Travel Order API → Authentication: checks session (evidence: `src/app/api/travel-order/[id]/route.ts`)
- Travel Order API → Prisma Data Access: reads request (evidence: `src/app/api/travel-order/[id]/route.ts`)
- Travel Order API → Document Generator: generates document (evidence: `src/app/api/travel-order/[id]/route.ts`)
- Travel Order Modal → Date Utilities: uses dates (evidence: `src/components/travel-order/TravelOrderModal.tsx`)
- Account Management API → Authentication: checks session (evidence: `src/app/api/account-manager/users/route.ts`)
- Account Management API → Prisma Data Access: manages users (evidence: `src/app/api/account-manager/users/route.ts`)
- Account Activation API → Authentication: checks session (evidence: `src/app/api/account-manager/activate/route.ts`)
- Account Activation API → Prisma Data Access: updates account (evidence: `src/app/api/account-manager/activate/route.ts`)
- Account Activation API → Notifications: sends activation (evidence: `src/app/api/account-manager/activate/route.ts`)
- Profile API → Authentication: checks session (evidence: `src/app/api/user/profile/route.ts`)
- Profile API → Prisma Data Access: updates profile (evidence: `src/app/api/user/profile/route.ts`)
- Audit Log API → Authentication: checks session (evidence: `src/app/api/admin/audit-logs/route.ts`)
- Audit Log API → Prisma Data Access: reads audit data (evidence: `src/app/api/admin/audit-logs/route.ts`)
- Notifications → Prisma Data Access: stores notices (evidence: `src/lib/sms.ts`)
- Notifications → Email Delivery: sends email (evidence: `src/lib/sms.ts`)
- Notifications → Email Map Image: builds map image (evidence: `src/lib/sms.ts`)
- Notifications → Address Resolver: resolves address (evidence: `src/lib/sms.ts`)
- Overdue Check → Prisma Data Access: checks deadlines (evidence: `src/app/api/cron/check-overdue/route.ts`)
- Overdue Check → Notifications: sends reminders (evidence: `src/app/api/cron/check-overdue/route.ts`)
- Notification API → Authentication: checks session (evidence: `src/app/api/notifications/route.ts`)
- Notification API → Prisma Data Access: reads notices (evidence: `src/app/api/notifications/route.ts`)
- Read Notification API → Authentication: checks session (evidence: `src/app/api/notifications/read/route.ts`)
- Read Notification API → Prisma Data Access: marks read (evidence: `src/app/api/notifications/read/route.ts`)
- Employee Directory API → Prisma Data Access: lists employees (evidence: `src/app/api/employees/route.ts`)
- Data Export → Date Utilities: uses dates (evidence: `src/utils/export.ts`)
- Approval Trail → System User: shows approvals
- Profile Editor → Profile API: updates profile
- Travel Order Modal → Travel Order API: requests document
