How parkerpape/actciv works
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: page.tsx Issue onboarding · intake.ts Training intake · DashboardClient.tsx Member dashboard · author.ts Training authoring
Components 25
Issue discovery
- Issue onboarding
web_building/app/onboarding/page.tsx - Issue catalog
web_building/app/data/issues.ts - Action catalog
web_building/app/data/actions.tsx - Member dashboard
web_building/app/dashboard/DashboardClient.tsx - Intent search
web_building/app/dashboard/DashboardSearch.tsx - Intent handling
web_building/app/lib/server/intent-actions.ts - Action detail
web_building/app/actions/[action]/page.tsx
Action delivery
- Write to officials
web_building/app/components/WriteYourRep.tsx - Call officials
web_building/app/components/CallYourRep.tsx - Issue routing
web_building/app/lib/server/route-issue.ts - Official lookup
web_building/app/lib/server/reps.ts - Letter drafting
web_building/app/lib/server/draft-core.ts - Action completion
web_building/app/lib/server/action-engine.ts
Member services
- Member profile
web_building/app/lib/profile.ts - Authentication
web_building/auth.ts
Training curation
- Training authoring
web_building/training/author.ts - Training routing and grading
web_building/training/pipeline.ts - Training sources
web_building/training/sources.ts - Training prompts
web_building/training/prompts.ts - Training intake
web_building/training/intake.ts - Training data contract
web_building/training/schema.ts - Dataset build
web_building/training/build.ts - Dataset audit
web_building/training/audit.ts - PII screening
web_building/training/pii.ts
Other components
- Civic visitor
Connections 32
- Civic visitor → Issue onboarding: chooses issues
- Issue onboarding → Issue catalog: uses issue list
web_building/app/onboarding/page.tsx - Issue onboarding → Action catalog: uses actions
web_building/app/onboarding/page.tsx - Issue onboarding → Member profile: saves profile
web_building/app/onboarding/page.tsx - Issue onboarding → Intent handling: submits intent
web_building/app/onboarding/page.tsx - Member dashboard → Intent search: renders search
web_building/app/dashboard/DashboardClient.tsx - Member dashboard → Write to officials: launches writing
web_building/app/dashboard/DashboardClient.tsx - Member dashboard → Call officials: launches calling
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
web_building/app/components/CallYourRep.tsx - Call officials → Action completion: records completion
web_building/app/components/CallYourRep.tsx - Issue routing → Official lookup: selects targets
- Member dashboard → Action completion: loads actions
web_building/app/dashboard/DashboardClient.tsx - Civic visitor → Authentication: signs in
- Training authoring → Training intake: reads records
web_building/training/author.ts - Training authoring → Training sources: resolves source
web_building/training/author.ts - Training authoring → Training routing and grading: routes examples
web_building/training/author.ts - Training authoring → Training prompts: uses prompts
web_building/training/author.ts - Training intake → Training data contract: validates records
web_building/training/intake.ts - Training intake → Dataset audit: assesses records
web_building/training/intake.ts - Training intake → PII screening: screens text
web_building/training/intake.ts - Training routing and grading → PII screening: checks drafts
web_building/training/pipeline.ts - Dataset build → Training sources: gates sources
web_building/training/build.ts - Dataset build → Training intake: reads intake
web_building/training/build.ts - Dataset build → Training data contract: validates examples
web_building/training/build.ts - Dataset build → PII screening: screens examples
web_building/training/build.ts - Dataset audit → PII screening: checks identifiers
web_building/training/audit.ts