How sarahputhran/teachpivot works
TeachPivot supports teachers preparing for a classroom situation, consulting a context-specific Prep Card, and reflecting afterward; CRPs review collective signals and can revise guidance. The README documents these product stages and the bounded, pattern-based support model. Source evidence shows the frontend navigation and API boundary, backend route mounting, CRP signal orchestration, and reflection aggregation. Several route and page implementations were not excerpted, so some documented workflow links are shown with null evidence rather than inferred source calls.
Main entry points: crp.js CRP routes · api.js API client · App.jsx App navigation · index.js API router
Components 28
Teacher support
- App navigation
frontend/src/App.jsx - Context selection
frontend/src/pages/ContextSelection.jsx - Situation selection
frontend/src/pages/SituationSelection.jsx - Prep Card view
frontend/src/pages/PrepCardPage.jsx - Prep history and reflection
frontend/src/pages/PrepHistoryPage.jsx - Reflection form
frontend/src/components/ReflectionForm.jsx
CRP learning
- CRP dashboard
frontend/src/pages/CRPDashboard.jsx
Backend services
- API client
frontend/src/api.js - Response normalization
frontend/src/lib/normalize.ts - API router
backend/src/routes/index.js - Curriculum routes
backend/src/routes/curriculum.js - Prep Card routes
backend/src/routes/prepCard.js - Reflection routes
backend/src/routes/reflection.js - CRP routes
backend/src/routes/crp.js - Revision routes
backend/src/routes/revisions.js - Role authorization
backend/src/middleware/roleAuth.js - Review summarizer
backend/src/services/ReviewSummarizer.js
Domain data
- Prep Card records
backend/src/models/PrepCard.js - Curriculum records
backend/src/models/Curriculum.js - Reflection records
backend/src/models/Reflection.js - Reflection aggregation
backend/src/data/aggregateReflections.js - Aggregated signals
backend/src/models/AggregatedSignal.js - Theme extraction
backend/src/data/extractThemeSignals.js - Risk flagging
backend/src/data/applyRiskFlags.js - CRP reviews
backend/src/models/CRPReview.js - Prep Card revisions
backend/src/models/PrepCardRevision.js
Other components
- Teacher
- CRP
Connections 39
- Teacher → App navigation: starts
README.md - App navigation → Context selection: routes to
frontend/src/App.jsx - App navigation → Situation selection: routes to
frontend/src/App.jsx - App navigation → Prep Card view: routes to
frontend/src/App.jsx - App navigation → Prep history and reflection: routes to
frontend/src/App.jsx - App navigation → CRP dashboard: routes to
frontend/src/App.jsx - Context selection → API client: requests topics
frontend/src/pages/ContextSelection.jsx - Situation selection → API client: requests situations
frontend/src/api.js - Prep Card view → API client: requests card
frontend/src/api.js - Prep history and reflection → Reflection form: renders
frontend/src/pages/PrepHistoryPage.jsx - Reflection form → API client: submits reflection
frontend/src/components/ReflectionForm.jsx - CRP dashboard → API client: requests dashboard
frontend/src/pages/CRPDashboard.jsx - API client → API router: calls REST API
README.md - API router → Curriculum routes: mounts
backend/src/routes/index.js - API router → Prep Card routes: mounts
backend/src/routes/index.js - API router → Reflection routes: mounts
backend/src/routes/index.js - API router → CRP routes: mounts
backend/src/routes/index.js - API router → Revision routes: mounts
backend/src/routes/index.js - Curriculum routes → Curriculum records: queries
backend/src/routes/curriculum.js - Prep Card routes → Prep Card records: queries
backend/src/routes/prepCard.js - Prep Card routes → Curriculum records: queries
backend/src/routes/prepCard.js - CRP routes → Reflection aggregation: runs aggregation
backend/src/routes/crp.js - CRP routes → Theme extraction: runs extraction
backend/src/routes/crp.js - CRP routes → Risk flagging: runs flagging
backend/src/routes/crp.js - Reflection aggregation → Reflection records: reads
backend/src/data/aggregateReflections.js - Reflection aggregation → Aggregated signals: writes
backend/src/data/aggregateReflections.js - Theme extraction → Reflection records: reads
backend/src/data/extractThemeSignals.js - Theme extraction → Aggregated signals: updates
backend/src/data/extractThemeSignals.js - Risk flagging → Aggregated signals: updates flags
backend/src/data/applyRiskFlags.js - CRP routes → Aggregated signals: queries
backend/src/routes/crp.js - CRP routes → CRP reviews: records review
backend/src/routes/crp.js - CRP routes → Prep Card records: queries cards
backend/src/routes/crp.js - Revision routes → Prep Card revisions: manages
backend/src/routes/revisions.js - Revision routes → Prep Card records: queries cards
backend/src/routes/revisions.js - CRP routes → Role authorization: checks role
backend/src/routes/crp.js - Revision routes → Role authorization: checks role
backend/src/routes/revisions.js - CRP → CRP dashboard: reviews signals
README.md - CRP routes → Review summarizer: summarizes reviews
backend/src/routes/crp.js - API client → Response normalization: normalizes responses