How hamamebouchareb/hamame-platform works
Hamame is a study and exam-preparation platform: learners use a web app to study curriculum content, practice questions, take sessions or simulations, review progress, and manage accounts. The web client fronts an Express API; session handling includes question selection, attempts, and review/badge hooks. The API also supports AI study aids, authoring and moderation, social features, and scheduled maintenance and reminder jobs. The README is empty, so product capabilities are inferred from the tree and source index; frontend-to-API wiring and several route internals were not sampled.
Main entry points: app.ts Express app · jobs Scheduled jobs · prisma.ts Application database · sessions.routes.ts Practice sessions
Components 24
Web client
- Study web app
web/src/app - API client
web/src/lib/api.ts
API and access
- HTTP server
src/server.ts - Express app
src/app.ts - API route registry
src/routes/index.ts - Authentication
src/middleware/auth.ts - Role authorization
src/middleware/requireRole.ts - Request validation
src/middleware/validate.ts - Error handling
src/middleware/errorHandler.ts - Application database
src/lib/prisma.ts - Administration
src/routes/admin.routes.ts
Study workflows
- Practice sessions
src/routes/sessions.routes.ts - Spaced review queue
src/routes/reviews.routes.ts - Progress and goals
src/routes/progress.routes.ts - AI study aids
src/lib/ai/contextual-hint.ts
Content and community
- Questions and curriculum
src/routes/questions.routes.ts - Content authoring
src/routes/authoring.routes.ts - Content review
src/routes/review.routes.ts - Community and leaderboards
src/routes/friends.routes.ts
Jobs and integrations
- Anthropic API
- Scheduled jobs
src/jobs - Push delivery
src/lib/push/send.ts - Push service
Other components
- Learner
Connections 18
- Learner → Study web app: uses
- Study web app → API client: requests data
- API client → Express app: calls API
- HTTP server → Express app: creates
src/server.ts - Express app → API route registry: mounts at /api
src/app.ts - Express app → Error handling: handles errors
src/app.ts - Practice sessions → Spaced review queue: enqueues reviews
src/routes/sessions.routes.ts - Practice sessions → AI study aids: loads hint questions
src/routes/sessions.routes.ts - AI study aids → Anthropic API: generates hints
src/lib/ai/contextual-hint.ts - Practice sessions → Application database: reads and writes
src/routes/sessions.routes.ts - Spaced review queue → Application database: reads and writes
src/routes/reviews.routes.ts - Content review → Application database: updates reviewed content
src/routes/review.routes.ts - Content review → AI study aids: generates explanations
src/routes/review.routes.ts - Administration → Scheduled jobs: runs maintenance
src/routes/admin.routes.ts - HTTP server → Scheduled jobs: schedules
src/server.ts - Scheduled jobs → Application database: updates records
src/jobs/expireSubscriptions.ts - Scheduled jobs → Push delivery: sends reminders
src/jobs/sendDailyPushReminders.ts - Push delivery → Push service: delivers notifications