# parkerpape/actciv architecture

> Architecture diagram of the GitHub repository parkerpape/actciv, 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/parkerpape/actciv
- Repository: https://github.com/parkerpape/actciv

## Overview

ActCiv is a civic-action web app: a member identifies an issue, finds relevant officials, drafts a letter or takes another civic action, and tracks completed actions to build a habit. The graph separates discovery, action delivery, and completion tracking, with account/profile handling as a supporting layer. It also includes a staff-facing training-data curation workflow for drafting examples, routing them, and screening them for quality and personal information. Some app subsystems are documented but their implementation was not sampled; those links are limited to README statements or omitted where evidence is insufficient.

Main entry points: [`web_building/app/onboarding/page.tsx`](https://github.com/parkerpape/actciv/blob/main/web_building/app/onboarding/page.tsx) (Issue onboarding), [`web_building/training/intake.ts`](https://github.com/parkerpape/actciv/blob/main/web_building/training/intake.ts) (Training intake), [`web_building/app/dashboard/DashboardClient.tsx`](https://github.com/parkerpape/actciv/blob/main/web_building/app/dashboard/DashboardClient.tsx) (Member dashboard), [`web_building/training/author.ts`](https://github.com/parkerpape/actciv/blob/main/web_building/training/author.ts) (Training authoring)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_discovery["Issue discovery"]
  node_onboarding["Issue onboarding<br/>[page.tsx]"]
  node_issue_catalog["Issue catalog<br/>[issues.ts]"]
  node_action_catalog["Action catalog<br/>[actions.tsx]"]
  node_dashboard["Member dashboard"]
  node_intent_search["Intent search"]
  node_intent_service["Intent handling<br/>[intent-actions.ts]"]
  node_action_page["Action detail<br/>[page.tsx]"]
end

subgraph group_delivery["Action delivery"]
  node_letter_flow["Write to officials<br/>[WriteYourRep.tsx]"]
  node_call_flow["Call officials<br/>[CallYourRep.tsx]"]
  node_routing["Issue routing<br/>[route-issue.ts]"]
  node_officials["Official lookup<br/>[reps.ts]"]
  node_drafting["Letter drafting<br/>[draft-core.ts]"]
  node_action_engine["Action completion<br/>[action-engine.ts]"]
end

subgraph group_member["Member services"]
  node_member_profile["Member profile<br/>[profile.ts]"]
  node_auth["Authentication<br/>[auth.ts]"]
end

subgraph group_training["Training curation"]
  node_training_author["Training authoring<br/>[author.ts]"]
  node_training_pipeline["Training routing and grading<br/>[pipeline.ts]"]
  node_training_sources["Training sources<br/>[sources.ts]"]
  node_training_prompts["Training prompts<br/>[prompts.ts]"]
  node_training_intake["Training intake<br/>[intake.ts]"]
  node_training_schema["Training data contract<br/>[schema.ts]"]
  node_training_build["Dataset build<br/>[build.ts]"]
  node_training_audit["Dataset audit<br/>[audit.ts]"]
  node_training_pii["PII screening<br/>[pii.ts]"]
end

node_visitor(("Civic visitor"))

node_visitor -->|"chooses issues"| node_onboarding
node_onboarding -->|"uses issue list"| node_issue_catalog
node_onboarding -->|"uses actions"| node_action_catalog
node_onboarding -->|"saves profile"| node_member_profile
node_onboarding -->|"submits intent"| node_intent_service
node_dashboard -->|"renders search"| node_intent_search
node_dashboard -->|"launches writing"| node_letter_flow
node_dashboard -->|"launches calling"| node_call_flow
node_intent_search -.->|"submits intent"| node_intent_service
node_visitor -.->|"opens action"| node_action_page
node_action_page -.->|"shows action"| node_action_catalog
node_letter_flow -->|"routes issue"| node_routing
node_letter_flow -.->|"requests draft"| node_drafting
node_letter_flow -->|"records completion"| node_action_engine
node_call_flow -.->|"routes issue"| node_routing
node_call_flow -.->|"records completion"| node_action_engine
node_routing -.->|"selects targets"| node_officials
node_dashboard -->|"loads actions"| node_action_engine
node_visitor -.->|"signs in"| node_auth
node_training_author -->|"reads records"| node_training_intake
node_training_author -->|"resolves source"| node_training_sources
node_training_author -->|"routes examples"| node_training_pipeline
node_training_author -->|"uses prompts"| node_training_prompts
node_training_intake -->|"validates records"| node_training_schema
node_training_intake -->|"assesses records"| node_training_audit
node_training_intake -->|"screens text"| node_training_pii
node_training_pipeline -->|"checks drafts"| node_training_pii
node_training_build -->|"gates sources"| node_training_sources
node_training_build -->|"reads intake"| node_training_intake
node_training_build -->|"validates examples"| node_training_schema
node_training_build -->|"screens examples"| node_training_pii
node_training_audit -->|"checks identifiers"| node_training_pii

click node_onboarding "https://github.com/parkerpape/actciv/blob/main/web_building/app/onboarding/page.tsx"
click node_issue_catalog "https://github.com/parkerpape/actciv/blob/main/web_building/app/data/issues.ts"
click node_action_catalog "https://github.com/parkerpape/actciv/blob/main/web_building/app/data/actions.tsx"
click node_dashboard "https://github.com/parkerpape/actciv/blob/main/web_building/app/dashboard/DashboardClient.tsx"
click node_intent_search "https://github.com/parkerpape/actciv/blob/main/web_building/app/dashboard/DashboardSearch.tsx"
click node_intent_service "https://github.com/parkerpape/actciv/blob/main/web_building/app/lib/server/intent-actions.ts"
click node_action_page "https://github.com/parkerpape/actciv/blob/main/web_building/app/actions/%5Baction%5D/page.tsx"
click node_letter_flow "https://github.com/parkerpape/actciv/blob/main/web_building/app/components/WriteYourRep.tsx"
click node_call_flow "https://github.com/parkerpape/actciv/blob/main/web_building/app/components/CallYourRep.tsx"
click node_routing "https://github.com/parkerpape/actciv/blob/main/web_building/app/lib/server/route-issue.ts"
click node_officials "https://github.com/parkerpape/actciv/blob/main/web_building/app/lib/server/reps.ts"
click node_drafting "https://github.com/parkerpape/actciv/blob/main/web_building/app/lib/server/draft-core.ts"
click node_action_engine "https://github.com/parkerpape/actciv/blob/main/web_building/app/lib/server/action-engine.ts"
click node_member_profile "https://github.com/parkerpape/actciv/blob/main/web_building/app/lib/profile.ts"
click node_auth "https://github.com/parkerpape/actciv/blob/main/web_building/auth.ts"
click node_training_author "https://github.com/parkerpape/actciv/blob/main/web_building/training/author.ts"
click node_training_pipeline "https://github.com/parkerpape/actciv/blob/main/web_building/training/pipeline.ts"
click node_training_sources "https://github.com/parkerpape/actciv/blob/main/web_building/training/sources.ts"
click node_training_prompts "https://github.com/parkerpape/actciv/blob/main/web_building/training/prompts.ts"
click node_training_intake "https://github.com/parkerpape/actciv/blob/main/web_building/training/intake.ts"
click node_training_schema "https://github.com/parkerpape/actciv/blob/main/web_building/training/schema.ts"
click node_training_build "https://github.com/parkerpape/actciv/blob/main/web_building/training/build.ts"
click node_training_audit "https://github.com/parkerpape/actciv/blob/main/web_building/training/audit.ts"
click node_training_pii "https://github.com/parkerpape/actciv/blob/main/web_building/training/pii.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_onboarding,node_issue_catalog,node_action_catalog,node_dashboard,node_intent_search,node_intent_service,node_action_page toneBlue
class node_letter_flow,node_call_flow,node_routing,node_officials,node_drafting,node_action_engine toneAmber
class node_member_profile,node_auth toneMint
class node_training_author,node_training_pipeline,node_training_sources,node_training_prompts,node_training_intake,node_training_schema,node_training_build,node_training_audit,node_training_pii toneRose
class node_visitor toneIndigo
```

## Components

### Issue discovery

- [Issue onboarding](https://github.com/parkerpape/actciv/blob/main/web_building/app/onboarding/page.tsx): `web_building/app/onboarding/page.tsx`
- [Issue catalog](https://github.com/parkerpape/actciv/blob/main/web_building/app/data/issues.ts): `web_building/app/data/issues.ts`
- [Action catalog](https://github.com/parkerpape/actciv/blob/main/web_building/app/data/actions.tsx): `web_building/app/data/actions.tsx`
- [Member dashboard](https://github.com/parkerpape/actciv/blob/main/web_building/app/dashboard/DashboardClient.tsx): `web_building/app/dashboard/DashboardClient.tsx`
- [Intent search](https://github.com/parkerpape/actciv/blob/main/web_building/app/dashboard/DashboardSearch.tsx): `web_building/app/dashboard/DashboardSearch.tsx`
- [Intent handling](https://github.com/parkerpape/actciv/blob/main/web_building/app/lib/server/intent-actions.ts): `web_building/app/lib/server/intent-actions.ts`
- [Action detail](https://github.com/parkerpape/actciv/blob/main/web_building/app/actions/%5Baction%5D/page.tsx): `web_building/app/actions/[action]/page.tsx`

### Action delivery

- [Write to officials](https://github.com/parkerpape/actciv/blob/main/web_building/app/components/WriteYourRep.tsx): `web_building/app/components/WriteYourRep.tsx`
- [Call officials](https://github.com/parkerpape/actciv/blob/main/web_building/app/components/CallYourRep.tsx): `web_building/app/components/CallYourRep.tsx`
- [Issue routing](https://github.com/parkerpape/actciv/blob/main/web_building/app/lib/server/route-issue.ts): `web_building/app/lib/server/route-issue.ts`
- [Official lookup](https://github.com/parkerpape/actciv/blob/main/web_building/app/lib/server/reps.ts): `web_building/app/lib/server/reps.ts`
- [Letter drafting](https://github.com/parkerpape/actciv/blob/main/web_building/app/lib/server/draft-core.ts): `web_building/app/lib/server/draft-core.ts`
- [Action completion](https://github.com/parkerpape/actciv/blob/main/web_building/app/lib/server/action-engine.ts): `web_building/app/lib/server/action-engine.ts`

### Member services

- [Member profile](https://github.com/parkerpape/actciv/blob/main/web_building/app/lib/profile.ts): `web_building/app/lib/profile.ts`
- [Authentication](https://github.com/parkerpape/actciv/blob/main/web_building/auth.ts): `web_building/auth.ts`

### Training curation

- [Training authoring](https://github.com/parkerpape/actciv/blob/main/web_building/training/author.ts): `web_building/training/author.ts`
- [Training routing and grading](https://github.com/parkerpape/actciv/blob/main/web_building/training/pipeline.ts): `web_building/training/pipeline.ts`
- [Training sources](https://github.com/parkerpape/actciv/blob/main/web_building/training/sources.ts): `web_building/training/sources.ts`
- [Training prompts](https://github.com/parkerpape/actciv/blob/main/web_building/training/prompts.ts): `web_building/training/prompts.ts`
- [Training intake](https://github.com/parkerpape/actciv/blob/main/web_building/training/intake.ts): `web_building/training/intake.ts`
- [Training data contract](https://github.com/parkerpape/actciv/blob/main/web_building/training/schema.ts): `web_building/training/schema.ts`
- [Dataset build](https://github.com/parkerpape/actciv/blob/main/web_building/training/build.ts): `web_building/training/build.ts`
- [Dataset audit](https://github.com/parkerpape/actciv/blob/main/web_building/training/audit.ts): `web_building/training/audit.ts`
- [PII screening](https://github.com/parkerpape/actciv/blob/main/web_building/training/pii.ts): `web_building/training/pii.ts`

### Other components

- **Civic visitor**

## Connections

- Civic visitor → Issue onboarding: chooses issues
- Issue onboarding → Issue catalog: uses issue list (evidence: `web_building/app/onboarding/page.tsx`)
- Issue onboarding → Action catalog: uses actions (evidence: `web_building/app/onboarding/page.tsx`)
- Issue onboarding → Member profile: saves profile (evidence: `web_building/app/onboarding/page.tsx`)
- Issue onboarding → Intent handling: submits intent (evidence: `web_building/app/onboarding/page.tsx`)
- Member dashboard → Intent search: renders search (evidence: `web_building/app/dashboard/DashboardClient.tsx`)
- Member dashboard → Write to officials: launches writing (evidence: `web_building/app/dashboard/DashboardClient.tsx`)
- Member dashboard → Call officials: launches calling (evidence: `web_building/app/dashboard/DashboardClient.tsx`)
- Intent search → Intent handling: submits intent
- Civic visitor → Action detail: opens action
- Action detail → Action catalog: shows action
- Write to officials → Issue routing: routes issue
- Write to officials → Letter drafting: requests draft
- Write to officials → Action completion: records completion
- Call officials → Issue routing: routes issue (evidence: `web_building/app/components/CallYourRep.tsx`)
- Call officials → Action completion: records completion (evidence: `web_building/app/components/CallYourRep.tsx`)
- Issue routing → Official lookup: selects targets
- Member dashboard → Action completion: loads actions (evidence: `web_building/app/dashboard/DashboardClient.tsx`)
- Civic visitor → Authentication: signs in
- Training authoring → Training intake: reads records (evidence: `web_building/training/author.ts`)
- Training authoring → Training sources: resolves source (evidence: `web_building/training/author.ts`)
- Training authoring → Training routing and grading: routes examples (evidence: `web_building/training/author.ts`)
- Training authoring → Training prompts: uses prompts (evidence: `web_building/training/author.ts`)
- Training intake → Training data contract: validates records (evidence: `web_building/training/intake.ts`)
- Training intake → Dataset audit: assesses records (evidence: `web_building/training/intake.ts`)
- Training intake → PII screening: screens text (evidence: `web_building/training/intake.ts`)
- Training routing and grading → PII screening: checks drafts (evidence: `web_building/training/pipeline.ts`)
- Dataset build → Training sources: gates sources (evidence: `web_building/training/build.ts`)
- Dataset build → Training intake: reads intake (evidence: `web_building/training/build.ts`)
- Dataset build → Training data contract: validates examples (evidence: `web_building/training/build.ts`)
- Dataset build → PII screening: screens examples (evidence: `web_building/training/build.ts`)
- Dataset audit → PII screening: checks identifiers (evidence: `web_building/training/audit.ts`)
