# yowpaull/csd-monitoring architecture

> Architecture diagram of the GitHub repository yowpaull/csd-monitoring, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yowpaull/csd-monitoring
- Repository: https://github.com/yowpaull/csd-monitoring

## Overview

This is a Next.js inquiry-management application with representative and administrator workflows. Representatives sign in, file inquiries, review their own or the shared open pool, and export logs; administrators also manage reference data and team members and review dashboard metrics. The graph includes the shared log-query, formatting, and export layer. Several route pages and query implementations were not excerpted, so their internal calls and database reads are not asserted; edges shown are limited to relationships visible in the source index or excerpts.

Main entry points: [`src/lib/supabase/server.ts`](https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/supabase/server.ts) (Server Supabase Client), [`src/lib/actions/auth.ts`](https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/actions/auth.ts) (Authentication Actions), [`src/components/inquiry-logs/LogRowModals.tsx`](https://github.com/yowpaull/csd-monitoring/blob/main/src/components/inquiry-logs/LogRowModals.tsx) (Log Detail Modals), [`src/lib/queries/admin-dashboard.ts`](https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/queries/admin-dashboard.ts) (Dashboard Metrics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and Shell"]
  node_signin["Sign-in Page<br/>[page.tsx]"]
  node_auth_actions["Authentication Actions<br/>[auth.ts]"]
  node_app_shell["Application Shell<br/>[AppShell.tsx]"]
  node_profile["Profile View<br/>[ProfileView.tsx]"]
end

subgraph group_inquiries["Inquiry Operations"]
  node_log_form["Inquiry Entry Form<br/>[LogForm.tsx]"]
  node_log_actions["Inquiry Actions<br/>[log.ts]"]
  node_log_list["Inquiry Log Views"]
  node_row_modals["Log Detail Modals<br/>[LogRowModals.tsx]"]
  node_export_routes["Log Export Routes<br/>[route.ts]"]
end

subgraph group_admin["Administration"]
  node_admin_dashboard["Dashboard Page<br/>[page.tsx]"]
  node_dashboard_charts["Dashboard Charts"]
  node_dashboard_queries["Dashboard Metrics<br/>[admin-dashboard.ts]"]
  node_brands["Brand Management<br/>[BrandsClient.tsx]"]
  node_brand_actions["Brand Actions<br/>[brand.ts]"]
  node_platforms["Platform Management"]
  node_platform_actions["Platform Actions<br/>[platform.ts]"]
  node_categories["Category Management"]
  node_category_actions["Category Actions"]
  node_team_page["Team Management<br/>[page.tsx]"]
  node_add_member["Add Team Member<br/>[AddMember.tsx]"]
  node_member_actions["Member Controls<br/>[MemberActions.tsx]"]
end

subgraph group_shared["Shared Services"]
  node_supabase_server["Server Supabase Client<br/>[server.ts]"]
  node_log_helpers["Log Filters and Formatting<br/>[inquiry-log.ts]"]
  node_log_queries["Inquiry Log Queries<br/>[inquiry-logs.ts]"]
  node_export_service["Workbook Export"]
  node_profile_queries["Profile Queries<br/>[profile.ts]"]
end

node_user(("Representative"))
node_admin_actor(("Administrator"))
node_supabase[("Supabase")]

node_user -->|"opens"| node_signin
node_signin -->|"submits to"| node_auth_actions
node_admin_actor -->|"manages team"| node_team_page
node_log_form -->|"submits to"| node_log_actions
node_log_list -->|"opens"| node_row_modals
node_row_modals -->|"invokes"| node_log_actions
node_row_modals -->|"uses"| node_log_form
node_log_list -->|"uses"| node_log_helpers
node_row_modals -->|"uses"| node_log_helpers
node_export_routes -->|"delegates to"| node_export_service
node_export_service -->|"fetches rows"| node_log_queries
node_export_service -->|"formats with"| node_log_helpers
node_admin_dashboard -->|"loads metrics"| node_dashboard_queries
node_admin_dashboard -->|"renders"| node_dashboard_charts
node_dashboard_queries -->|"queries logs"| node_log_queries
node_dashboard_queries -->|"checks role"| node_auth_actions
node_brands -->|"invokes"| node_brand_actions
node_platforms -->|"invokes"| node_platform_actions
node_categories -->|"invokes"| node_category_actions
node_team_page -->|"renders"| node_add_member
node_team_page -->|"renders"| node_member_actions
node_add_member -->|"invokes"| node_auth_actions
node_member_actions -->|"invokes"| node_auth_actions
node_profile -->|"invokes"| node_auth_actions
node_profile -->|"loads data"| node_profile_queries
node_auth_actions -->|"creates client"| node_supabase_server
node_log_actions -->|"creates client"| node_supabase_server
node_brand_actions -->|"creates client"| node_supabase_server
node_platform_actions -->|"creates client"| node_supabase_server
node_category_actions -->|"creates client"| node_supabase_server
node_dashboard_queries -->|"creates client"| node_supabase_server
node_profile_queries -->|"creates client"| node_supabase_server
node_supabase_server -->|"connects to"| node_supabase

click node_signin "https://github.com/yowpaull/csd-monitoring/blob/main/src/app/page.tsx"
click node_auth_actions "https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/actions/auth.ts"
click node_app_shell "https://github.com/yowpaull/csd-monitoring/blob/main/src/components/layout/AppShell.tsx"
click node_supabase_server "https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/supabase/server.ts"
click node_log_form "https://github.com/yowpaull/csd-monitoring/blob/main/src/app/user/log/LogForm.tsx"
click node_log_actions "https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/actions/log.ts"
click node_log_list "https://github.com/yowpaull/csd-monitoring/blob/main/src/components/inquiry-logs/InquiryLogsView.tsx"
click node_row_modals "https://github.com/yowpaull/csd-monitoring/blob/main/src/components/inquiry-logs/LogRowModals.tsx"
click node_log_helpers "https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/inquiry-log.ts"
click node_log_queries "https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/queries/inquiry-logs.ts"
click node_export_routes "https://github.com/yowpaull/csd-monitoring/blob/main/src/app/user/logs/export/route.ts"
click node_export_service "https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/inquiry-log-export.ts"
click node_admin_dashboard "https://github.com/yowpaull/csd-monitoring/blob/main/src/app/admin/dashboard/page.tsx"
click node_dashboard_charts "https://github.com/yowpaull/csd-monitoring/blob/main/src/app/admin/dashboard/DashboardCharts.tsx"
click node_dashboard_queries "https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/queries/admin-dashboard.ts"
click node_brands "https://github.com/yowpaull/csd-monitoring/blob/main/src/app/admin/brands/BrandsClient.tsx"
click node_brand_actions "https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/actions/brand.ts"
click node_platforms "https://github.com/yowpaull/csd-monitoring/blob/main/src/app/admin/platforms/PlatformsClient.tsx"
click node_platform_actions "https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/actions/platform.ts"
click node_categories "https://github.com/yowpaull/csd-monitoring/blob/main/src/app/admin/inquiry-types/InquiryCategoriesClient.tsx"
click node_category_actions "https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/actions/inquiry-categories.ts"
click node_team_page "https://github.com/yowpaull/csd-monitoring/blob/main/src/app/admin/team/page.tsx"
click node_add_member "https://github.com/yowpaull/csd-monitoring/blob/main/src/app/admin/team/components/AddMember.tsx"
click node_member_actions "https://github.com/yowpaull/csd-monitoring/blob/main/src/app/admin/team/components/MemberActions.tsx"
click node_profile "https://github.com/yowpaull/csd-monitoring/blob/main/src/components/profile/ProfileView.tsx"
click node_profile_queries "https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/queries/profile.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_signin,node_auth_actions,node_app_shell,node_profile toneBlue
class node_log_form,node_log_actions,node_log_list,node_row_modals,node_export_routes,node_supabase toneAmber
class node_admin_dashboard,node_dashboard_charts,node_dashboard_queries,node_brands,node_brand_actions,node_platforms,node_platform_actions,node_categories,node_category_actions,node_team_page,node_add_member,node_member_actions toneMint
class node_supabase_server,node_log_helpers,node_log_queries,node_export_service,node_profile_queries toneRose
class node_user,node_admin_actor toneIndigo
```

## Components

### Access and Shell

- [Sign-in Page](https://github.com/yowpaull/csd-monitoring/blob/main/src/app/page.tsx): `src/app/page.tsx`
- [Authentication Actions](https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/actions/auth.ts): `src/lib/actions/auth.ts`
- [Application Shell](https://github.com/yowpaull/csd-monitoring/blob/main/src/components/layout/AppShell.tsx): `src/components/layout/AppShell.tsx`
- [Profile View](https://github.com/yowpaull/csd-monitoring/blob/main/src/components/profile/ProfileView.tsx): `src/components/profile/ProfileView.tsx`

### Inquiry Operations

- [Inquiry Entry Form](https://github.com/yowpaull/csd-monitoring/blob/main/src/app/user/log/LogForm.tsx): `src/app/user/log/LogForm.tsx`
- [Inquiry Actions](https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/actions/log.ts): `src/lib/actions/log.ts`
- [Inquiry Log Views](https://github.com/yowpaull/csd-monitoring/blob/main/src/components/inquiry-logs/InquiryLogsView.tsx): `src/components/inquiry-logs/InquiryLogsView.tsx`
- [Log Detail Modals](https://github.com/yowpaull/csd-monitoring/blob/main/src/components/inquiry-logs/LogRowModals.tsx): `src/components/inquiry-logs/LogRowModals.tsx`
- [Log Export Routes](https://github.com/yowpaull/csd-monitoring/blob/main/src/app/user/logs/export/route.ts): `src/app/user/logs/export/route.ts`

### Administration

- [Dashboard Page](https://github.com/yowpaull/csd-monitoring/blob/main/src/app/admin/dashboard/page.tsx): `src/app/admin/dashboard/page.tsx`
- [Dashboard Charts](https://github.com/yowpaull/csd-monitoring/blob/main/src/app/admin/dashboard/DashboardCharts.tsx): `src/app/admin/dashboard/DashboardCharts.tsx`
- [Dashboard Metrics](https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/queries/admin-dashboard.ts): `src/lib/queries/admin-dashboard.ts`
- [Brand Management](https://github.com/yowpaull/csd-monitoring/blob/main/src/app/admin/brands/BrandsClient.tsx): `src/app/admin/brands/BrandsClient.tsx`
- [Brand Actions](https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/actions/brand.ts): `src/lib/actions/brand.ts`
- [Platform Management](https://github.com/yowpaull/csd-monitoring/blob/main/src/app/admin/platforms/PlatformsClient.tsx): `src/app/admin/platforms/PlatformsClient.tsx`
- [Platform Actions](https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/actions/platform.ts): `src/lib/actions/platform.ts`
- [Category Management](https://github.com/yowpaull/csd-monitoring/blob/main/src/app/admin/inquiry-types/InquiryCategoriesClient.tsx): `src/app/admin/inquiry-types/InquiryCategoriesClient.tsx`
- [Category Actions](https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/actions/inquiry-categories.ts): `src/lib/actions/inquiry-categories.ts`
- [Team Management](https://github.com/yowpaull/csd-monitoring/blob/main/src/app/admin/team/page.tsx): `src/app/admin/team/page.tsx`
- [Add Team Member](https://github.com/yowpaull/csd-monitoring/blob/main/src/app/admin/team/components/AddMember.tsx): `src/app/admin/team/components/AddMember.tsx`
- [Member Controls](https://github.com/yowpaull/csd-monitoring/blob/main/src/app/admin/team/components/MemberActions.tsx): `src/app/admin/team/components/MemberActions.tsx`

### Shared Services

- [Server Supabase Client](https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/supabase/server.ts): `src/lib/supabase/server.ts`
- [Log Filters and Formatting](https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/inquiry-log.ts): `src/lib/inquiry-log.ts`
- [Inquiry Log Queries](https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/queries/inquiry-logs.ts): `src/lib/queries/inquiry-logs.ts`
- [Workbook Export](https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/inquiry-log-export.ts): `src/lib/inquiry-log-export.ts`
- [Profile Queries](https://github.com/yowpaull/csd-monitoring/blob/main/src/lib/queries/profile.ts): `src/lib/queries/profile.ts`

### Other components

- **Representative**
- **Administrator**
- **Supabase**

## Connections

- Representative → Sign-in Page: opens (evidence: `src/app/page.tsx`)
- Sign-in Page → Authentication Actions: submits to (evidence: `src/app/page.tsx`)
- Administrator → Team Management: manages team (evidence: `src/app/admin/team/page.tsx`)
- Inquiry Entry Form → Inquiry Actions: submits to (evidence: `src/app/user/log/LogForm.tsx`)
- Inquiry Log Views → Log Detail Modals: opens (evidence: `src/components/inquiry-logs/InquiryLogsView.tsx`)
- Log Detail Modals → Inquiry Actions: invokes (evidence: `src/components/inquiry-logs/LogRowModals.tsx`)
- Log Detail Modals → Inquiry Entry Form: uses (evidence: `src/components/inquiry-logs/LogRowModals.tsx`)
- Inquiry Log Views → Log Filters and Formatting: uses (evidence: `src/components/inquiry-logs/InquiryLogsView.tsx`)
- Log Detail Modals → Log Filters and Formatting: uses (evidence: `src/components/inquiry-logs/LogRowModals.tsx`)
- Log Export Routes → Workbook Export: delegates to (evidence: `src/app/user/logs/export/route.ts`)
- Workbook Export → Inquiry Log Queries: fetches rows (evidence: `src/lib/inquiry-log-export.ts`)
- Workbook Export → Log Filters and Formatting: formats with (evidence: `src/lib/inquiry-log-export.ts`)
- Dashboard Page → Dashboard Metrics: loads metrics (evidence: `src/app/admin/dashboard/page.tsx`)
- Dashboard Page → Dashboard Charts: renders (evidence: `src/app/admin/dashboard/page.tsx`)
- Dashboard Metrics → Inquiry Log Queries: queries logs (evidence: `src/lib/queries/admin-dashboard.ts`)
- Dashboard Metrics → Authentication Actions: checks role (evidence: `src/lib/queries/admin-dashboard.ts`)
- Brand Management → Brand Actions: invokes (evidence: `src/app/admin/brands/BrandsClient.tsx`)
- Platform Management → Platform Actions: invokes (evidence: `src/app/admin/platforms/PlatformsClient.tsx`)
- Category Management → Category Actions: invokes (evidence: `src/app/admin/inquiry-types/InquiryCategoriesClient.tsx`)
- Team Management → Add Team Member: renders (evidence: `src/app/admin/team/page.tsx`)
- Team Management → Member Controls: renders (evidence: `src/app/admin/team/page.tsx`)
- Add Team Member → Authentication Actions: invokes (evidence: `src/app/admin/team/components/AddMember.tsx`)
- Member Controls → Authentication Actions: invokes (evidence: `src/app/admin/team/components/MemberActions.tsx`)
- Profile View → Authentication Actions: invokes (evidence: `src/components/profile/ProfileView.tsx`)
- Profile View → Profile Queries: loads data (evidence: `src/components/profile/ProfileView.tsx`)
- Authentication Actions → Server Supabase Client: creates client (evidence: `src/lib/actions/auth.ts`)
- Inquiry Actions → Server Supabase Client: creates client (evidence: `src/lib/actions/log.ts`)
- Brand Actions → Server Supabase Client: creates client (evidence: `src/lib/actions/brand.ts`)
- Platform Actions → Server Supabase Client: creates client (evidence: `src/lib/actions/platform.ts`)
- Category Actions → Server Supabase Client: creates client (evidence: `src/lib/actions/inquiry-categories.ts`)
- Dashboard Metrics → Server Supabase Client: creates client (evidence: `src/lib/queries/admin-dashboard.ts`)
- Profile Queries → Server Supabase Client: creates client (evidence: `src/lib/queries/profile.ts`)
- Server Supabase Client → Supabase: connects to (evidence: `src/lib/supabase/server.ts`)
