OpenCCB - Open Comprehensive Course Backbone

OpenCCB is a high-performance, microservices-based Learning Management System (LMS) and Content Management System (CMS) built with Rust (Edition 2024) and Next.js. The name stands for Open Comprehensive Course Backbone, representing the solid foundation for modern educational platforms.

Architecture

• CMS Service (Port 3001): Course management, content creation, and administrative configurations.
• LMS Service (Port 3002): Student experience, course consumption, and enrollment.
• Shared Library: Core models and authentication logic.
• Database: PostgreSQL (shared/isolated schemas).
• Studio (Frontend): Next.js application for instructors and admins.

Getting Started

Prerequisites

• Docker & Docker Compose
• Rust (Edition 2024)
• Node.js (v18+)

Running with Docker

docker compose up -d --build

API Documentation

CMS Service (:3001)

Create a Course

• URL: /courses
• Method: POST
• Example:

curl -X POST http://localhost:3001/courses \
  -H "Content-Type: application/json" \
  -d '{"title": "Advanced Rust 2024"}'

• Response:

{
  "id": "uuid-v4",
  "title": "Advanced Rust 2024",
  "description": null,
  "instructor_id": "uuid-v4",
  "start_date": null,
  "end_date": null,
  "created_at": "2023-12-19T10:00:00Z",
  "updated_at": "2023-12-19T10:00:00Z"
}

Create a Module

• URL: /modules
• Method: POST
• Example:

curl -X POST http://localhost:3001/modules \
  -H "Content-Type: application/json" \
  -d '{"title": "Introduction", "course_id": "YOUR_COURSE_ID", "position": 1}'

LMS Service (:3002)

Get Course Catalog

• URL: /catalog
• Method: GET
• Example:

curl http://localhost:3002/catalog

Enroll in a Course

• URL: /enroll
• Method: POST
• Example:

curl -X POST http://localhost:3002/enroll \
  -H "Content-Type: application/json" \
  -d '{"course_id": "YOUR_COURSE_ID"}'

Audit Logging

Every mutation in the CMS (Create Course/Module/Lesson) is automatically recorded in the audit_logs table for compliance and debugging.