# akashrrrrd/followthru architecture

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

- Interactive diagram: https://gitdiagram.com/akashrrrrd/followthru
- Repository: https://github.com/akashrrrrd/followthru

## Overview

FollowThru turns meeting transcripts into reviewed, date-resolved commitments, then tracks their status and continuity across meetings. Users submit transcripts through the meeting workflow; the extraction route invokes AI extraction, validates and links results, and persists meetings, tasks, and history in Supabase. Dashboard, meeting, profile, and insights views support ongoing accountability, while a scheduled route sends reminders. The README documents additional review and analytics capabilities; several UI-to-route connections and unsampled subsystems are therefore shown only where documented or left out.

Main entry points: [`app/api/meetings/extract/route.ts`](https://github.com/akashrrrrd/followthru/blob/main/app/api/meetings/extract/route.ts) (Meeting extraction), [`lib/supabase-server.ts`](https://github.com/akashrrrrd/followthru/blob/main/lib/supabase-server.ts) (Server database client), [`app/api/tasks/[id]/route.ts`](https://github.com/akashrrrrd/followthru/blob/main/app/api/tasks/%5Bid%5D/route.ts) (Task updates), [`app/api/tasks/route.ts`](https://github.com/akashrrrrd/followthru/blob/main/app/api/tasks/route.ts) (Task operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["User experience"]
  node_new_meeting["Transcript entry<br/>[page.tsx]"]
  node_meeting_pages["Meeting views<br/>[page.tsx]"]
  node_meeting_detail["Meeting detail<br/>[page.tsx]"]
  node_dashboard["Accountability dashboard<br/>[page.tsx]"]
  node_insights_page["Insights view<br/>[page.tsx]"]
  node_profile_page["Profile settings<br/>[page.tsx]"]
end

subgraph group_processing["Commitment processing"]
  node_extract_route["Meeting extraction<br/>[route.ts]"]
  node_groq["AI extraction<br/>[groq.ts]"]
  node_date_resolution["Date resolution<br/>[date-resolver.ts]"]
  node_pipeline_validation["Pipeline validation"]
  node_continuity_linking["Continuity linking"]
  node_error_logging["Pipeline rejection logging"]
end

subgraph group_accountability["Tracking and insights"]
  node_task_api["Task operations<br/>[route.ts]"]
  node_task_detail_api["Task updates<br/>[route.ts]"]
  node_meeting_api["Meeting operations<br/>[route.ts]"]
  node_insights_api["Insights data<br/>[route.ts]"]
  node_reminders["Scheduled reminders<br/>[route.ts]"]
  node_lifecycle["Task lifecycle rules<br/>[lifecycle.ts]"]
  node_overdue["Overdue detection<br/>[overdue.ts]"]
  node_history["Commitment history<br/>[history.ts]"]
end

subgraph group_platform["Identity and services"]
  node_auth_ui["Auth provider<br/>[auth-provider.tsx]"]
  node_auth_fetch["Authenticated fetch<br/>[use-auth-fetch.ts]"]
  node_email["Email provider<br/>[email-provider.ts]"]
  node_server_client["Server database client<br/>[supabase-server.ts]"]
  node_database[("Supabase database")]
  node_client_auth["Supabase client<br/>[supabase-client.ts]"]
end

node_user(("Team member"))
node_supabase_auth["Supabase Auth"]

node_user -->|"submits transcript"| node_new_meeting
node_new_meeting -.->|"requests extraction"| node_extract_route
node_extract_route -->|"extracts commitments"| node_groq
node_extract_route -->|"resolves dates"| node_date_resolution
node_extract_route -->|"validates stages"| node_pipeline_validation
node_extract_route -->|"links commitments"| node_continuity_linking
node_extract_route -->|"logs rejections"| node_error_logging
node_extract_route -->|"creates client"| node_server_client
node_extract_route -->|"writes meeting and tasks"| node_database
node_continuity_linking -->|"saves continuity events"| node_database
node_user -->|"signs in"| node_auth_ui
node_auth_ui -->|"reads auth session"| node_client_auth
node_client_auth -->|"authenticates"| node_supabase_auth
node_auth_fetch -->|"reads access token"| node_client_auth
node_dashboard -->|"fetches protected data"| node_auth_fetch
node_dashboard -.->|"loads task data"| node_task_api
node_meeting_pages -.->|"loads meetings"| node_meeting_api
node_meeting_detail -.->|"updates commitments"| node_task_detail_api
node_insights_page -.->|"loads analytics"| node_insights_api
node_profile_page -.->|"requests profile data"| node_server_client
node_task_api -->|"creates client"| node_server_client
node_task_api -->|"checks overdue tasks"| node_overdue
node_task_api -.->|"reads and writes tasks"| node_database
node_task_detail_api -->|"creates client"| node_server_client
node_task_detail_api -->|"applies status rules"| node_lifecycle
node_task_detail_api -->|"records changes"| node_history
node_task_detail_api -.->|"updates tasks"| node_database
node_meeting_api -->|"creates client"| node_server_client
node_meeting_api -->|"checks overdue tasks"| node_overdue
node_meeting_api -.->|"reads meetings"| node_database
node_insights_api -->|"creates client"| node_server_client
node_insights_api -->|"checks overdue tasks"| node_overdue
node_insights_api -.->|"reads analytics data"| node_database
node_reminders -->|"creates client"| node_server_client
node_reminders -->|"sends reminders"| node_email
node_reminders -.->|"reads reminder tasks"| node_database
node_server_client -->|"connects to"| node_database

click node_new_meeting "https://github.com/akashrrrrd/followthru/blob/main/app/new/page.tsx"
click node_meeting_pages "https://github.com/akashrrrrd/followthru/blob/main/app/meetings/page.tsx"
click node_meeting_detail "https://github.com/akashrrrrd/followthru/blob/main/app/meetings/%5Bid%5D/page.tsx"
click node_dashboard "https://github.com/akashrrrrd/followthru/blob/main/app/dashboard/page.tsx"
click node_insights_page "https://github.com/akashrrrrd/followthru/blob/main/app/insights/page.tsx"
click node_profile_page "https://github.com/akashrrrrd/followthru/blob/main/app/profile/page.tsx"
click node_auth_ui "https://github.com/akashrrrrd/followthru/blob/main/components/auth-provider.tsx"
click node_auth_fetch "https://github.com/akashrrrrd/followthru/blob/main/hooks/use-auth-fetch.ts"
click node_extract_route "https://github.com/akashrrrrd/followthru/blob/main/app/api/meetings/extract/route.ts"
click node_groq "https://github.com/akashrrrrd/followthru/blob/main/lib/groq.ts"
click node_date_resolution "https://github.com/akashrrrrd/followthru/blob/main/lib/date-resolver.ts"
click node_pipeline_validation "https://github.com/akashrrrrd/followthru/blob/main/lib/pipeline-validator.ts"
click node_continuity_linking "https://github.com/akashrrrrd/followthru/blob/main/lib/commitment-linker.ts"
click node_error_logging "https://github.com/akashrrrrd/followthru/blob/main/lib/pipeline-error-handler.ts"
click node_task_api "https://github.com/akashrrrrd/followthru/blob/main/app/api/tasks/route.ts"
click node_task_detail_api "https://github.com/akashrrrrd/followthru/blob/main/app/api/tasks/%5Bid%5D/route.ts"
click node_meeting_api "https://github.com/akashrrrrd/followthru/blob/main/app/api/meetings/route.ts"
click node_insights_api "https://github.com/akashrrrrd/followthru/blob/main/app/api/insights/route.ts"
click node_reminders "https://github.com/akashrrrrd/followthru/blob/main/app/api/cron/reminders/route.ts"
click node_email "https://github.com/akashrrrrd/followthru/blob/main/lib/email-provider.ts"
click node_server_client "https://github.com/akashrrrrd/followthru/blob/main/lib/supabase-server.ts"
click node_lifecycle "https://github.com/akashrrrrd/followthru/blob/main/lib/lifecycle.ts"
click node_overdue "https://github.com/akashrrrrd/followthru/blob/main/lib/overdue.ts"
click node_history "https://github.com/akashrrrrd/followthru/blob/main/lib/history.ts"
click node_client_auth "https://github.com/akashrrrrd/followthru/blob/main/lib/supabase-client.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_new_meeting,node_meeting_pages,node_meeting_detail,node_dashboard,node_insights_page,node_profile_page toneBlue
class node_extract_route,node_groq,node_date_resolution,node_pipeline_validation,node_continuity_linking,node_error_logging toneAmber
class node_task_api,node_task_detail_api,node_meeting_api,node_insights_api,node_reminders,node_lifecycle,node_overdue,node_history toneMint
class node_auth_ui,node_auth_fetch,node_email,node_server_client,node_database,node_client_auth toneRose
class node_user,node_supabase_auth toneIndigo
```

## Components

### User experience

- [Transcript entry](https://github.com/akashrrrrd/followthru/blob/main/app/new/page.tsx): `app/new/page.tsx`
- [Meeting views](https://github.com/akashrrrrd/followthru/blob/main/app/meetings/page.tsx): `app/meetings/page.tsx`
- [Meeting detail](https://github.com/akashrrrrd/followthru/blob/main/app/meetings/%5Bid%5D/page.tsx): `app/meetings/[id]/page.tsx`
- [Accountability dashboard](https://github.com/akashrrrrd/followthru/blob/main/app/dashboard/page.tsx): `app/dashboard/page.tsx`
- [Insights view](https://github.com/akashrrrrd/followthru/blob/main/app/insights/page.tsx): `app/insights/page.tsx`
- [Profile settings](https://github.com/akashrrrrd/followthru/blob/main/app/profile/page.tsx): `app/profile/page.tsx`

### Commitment processing

- [Meeting extraction](https://github.com/akashrrrrd/followthru/blob/main/app/api/meetings/extract/route.ts): `app/api/meetings/extract/route.ts`
- [AI extraction](https://github.com/akashrrrrd/followthru/blob/main/lib/groq.ts): `lib/groq.ts`
- [Date resolution](https://github.com/akashrrrrd/followthru/blob/main/lib/date-resolver.ts): `lib/date-resolver.ts`
- [Pipeline validation](https://github.com/akashrrrrd/followthru/blob/main/lib/pipeline-validator.ts): `lib/pipeline-validator.ts`
- [Continuity linking](https://github.com/akashrrrrd/followthru/blob/main/lib/commitment-linker.ts): `lib/commitment-linker.ts`
- [Pipeline rejection logging](https://github.com/akashrrrrd/followthru/blob/main/lib/pipeline-error-handler.ts): `lib/pipeline-error-handler.ts`

### Tracking and insights

- [Task operations](https://github.com/akashrrrrd/followthru/blob/main/app/api/tasks/route.ts): `app/api/tasks/route.ts`
- [Task updates](https://github.com/akashrrrrd/followthru/blob/main/app/api/tasks/%5Bid%5D/route.ts): `app/api/tasks/[id]/route.ts`
- [Meeting operations](https://github.com/akashrrrrd/followthru/blob/main/app/api/meetings/route.ts): `app/api/meetings/route.ts`
- [Insights data](https://github.com/akashrrrrd/followthru/blob/main/app/api/insights/route.ts): `app/api/insights/route.ts`
- [Scheduled reminders](https://github.com/akashrrrrd/followthru/blob/main/app/api/cron/reminders/route.ts): `app/api/cron/reminders/route.ts`
- [Task lifecycle rules](https://github.com/akashrrrrd/followthru/blob/main/lib/lifecycle.ts): `lib/lifecycle.ts`
- [Overdue detection](https://github.com/akashrrrrd/followthru/blob/main/lib/overdue.ts): `lib/overdue.ts`
- [Commitment history](https://github.com/akashrrrrd/followthru/blob/main/lib/history.ts): `lib/history.ts`

### Identity and services

- [Auth provider](https://github.com/akashrrrrd/followthru/blob/main/components/auth-provider.tsx): `components/auth-provider.tsx`
- [Authenticated fetch](https://github.com/akashrrrrd/followthru/blob/main/hooks/use-auth-fetch.ts): `hooks/use-auth-fetch.ts`
- [Email provider](https://github.com/akashrrrrd/followthru/blob/main/lib/email-provider.ts): `lib/email-provider.ts`
- [Server database client](https://github.com/akashrrrrd/followthru/blob/main/lib/supabase-server.ts): `lib/supabase-server.ts`
- **Supabase database**
- [Supabase client](https://github.com/akashrrrrd/followthru/blob/main/lib/supabase-client.ts): `lib/supabase-client.ts`

### Other components

- **Team member**
- **Supabase Auth**

## Connections

- Team member → Transcript entry: submits transcript (evidence: `README.md`)
- Transcript entry → Meeting extraction: requests extraction
- Meeting extraction → AI extraction: extracts commitments (evidence: `app/api/meetings/extract/route.ts`)
- Meeting extraction → Date resolution: resolves dates (evidence: `app/api/meetings/extract/route.ts`)
- Meeting extraction → Pipeline validation: validates stages (evidence: `app/api/meetings/extract/route.ts`)
- Meeting extraction → Continuity linking: links commitments (evidence: `app/api/meetings/extract/route.ts`)
- Meeting extraction → Pipeline rejection logging: logs rejections (evidence: `app/api/meetings/extract/route.ts`)
- Meeting extraction → Server database client: creates client (evidence: `app/api/meetings/extract/route.ts`)
- Meeting extraction → Supabase database: writes meeting and tasks (evidence: `app/api/meetings/extract/route.ts`)
- Continuity linking → Supabase database: saves continuity events
- Team member → Auth provider: signs in (evidence: `components/auth-provider.tsx`)
- Auth provider → Supabase client: reads auth session (evidence: `components/auth-provider.tsx`)
- Supabase client → Supabase Auth: authenticates
- Authenticated fetch → Supabase client: reads access token (evidence: `hooks/use-auth-fetch.ts`)
- Accountability dashboard → Authenticated fetch: fetches protected data (evidence: `app/dashboard/page.tsx`)
- Accountability dashboard → Task operations: loads task data
- Meeting views → Meeting operations: loads meetings
- Meeting detail → Task updates: updates commitments
- Insights view → Insights data: loads analytics
- Profile settings → Server database client: requests profile data
- Task operations → Server database client: creates client (evidence: `app/api/tasks/route.ts`)
- Task operations → Overdue detection: checks overdue tasks (evidence: `app/api/tasks/route.ts`)
- Task operations → Supabase database: reads and writes tasks
- Task updates → Server database client: creates client (evidence: `app/api/tasks/[id]/route.ts`)
- Task updates → Task lifecycle rules: applies status rules (evidence: `app/api/tasks/[id]/route.ts`)
- Task updates → Commitment history: records changes (evidence: `app/api/tasks/[id]/route.ts`)
- Task updates → Supabase database: updates tasks
- Meeting operations → Server database client: creates client (evidence: `app/api/meetings/route.ts`)
- Meeting operations → Overdue detection: checks overdue tasks (evidence: `app/api/meetings/route.ts`)
- Meeting operations → Supabase database: reads meetings
- Insights data → Server database client: creates client (evidence: `app/api/insights/route.ts`)
- Insights data → Overdue detection: checks overdue tasks (evidence: `app/api/insights/route.ts`)
- Insights data → Supabase database: reads analytics data
- Scheduled reminders → Server database client: creates client (evidence: `app/api/cron/reminders/route.ts`)
- Scheduled reminders → Email provider: sends reminders (evidence: `app/api/cron/reminders/route.ts`)
- Scheduled reminders → Supabase database: reads reminder tasks
- Server database client → Supabase database: connects to (evidence: `lib/supabase-server.ts`)
