# bvazrala/recall architecture

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

- Interactive diagram: https://gitdiagram.com/bvazrala/recall
- Repository: https://github.com/bvazrala/recall

## Overview

Recall is an early scaffold for text-message spaced repetition: the intended loop is study material intake, question/review delivery, answer grading, and FSRS rescheduling, with a dashboard and database supporting it. Currently, the visible working pieces are the dashboard’s example API request, server routes, student schema, and core FSRS scheduling; README explicitly says grading, inbound handling, and agent behavior are not built. The database and Photon schemas show planned capabilities, not a verified runtime pipeline. Edges are limited to README or indexed-source evidence.

Main entry points: [`packages/db/src/schema/students.ts`](https://github.com/bvazrala/recall/blob/main/packages/db/src/schema/students.ts) (Student records), [`apps/server/src/mastra/index.ts`](https://github.com/bvazrala/recall/blob/main/apps/server/src/mastra/index.ts) (Mastra server), [`packages/core/src`](https://github.com/bvazrala/recall/tree/main/packages/core/src) (Core domain stubs), [`packages/db/src/schema/cards.ts`](https://github.com/bvazrala/recall/blob/main/packages/db/src/schema/cards.ts) (Cards and questions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Student experience"]
  node_dashboard["Dashboard<br/>[page.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
end

subgraph group_server["API and agent"]
  node_server_config["Mastra server<br/>[index.ts]"]
  node_example_route["Example route<br/>[example.ts]"]
  node_status_route["Status route<br/>[status.ts]"]
  node_agent["LLM agent<br/>[agent.ts]"]
end

subgraph group_core["Study logic"]
  node_core_modules["Core domain stubs"]
  node_clock["Demo clock<br/>[clock.ts]"]
  node_rating["Answer rating<br/>[rating.ts]"]
  node_scheduler["FSRS scheduler<br/>[scheduler.ts]"]
end

subgraph group_data["Persistence"]
  node_db_client["Database client<br/>[client.ts]"]
  node_students[("Student records<br/>[students.ts]")]
  node_study_content[("Files and passages<br/>[notes.ts]")]
  node_cards_questions[("Cards and questions<br/>[cards.ts]")]
  node_sessions_reviews[("Quiz sessions and reviews<br/>[quiz.ts]")]
  node_messages[("Message records<br/>[messages.ts]")]
end

subgraph group_messaging["Messaging"]
  node_photon["Photon app card<br/>[app-card.ts]"]
  node_sms(("Text messaging"))
end

node_student(("Student"))

node_student -->|"views"| node_dashboard
node_dashboard -->|"requests data"| node_api_client
node_api_client -->|"calls endpoint"| node_example_route
node_server_config -->|"registers"| node_example_route
node_server_config -->|"registers"| node_status_route
node_server_config -->|"configures"| node_agent
node_core_modules -->|"exports"| node_clock
node_core_modules -->|"exports"| node_scheduler
node_scheduler -->|"uses rating type"| node_rating
node_db_client -->|"loads schema"| node_students
node_cards_questions -->|"references"| node_students
node_cards_questions -->|"references passages"| node_study_content
node_sessions_reviews -->|"references"| node_cards_questions
node_sessions_reviews -->|"references"| node_students
node_messages -->|"references"| node_students
node_sms -.->|"may use app card"| node_photon
node_student -.->|"texts answers"| node_sms
node_core_modules -->|"exports"| node_rating

click node_dashboard "https://github.com/bvazrala/recall/blob/main/apps/web/src/app/dashboard/page.tsx"
click node_api_client "https://github.com/bvazrala/recall/blob/main/apps/web/src/lib/api.ts"
click node_server_config "https://github.com/bvazrala/recall/blob/main/apps/server/src/mastra/index.ts"
click node_example_route "https://github.com/bvazrala/recall/blob/main/apps/server/src/mastra/routes/example.ts"
click node_status_route "https://github.com/bvazrala/recall/blob/main/apps/server/src/mastra/routes/status.ts"
click node_agent "https://github.com/bvazrala/recall/blob/main/apps/server/src/mastra/agents/agent.ts"
click node_core_modules "https://github.com/bvazrala/recall/tree/main/packages/core/src"
click node_clock "https://github.com/bvazrala/recall/blob/main/packages/core/src/clock.ts"
click node_rating "https://github.com/bvazrala/recall/blob/main/packages/core/src/fsrs/rating.ts"
click node_scheduler "https://github.com/bvazrala/recall/blob/main/packages/core/src/fsrs/scheduler.ts"
click node_db_client "https://github.com/bvazrala/recall/blob/main/packages/db/src/client.ts"
click node_students "https://github.com/bvazrala/recall/blob/main/packages/db/src/schema/students.ts"
click node_study_content "https://github.com/bvazrala/recall/blob/main/packages/db/src/schema/notes.ts"
click node_cards_questions "https://github.com/bvazrala/recall/blob/main/packages/db/src/schema/cards.ts"
click node_sessions_reviews "https://github.com/bvazrala/recall/blob/main/packages/db/src/schema/quiz.ts"
click node_messages "https://github.com/bvazrala/recall/blob/main/packages/db/src/schema/messages.ts"
click node_photon "https://github.com/bvazrala/recall/blob/main/photon/src/app-card.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_dashboard,node_api_client toneBlue
class node_server_config,node_example_route,node_status_route,node_agent toneAmber
class node_core_modules,node_clock,node_rating,node_scheduler toneMint
class node_db_client,node_students,node_study_content,node_cards_questions,node_sessions_reviews,node_messages toneRose
class node_photon,node_sms,node_student toneIndigo
```

## Components

### Student experience

- [Dashboard](https://github.com/bvazrala/recall/blob/main/apps/web/src/app/dashboard/page.tsx): `apps/web/src/app/dashboard/page.tsx`
- [API client](https://github.com/bvazrala/recall/blob/main/apps/web/src/lib/api.ts): `apps/web/src/lib/api.ts`

### API and agent

- [Mastra server](https://github.com/bvazrala/recall/blob/main/apps/server/src/mastra/index.ts): `apps/server/src/mastra/index.ts`
- [Example route](https://github.com/bvazrala/recall/blob/main/apps/server/src/mastra/routes/example.ts): `apps/server/src/mastra/routes/example.ts`
- [Status route](https://github.com/bvazrala/recall/blob/main/apps/server/src/mastra/routes/status.ts): `apps/server/src/mastra/routes/status.ts`
- [LLM agent](https://github.com/bvazrala/recall/blob/main/apps/server/src/mastra/agents/agent.ts): `apps/server/src/mastra/agents/agent.ts`

### Study logic

- [Core domain stubs](https://github.com/bvazrala/recall/tree/main/packages/core/src): `packages/core/src`
- [Demo clock](https://github.com/bvazrala/recall/blob/main/packages/core/src/clock.ts): `packages/core/src/clock.ts`
- [Answer rating](https://github.com/bvazrala/recall/blob/main/packages/core/src/fsrs/rating.ts): `packages/core/src/fsrs/rating.ts`
- [FSRS scheduler](https://github.com/bvazrala/recall/blob/main/packages/core/src/fsrs/scheduler.ts): `packages/core/src/fsrs/scheduler.ts`

### Persistence

- [Database client](https://github.com/bvazrala/recall/blob/main/packages/db/src/client.ts): `packages/db/src/client.ts`
- [Student records](https://github.com/bvazrala/recall/blob/main/packages/db/src/schema/students.ts): `packages/db/src/schema/students.ts`
- [Files and passages](https://github.com/bvazrala/recall/blob/main/packages/db/src/schema/notes.ts): `packages/db/src/schema/notes.ts`
- [Cards and questions](https://github.com/bvazrala/recall/blob/main/packages/db/src/schema/cards.ts): `packages/db/src/schema/cards.ts`
- [Quiz sessions and reviews](https://github.com/bvazrala/recall/blob/main/packages/db/src/schema/quiz.ts): `packages/db/src/schema/quiz.ts`
- [Message records](https://github.com/bvazrala/recall/blob/main/packages/db/src/schema/messages.ts): `packages/db/src/schema/messages.ts`

### Messaging

- [Photon app card](https://github.com/bvazrala/recall/blob/main/photon/src/app-card.ts): `photon/src/app-card.ts`
- **Text messaging**

### Other components

- **Student**

## Connections

- Student → Dashboard: views
- Dashboard → API client: requests data
- API client → Example route: calls endpoint
- Mastra server → Example route: registers (evidence: `apps/server/src/mastra/index.ts`)
- Mastra server → Status route: registers (evidence: `apps/server/src/mastra/index.ts`)
- Mastra server → LLM agent: configures (evidence: `apps/server/src/mastra/index.ts`)
- Core domain stubs → Demo clock: exports (evidence: `packages/core/src/index.ts`)
- Core domain stubs → FSRS scheduler: exports (evidence: `packages/core/src/index.ts`)
- FSRS scheduler → Answer rating: uses rating type (evidence: `packages/core/src/fsrs/scheduler.ts`)
- Database client → Student records: loads schema (evidence: `packages/db/src/client.ts`)
- Cards and questions → Student records: references (evidence: `packages/db/src/schema/cards.ts`)
- Cards and questions → Files and passages: references passages (evidence: `packages/db/src/schema/cards.ts`)
- Quiz sessions and reviews → Cards and questions: references (evidence: `packages/db/src/schema/quiz.ts`)
- Quiz sessions and reviews → Student records: references (evidence: `packages/db/src/schema/quiz.ts`)
- Message records → Student records: references (evidence: `packages/db/src/schema/messages.ts`)
- Text messaging → Photon app card: may use app card
- Student → Text messaging: texts answers
- Core domain stubs → Answer rating: exports (evidence: `packages/core/src/index.ts`)
