How nicolaspozzi/notiontutor works
NotionTutor turns a user’s Notion pages into interactive AI revision sessions, tracks answers for spaced repetition, and can deliver scheduled email digests. The principal flow is page discovery, revision-session creation, answering, and history/stats; digest management and daily delivery are a separate capability. Routes orchestrate adapters and persistence, with session verification, encryption, and validation as shared internal services. The graph reflects the excerpts and SOURCE INDEX references; dashboard-to-route wiring and several route implementations were not inspected, so those links are not asserted.
Main entry points: revisions/route.ts Start revision · prisma.ts Postgres data · send-digests/route.ts Digest delivery job · session.ts Session security
Components 20
User experience
- Dashboard
src/app/dashboard/page.tsx - Notion pages
src/app/dashboard/pages/page.tsx - Revision history
src/app/dashboard/history/page.tsx - Digest settings
src/app/dashboard/digests/page.tsx
Revision workflow
- Page routes
src/app/api/pages/route.ts - Start revision
src/app/api/revisions/route.ts - Submit answer
src/app/api/revisions/[sessionId]/answer/route.ts - History routes
src/app/api/history/route.ts - Progress stats
src/app/api/stats/route.ts
Email digests
- Digest management
src/app/api/digests/route.ts - Digest delivery job
src/app/api/cron/send-digests/route.ts
Shared services
- Notion adapter
src/lib/adapters/notion/client.ts - Question generator
src/lib/adapters/llm/openai-adapter.ts - Session security
src/lib/auth/session.ts - Encrypted fields
src/lib/auth/encryption.ts - Request validation
src/lib/validation.ts - Postgres data
src/lib/db/prisma.ts
Other components
- Learner
- Resend email
- OpenAI
Connections 31
- Learner → Dashboard: uses
README.md - Learner → Notion pages: selects pages
README.md - Learner → Digest settings: configures digests
README.md - Page routes → Session security: verifies session
src/app/api/pages/route.ts - Page routes → Postgres data: reads token
src/app/api/pages/route.ts - Page routes → Encrypted fields: decrypts token
src/app/api/pages/route.ts - Page routes → Notion adapter: searches pages
src/app/api/pages/route.ts - Start revision → Session security: verifies session
src/app/api/revisions/route.ts - Start revision → Request validation: validates input
src/app/api/revisions/route.ts - Start revision → Postgres data: reads and writes
src/app/api/revisions/route.ts - Start revision → Encrypted fields: decrypts token
src/app/api/revisions/route.ts - Start revision → Encrypted fields: encrypts questions
src/app/api/revisions/route.ts - Start revision → Notion adapter: fetches page
src/app/api/revisions/route.ts - Start revision → Question generator: generates questions
src/app/api/revisions/route.ts - Notion adapter → OpenAI: calls Notion API
src/lib/adapters/notion/client.ts - Question generator → OpenAI: generates with
README.md - Submit answer → Session security: verifies session
src/app/api/revisions/[sessionId]/answer/route.ts - Submit answer → Request validation: validates input
src/app/api/revisions/[sessionId]/answer/route.ts - Submit answer → Postgres data: updates answers
src/app/api/revisions/[sessionId]/answer/route.ts - History routes → Session security: verifies session
src/app/api/history/route.ts - History routes → Postgres data: reads history
src/app/api/history/route.ts - Progress stats → Session security: verifies session
src/app/api/stats/route.ts - Progress stats → Postgres data: reads progress
src/app/api/stats/route.ts - Digest management → Session security: verifies session
src/app/api/digests/route.ts - Digest management → Request validation: validates input
src/app/api/digests/route.ts - Digest management → Postgres data: reads and writes
src/app/api/digests/route.ts - Digest delivery job → Postgres data: loads and updates
src/app/api/cron/send-digests/route.ts - Digest delivery job → Notion adapter: fetches page
src/app/api/cron/send-digests/route.ts - Digest delivery job → Question generator: generates question
src/app/api/cron/send-digests/route.ts - Digest delivery job → Encrypted fields: decrypts token
src/app/api/cron/send-digests/route.ts - Digest delivery job → Resend email: sends email
src/app/api/cron/send-digests/route.ts