# breezyagd/transfertracker architecture

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

## Overview

TransferTracker is a student-facing transfer-planning app. A student enters major, campus, timeline, and coursework; may import a transcript and their own ASSIST agreement; then receives an editable term-by-term roadmap, audit, and PDF output. Saved plans and assistant conversations persist locally or to an authenticated Supabase account, while chat and agreement assistance can use the AI proxy. The graph follows documented workflows and source-index references; some parser internals and unsampled UI wiring are not shown, so uncertain links are omitted.

Main entry points: [`src/ui/assist-ui.js`](https://github.com/breezyagd/transfertracker/blob/main/src/ui/assist-ui.js) (Agreement import UI), [`src/planner/planner.js`](https://github.com/breezyagd/transfertracker/blob/main/src/planner/planner.js) (Plan engine), [`src/App.jsx`](https://github.com/breezyagd/transfertracker/blob/main/src/App.jsx) (App shell), [`src/ui/wizard.js`](https://github.com/breezyagd/transfertracker/blob/main/src/ui/wizard.js) (Planning wizard)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Student experience"]
  node_app["App shell<br/>[App.jsx]"]
  node_wizard["Planning wizard<br/>[wizard.js]"]
  node_roadmap_ui["Roadmap editor<br/>[roadmap.js]"]
  node_chat_ui["Assistant chat<br/>[chat.js]"]
  node_pdf_output["PDF output<br/>[pdf.js]"]
  node_assist_ui["Agreement import UI<br/>[assist-ui.js]"]
end

subgraph group_planning["Roadmap planning"]
  node_planner["Plan engine<br/>[planner.js]"]
  node_catalog[("Course catalog<br/>[catalog.js]")]
  node_institutions[("Major and campus data<br/>[institutions.js]")]
  node_satisfy["Requirement matching<br/>[satisfy.js]"]
  node_ap_map[("AP credit rules<br/>[ap-map.js]")]
  node_plan_state[("Planner state<br/>[state.js]")]
end

subgraph group_imports["Student imports"]
  node_assist_pdf["Agreement PDF parser<br/>[parse-pdf.js]"]
  node_assist_grammar["Agreement grammar<br/>[grammar.js]"]
  node_assist_aggregate["Agreement aggregation<br/>[aggregate.js]"]
  node_assist_adapt["Agreement adaptation<br/>[adapt.js]"]
  node_transcript_pdf["Transcript parser"]
  node_transcript_apply["Transcript matching<br/>[apply.js]"]
end

subgraph group_storage["Accounts and storage"]
  node_auth["Authentication provider<br/>[AuthProvider.jsx]"]
  node_persistence["Plan persistence<br/>[persistence.js]"]
  node_local_store[("Browser data store<br/>[store.js]")]
  node_supabase["Supabase client<br/>[supabase.js]"]
  node_analytics["Usage analytics<br/>[analytics.js]"]
end

subgraph group_services["AI and services"]
  node_ai_api["AI transport<br/>[api.js]"]
  node_ai_assist["AI assistance<br/>[assist.js]"]
  node_proxy["API proxy<br/>[proxy.js]"]
end

node_student(("Student"))

node_student -->|"uses"| node_app
node_app -->|"renders"| node_wizard
node_app -->|"renders"| node_roadmap_ui
node_app -->|"renders"| node_chat_ui
node_app -->|"initializes"| node_assist_ui
node_wizard -->|"parses transcript"| node_transcript_pdf
node_wizard -->|"matches courses"| node_transcript_apply
node_wizard -->|"builds plan"| node_planner
node_wizard -->|"renders roadmap"| node_roadmap_ui
node_planner -->|"uses courses"| node_catalog
node_planner -->|"uses requirements"| node_institutions
node_planner -->|"matches requirements"| node_satisfy
node_planner -->|"reads state"| node_plan_state
node_satisfy -->|"matches courses"| node_catalog
node_satisfy -->|"checks exam credit"| node_ap_map
node_satisfy -->|"flattens requirements"| node_assist_adapt
node_assist_ui -->|"parses agreement"| node_assist_pdf
node_assist_ui -->|"adapts agreement"| node_assist_adapt
node_assist_ui -->|"rebuilds plan"| node_planner
node_assist_ui -->|"requests assistance"| node_ai_assist
node_assist_ui -->|"sends AI request"| node_ai_api
node_assist_ui -->|"tracks import"| node_analytics
node_roadmap_ui -->|"renders export"| node_pdf_output
node_roadmap_ui -->|"renders context"| node_chat_ui
node_chat_ui -->|"reads plan audit"| node_planner
node_chat_ui -->|"sends chat"| node_ai_api
node_chat_ui -->|"tracks chat"| node_analytics
node_auth -->|"authenticates"| node_supabase
node_auth -->|"syncs account data"| node_persistence
node_auth -->|"updates session"| node_analytics
node_persistence -->|"stores locally"| node_local_store
node_persistence -->|"syncs cloud data"| node_supabase
node_analytics -->|"records events"| node_supabase
node_ai_api -->|"gets session"| node_supabase
node_ai_api -->|"posts requests"| node_proxy
node_proxy -.->|"calls model service"| node_ai_assist

click node_app "https://github.com/breezyagd/transfertracker/blob/main/src/App.jsx"
click node_wizard "https://github.com/breezyagd/transfertracker/blob/main/src/ui/wizard.js"
click node_roadmap_ui "https://github.com/breezyagd/transfertracker/blob/main/src/ui/roadmap.js"
click node_chat_ui "https://github.com/breezyagd/transfertracker/blob/main/src/ui/chat.js"
click node_pdf_output "https://github.com/breezyagd/transfertracker/blob/main/src/ui/pdf.js"
click node_assist_ui "https://github.com/breezyagd/transfertracker/blob/main/src/ui/assist-ui.js"
click node_planner "https://github.com/breezyagd/transfertracker/blob/main/src/planner/planner.js"
click node_catalog "https://github.com/breezyagd/transfertracker/blob/main/src/planner/catalog.js"
click node_institutions "https://github.com/breezyagd/transfertracker/blob/main/src/planner/institutions.js"
click node_satisfy "https://github.com/breezyagd/transfertracker/blob/main/src/planner/satisfy.js"
click node_ap_map "https://github.com/breezyagd/transfertracker/blob/main/src/planner/ap-map.js"
click node_plan_state "https://github.com/breezyagd/transfertracker/blob/main/src/planner/state.js"
click node_assist_pdf "https://github.com/breezyagd/transfertracker/blob/main/src/assist/parse-pdf.js"
click node_assist_grammar "https://github.com/breezyagd/transfertracker/blob/main/src/assist/grammar.js"
click node_assist_aggregate "https://github.com/breezyagd/transfertracker/blob/main/src/assist/aggregate.js"
click node_assist_adapt "https://github.com/breezyagd/transfertracker/blob/main/src/assist/adapt.js"
click node_transcript_pdf "https://github.com/breezyagd/transfertracker/blob/main/src/transcript/parse-transcript.js"
click node_transcript_apply "https://github.com/breezyagd/transfertracker/blob/main/src/transcript/apply.js"
click node_auth "https://github.com/breezyagd/transfertracker/blob/main/src/auth/AuthProvider.jsx"
click node_persistence "https://github.com/breezyagd/transfertracker/blob/main/src/data/persistence.js"
click node_local_store "https://github.com/breezyagd/transfertracker/blob/main/src/data/store.js"
click node_supabase "https://github.com/breezyagd/transfertracker/blob/main/src/supabase.js"
click node_analytics "https://github.com/breezyagd/transfertracker/blob/main/src/data/analytics.js"
click node_ai_api "https://github.com/breezyagd/transfertracker/blob/main/src/ai/api.js"
click node_ai_assist "https://github.com/breezyagd/transfertracker/blob/main/src/ai/assist.js"
click node_proxy "https://github.com/breezyagd/transfertracker/blob/main/server/proxy.js"

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_app,node_wizard,node_roadmap_ui,node_chat_ui,node_pdf_output,node_assist_ui toneBlue
class node_planner,node_catalog,node_institutions,node_satisfy,node_ap_map,node_plan_state toneAmber
class node_assist_pdf,node_assist_grammar,node_assist_aggregate,node_assist_adapt,node_transcript_pdf,node_transcript_apply toneMint
class node_auth,node_persistence,node_local_store,node_supabase,node_analytics toneRose
class node_ai_api,node_ai_assist,node_proxy,node_student toneIndigo
```

## Components

### Student experience

- [App shell](https://github.com/breezyagd/transfertracker/blob/main/src/App.jsx): `src/App.jsx`
- [Planning wizard](https://github.com/breezyagd/transfertracker/blob/main/src/ui/wizard.js): `src/ui/wizard.js`
- [Roadmap editor](https://github.com/breezyagd/transfertracker/blob/main/src/ui/roadmap.js): `src/ui/roadmap.js`
- [Assistant chat](https://github.com/breezyagd/transfertracker/blob/main/src/ui/chat.js): `src/ui/chat.js`
- [PDF output](https://github.com/breezyagd/transfertracker/blob/main/src/ui/pdf.js): `src/ui/pdf.js`
- [Agreement import UI](https://github.com/breezyagd/transfertracker/blob/main/src/ui/assist-ui.js): `src/ui/assist-ui.js`

### Roadmap planning

- [Plan engine](https://github.com/breezyagd/transfertracker/blob/main/src/planner/planner.js): `src/planner/planner.js`
- [Course catalog](https://github.com/breezyagd/transfertracker/blob/main/src/planner/catalog.js): `src/planner/catalog.js`
- [Major and campus data](https://github.com/breezyagd/transfertracker/blob/main/src/planner/institutions.js): `src/planner/institutions.js`
- [Requirement matching](https://github.com/breezyagd/transfertracker/blob/main/src/planner/satisfy.js): `src/planner/satisfy.js`
- [AP credit rules](https://github.com/breezyagd/transfertracker/blob/main/src/planner/ap-map.js): `src/planner/ap-map.js`
- [Planner state](https://github.com/breezyagd/transfertracker/blob/main/src/planner/state.js): `src/planner/state.js`

### Student imports

- [Agreement PDF parser](https://github.com/breezyagd/transfertracker/blob/main/src/assist/parse-pdf.js): `src/assist/parse-pdf.js`
- [Agreement grammar](https://github.com/breezyagd/transfertracker/blob/main/src/assist/grammar.js): `src/assist/grammar.js`
- [Agreement aggregation](https://github.com/breezyagd/transfertracker/blob/main/src/assist/aggregate.js): `src/assist/aggregate.js`
- [Agreement adaptation](https://github.com/breezyagd/transfertracker/blob/main/src/assist/adapt.js): `src/assist/adapt.js`
- [Transcript parser](https://github.com/breezyagd/transfertracker/blob/main/src/transcript/parse-transcript.js): `src/transcript/parse-transcript.js`
- [Transcript matching](https://github.com/breezyagd/transfertracker/blob/main/src/transcript/apply.js): `src/transcript/apply.js`

### Accounts and storage

- [Authentication provider](https://github.com/breezyagd/transfertracker/blob/main/src/auth/AuthProvider.jsx): `src/auth/AuthProvider.jsx`
- [Plan persistence](https://github.com/breezyagd/transfertracker/blob/main/src/data/persistence.js): `src/data/persistence.js`
- [Browser data store](https://github.com/breezyagd/transfertracker/blob/main/src/data/store.js): `src/data/store.js`
- [Supabase client](https://github.com/breezyagd/transfertracker/blob/main/src/supabase.js): `src/supabase.js`
- [Usage analytics](https://github.com/breezyagd/transfertracker/blob/main/src/data/analytics.js): `src/data/analytics.js`

### AI and services

- [AI transport](https://github.com/breezyagd/transfertracker/blob/main/src/ai/api.js): `src/ai/api.js`
- [AI assistance](https://github.com/breezyagd/transfertracker/blob/main/src/ai/assist.js): `src/ai/assist.js`
- [API proxy](https://github.com/breezyagd/transfertracker/blob/main/server/proxy.js): `server/proxy.js`

### Other components

- **Student**

## Connections

- Student → App shell: uses (evidence: `README.md`)
- App shell → Planning wizard: renders (evidence: `src/App.jsx`)
- App shell → Roadmap editor: renders (evidence: `src/App.jsx`)
- App shell → Assistant chat: renders (evidence: `src/App.jsx`)
- App shell → Agreement import UI: initializes
- Planning wizard → Transcript parser: parses transcript (evidence: `src/ui/wizard.js`)
- Planning wizard → Transcript matching: matches courses (evidence: `src/ui/wizard.js`)
- Planning wizard → Plan engine: builds plan (evidence: `src/ui/wizard.js`)
- Planning wizard → Roadmap editor: renders roadmap (evidence: `src/ui/wizard.js`)
- Plan engine → Course catalog: uses courses (evidence: `src/planner/planner.js`)
- Plan engine → Major and campus data: uses requirements (evidence: `src/planner/planner.js`)
- Plan engine → Requirement matching: matches requirements (evidence: `src/planner/planner.js`)
- Plan engine → Planner state: reads state (evidence: `src/planner/planner.js`)
- Requirement matching → Course catalog: matches courses (evidence: `src/planner/satisfy.js`)
- Requirement matching → AP credit rules: checks exam credit (evidence: `src/planner/satisfy.js`)
- Requirement matching → Agreement adaptation: flattens requirements (evidence: `src/planner/satisfy.js`)
- Agreement import UI → Agreement PDF parser: parses agreement (evidence: `src/ui/assist-ui.js`)
- Agreement import UI → Agreement adaptation: adapts agreement (evidence: `src/ui/assist-ui.js`)
- Agreement import UI → Plan engine: rebuilds plan (evidence: `src/ui/assist-ui.js`)
- Agreement import UI → AI assistance: requests assistance (evidence: `src/ui/assist-ui.js`)
- Agreement import UI → AI transport: sends AI request (evidence: `src/ui/assist-ui.js`)
- Agreement import UI → Usage analytics: tracks import (evidence: `src/ui/assist-ui.js`)
- Roadmap editor → PDF output: renders export (evidence: `src/ui/roadmap.js`)
- Roadmap editor → Assistant chat: renders context (evidence: `src/ui/roadmap.js`)
- Assistant chat → Plan engine: reads plan audit (evidence: `src/ui/chat.js`)
- Assistant chat → AI transport: sends chat (evidence: `src/ui/chat.js`)
- Assistant chat → Usage analytics: tracks chat (evidence: `src/ui/chat.js`)
- Authentication provider → Supabase client: authenticates (evidence: `src/auth/AuthProvider.jsx`)
- Authentication provider → Plan persistence: syncs account data (evidence: `src/auth/AuthProvider.jsx`)
- Authentication provider → Usage analytics: updates session (evidence: `src/auth/AuthProvider.jsx`)
- Plan persistence → Browser data store: stores locally (evidence: `src/data/persistence.js`)
- Plan persistence → Supabase client: syncs cloud data (evidence: `src/data/persistence.js`)
- Usage analytics → Supabase client: records events (evidence: `src/data/analytics.js`)
- AI transport → Supabase client: gets session (evidence: `src/ai/api.js`)
- AI transport → API proxy: posts requests (evidence: `src/ai/api.js`)
- API proxy → AI assistance: calls model service
