Overview#
The curricula system provides structured learning paths that guide users through curated content sequences across traditions, practices, and concepts.
Neo4j Schema Design#
Node Types#
1. CURRICULUM#
Represents a complete learning path.
Properties:
id: UUID (unique identifier)title: string (e.g., "Introduction to Buddhist Meditation")description: string (detailed overview)tradition: string (Buddhism, Stoicism, etc.)level: enum ('beginner', 'intermediate', 'advanced')estimated_duration_minutes: integercreated_at: datetimeupdated_at: datetimecreated_by: string (curator ID)status: enum ('draft', 'published', 'archived')tags: string[] (searchable keywords)language: string (ISO 639-1 code)
2. MODULE#
A major section within a curriculum.
Properties:
id: UUIDcurriculum_id: UUID (parent curriculum)title: stringdescription: stringorder_index: integer (sequential position)estimated_duration_minutes: integercreated_at: datetimeupdated_at: datetime
3. LESSON#
An individual unit within a module.
Properties:
id: UUIDmodule_id: UUID (parent module)title: stringdescription: stringorder_index: integerestimated_duration_minutes: integerlesson_type: enum ('lecture', 'practice', 'reflection', 'assessment')created_at: datetimeupdated_at: datetime
4. USER_CURRICULUM_PROGRESS#
Tracks user's progress through a curriculum.
Properties:
id: UUIDuser_id: UUIDcurriculum_id: UUIDstatus: enum ('not_started', 'in_progress', 'completed', 'paused')started_at: datetimelast_accessed_at: datetimecompleted_at: datetime (nullable)completion_percentage: float (0-100)current_module_id: UUID (nullable)current_lesson_id: UUID (nullable)
5. USER_LESSON_COMPLETION#
Tracks completion of individual lessons.
Properties:
id: UUIDuser_id: UUIDlesson_id: UUIDcompleted_at: datetimetime_spent_minutes: integernotes: string (optional user notes)rating: integer (1-5, optional)
Relationships#
Curriculum Structure#
(curriculum:CURRICULUM)-[:HAS_MODULE {order: 1}]->(module:MODULE)
(module:MODULE)-[:HAS_LESSON {order: 1}]->(lesson:LESSON)
(lesson:LESSON)-[:INCLUDES_CONTENT]->(content:LECTURE|PRACTICE|CONCEPT)
Prerequisites#
(module:MODULE)-[:REQUIRES]->(prerequisite_module:MODULE)
(lesson:LESSON)-[:REQUIRES]->(prerequisite_lesson:LESSON)
User Progress#
(user:USER)-[:ENROLLED_IN]->(curriculum:CURRICULUM)
(user:USER)-[:HAS_PROGRESS]->(progress:USER_CURRICULUM_PROGRESS)
(user:USER)-[:COMPLETED]->(lesson:LESSON)
Content Association#
(lesson:LESSON)-[:INCLUDES_CONTENT]->(lecture:LECTURE)
(lesson:LESSON)-[:INCLUDES_CONTENT]->(practice:PRACTICE)
(lesson:LESSON)-[:INCLUDES_CONTENT]->(concept:CONCEPT)
API Endpoints#
Curriculum Management#
GET /v1/curricula#
List all curricula with filtering.
Query Parameters:
tradition: Filter by traditionlevel: Filter by difficulty levelstatus: Filter by statustags: Filter by tags (comma-separated)limit: Pagination limit (default: 20)offset: Pagination offset (default: 0)
Response:
{
"curricula": [
{
"id": "uuid",
"title": "Introduction to Buddhist Meditation",
"description": "...",
"tradition": "Buddhism",
"level": "beginner",
"estimated_duration_minutes": 480,
"module_count": 6,
"lesson_count": 24,
"status": "published",
"tags": ["meditation", "mindfulness", "basics"]
}
],
"total": 15,
"limit": 20,
"offset": 0
}
GET /v1/curricula/:id#
Get detailed curriculum with modules and lessons.
Response:
{
"curriculum": {
"id": "uuid",
"title": "Introduction to Buddhist Meditation",
"description": "...",
"tradition": "Buddhism",
"level": "beginner",
"estimated_duration_minutes": 480,
"modules": [
{
"id": "uuid",
"title": "Module 1: Foundations",
"description": "...",
"order_index": 1,
"estimated_duration_minutes": 80,
"lessons": [
{
"id": "uuid",
"title": "What is Meditation?",
"description": "...",
"order_index": 1,
"lesson_type": "lecture",
"estimated_duration_minutes": 20,
"content_ids": ["lecture-uuid-1", "concept-uuid-1"]
}
]
}
]
}
}
POST /v1/curricula#
Create a new curriculum (curator only).
Request Body:
{
"title": "Introduction to Buddhist Meditation",
"description": "...",
"tradition": "Buddhism",
"level": "beginner",
"estimated_duration_minutes": 480,
"tags": ["meditation", "mindfulness"],
"modules": [
{
"title": "Foundations",
"description": "...",
"order_index": 1,
"lessons": [
{
"title": "What is Meditation?",
"description": "...",
"order_index": 1,
"lesson_type": "lecture",
"content_ids": ["lecture-uuid-1"]
}
]
}
]
}
PUT /v1/curricula/:id#
Update curriculum (curator only).
DELETE /v1/curricula/:id#
Archive curriculum (curator only).
User Progress#
POST /v1/curricula/:id/enroll#
Enroll user in curriculum.
Response:
{
"enrollment": {
"id": "uuid",
"curriculum_id": "uuid",
"user_id": "uuid",
"status": "not_started",
"enrolled_at": "2025-10-16T20:00:00Z"
}
}
GET /v1/curricula/:id/progress#
Get user's progress in curriculum.
Response:
{
"progress": {
"id": "uuid",
"curriculum_id": "uuid",
"user_id": "uuid",
"status": "in_progress",
"started_at": "2025-10-15T10:00:00Z",
"last_accessed_at": "2025-10-16T15:00:00Z",
"completion_percentage": 45.5,
"current_module": {
"id": "uuid",
"title": "Module 3: Breathing Techniques"
},
"current_lesson": {
"id": "uuid",
"title": "Anapanasati Practice"
},
"completed_lessons": 11,
"total_lessons": 24
}
}
POST /v1/curricula/:curriculum_id/lessons/:lesson_id/complete#
Mark lesson as completed.
Request Body:
{
"time_spent_minutes": 25,
"notes": "Found this very helpful for understanding breath awareness",
"rating": 5
}
GET /v1/users/:user_id/curricula#
Get all curricula for user with progress.
Response:
{
"enrollments": [
{
"curriculum": {
"id": "uuid",
"title": "Introduction to Buddhist Meditation"
},
"progress": {
"status": "in_progress",
"completion_percentage": 45.5,
"started_at": "2025-10-15T10:00:00Z"
}
}
]
}
Use Cases#
1. Guided Learning Paths#
Users follow structured sequences through topics, building knowledge progressively.
2. Progress Tracking#
System tracks completion, time spent, and user notes for each lesson.
3. Personalization#
Curricula can be customized based on user preferences, tradition interests, and skill level.
4. Prerequisites#
Ensure users complete foundational content before advanced topics.
5. Analytics#
Track curriculum effectiveness, completion rates, and user engagement.
Implementation Notes#
Performance Optimization#
- Index on
curriculum.status,curriculum.tradition,curriculum.level - Index on
user_idin progress tracking nodes - Cache popular curricula in Redis
Access Control#
- Public: List and view published curricula
- Authenticated: Enroll, track progress, complete lessons
- Curator: Create, edit, publish, archive curricula
Data Validation#
- Order indices must be sequential within modules/lessons
- Estimated durations must be positive integers
- Status transitions must follow valid state machine
- Content references must exist in knowledge graph