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.

2.2 KiB Raw Blame History