Skip to content
ameryhusamPublic

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Edu_v10 — Adaptive Learning Platform

Clean Architecture + Bounded Contexts + grounded AI content preparation.

Canonical documentation

All current architecture and engineering guidance is under:

Docs_v10/

Read these first:

  1. Documentation index
  2. Architecture
  3. Domain contracts
  4. Content authoring and delivery
  5. Assessment, mastery and learning
  6. Content ingestion and AI
  7. AI developer instructions
  8. Current repository state

The old docs/ directory is temporarily retained as historical source material while the documentation migration is verified. It is not authoritative for new development.

Core architectural flow

Interface
   ↓
Application use cases
   ↓
Domain rules
   ↑
Infrastructure adapters
   ↑
Composition root

Educational state:

Assessment → Evidence → Mastery → Learning

Important content rule

PUBLISHED means ready for learner use; it does not mean immutable.

Content may continue to be corrected and enriched after publication through the canonical authoring path.

Publication/readiness is separate from learning-path inclusion. A backend-owned learning-path control is the target contract for deciding whether a published lesson is eligible for guided progression.

Quick start

npm install
npm run db:dev
cp .env.example .env
npm run db:apply
npm run db:seed
npm run dev

Health:

curl localhost:3000/api/v1/health

Verification

Use the scripts actually defined in package.json:

npm run typecheck
npm run arch:check
npm test
npm run verify

Do not treat a green typecheck as proof that architecture, persistence, security, or the complete user flow is correct.

Repository rules

  • Prisma schema is the persistence source of truth.
  • One owner per business decision.
  • No duplicate write paths.
  • No Prisma/provider SDKs in domain/application.
  • Python/content engine never writes PostgreSQL.
  • AI never directly writes canonical educational state.
  • React renders backend decisions; it does not recreate them.
  • Historical learner data is protected.
  • Canonical keys never depend on order/index/position.
  • Imports are validated, deduplicated, dry-run capable and idempotent.

About

No description, website, or topics provided.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages