# kabil-8/workspace-lifecycle-management-system architecture

> Architecture diagram of the GitHub repository kabil-8/workspace-lifecycle-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kabil-8/workspace-lifecycle-management-system
- Repository: https://github.com/kabil-8/workspace-lifecycle-management-system

## Overview

EduSphere is a multi-role student lifecycle platform spanning learning, campus and career services, with personalized AI and analytics. The principal visible user journey is role-based entry into the frontend, navigation to learning or AI features, and presentation of course or student-intelligence experiences. Backend sources show academic and AI domain logic backed by MongoDB models, plus a separate Python ML service; however, the README is empty and server/API wiring was not inspected, so links across those boundaries are not asserted.

Main entry points: [`backend/src/ai/ContextFusionEngine.ts`](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/ai/ContextFusionEngine.ts) (Context fusion), [`backend/src/ai/RAGEngine.ts`](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/ai/RAGEngine.ts) (RAG retrieval), [`frontend/src/App.tsx`](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/frontend/src/App.tsx) (Role-based app), [`backend/src/ai/DigitalTwinEngine.ts`](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/ai/DigitalTwinEngine.ts) (Digital twin)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_app["Role-based app<br/>[App.tsx]"]
end

subgraph group_learning["Learning and academics"]
  node_learning_pages["Learning pages<br/>[CoursesPage.tsx]"]
  node_academic_records["Academic records"]
  node_course_data[("Course data<br/>[CollegeCourse.ts]")]
  node_user_data[("User profiles<br/>[User.ts]")]
end

subgraph group_eden["Eden intelligence"]
  node_ai_page["AI copilot<br/>[AICopilotPage.tsx]"]
  node_twin_engine["Digital twin"]
  node_twin_data[("Twin records")]
  node_context_fusion["Context fusion"]
  node_learning_dna["Learning DNA<br/>[LearningDNA.ts]"]
  node_knowledge_graph["Knowledge graph"]
  node_rag_engine["RAG retrieval<br/>[RAGEngine.ts]"]
  node_embedding["Embedding service"]
  node_ingestion["Document ingestion"]
  node_eden_memory["Eden memory<br/>[MemoryService.ts]"]
end

subgraph group_career["Career and assessment"]
  node_interview["Interview engine"]
  node_placement["Placement engine"]
end

subgraph group_ml["Machine learning"]
  node_feature_pipeline["Feature pipeline"]
  node_twin_service["Twin prediction service"]
end

node_student(("Student or staff"))

node_student -->|"opens"| node_app
node_app -->|"routes to"| node_learning_pages
node_app -->|"routes to"| node_ai_page
node_academic_records -->|"reads and writes"| node_course_data
node_context_fusion -->|"requests twin"| node_twin_engine
node_context_fusion -->|"uses"| node_learning_dna
node_context_fusion -->|"uses"| node_knowledge_graph
node_context_fusion -->|"uses"| node_rag_engine
node_context_fusion -->|"uses"| node_eden_memory
node_twin_engine -->|"reads and writes"| node_twin_data
node_twin_engine -->|"updates profile"| node_user_data
node_rag_engine -->|"generates vectors"| node_embedding
node_rag_engine -->|"ingests documents"| node_ingestion
node_eden_memory -->|"uses retrieval"| node_rag_engine
node_twin_service -->|"builds features"| node_feature_pipeline

click node_app "https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/frontend/src/App.tsx"
click node_learning_pages "https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/frontend/src/pages/academic/CoursesPage.tsx"
click node_ai_page "https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/frontend/src/pages/ai/AICopilotPage.tsx"
click node_academic_records "https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/controllers/academicResultController.ts"
click node_course_data "https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/models/CollegeCourse.ts"
click node_user_data "https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/models/User.ts"
click node_twin_engine "https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/ai/DigitalTwinEngine.ts"
click node_twin_data "https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/models/StudentDigitalTwin.ts"
click node_context_fusion "https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/ai/ContextFusionEngine.ts"
click node_learning_dna "https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/ai/LearningDNA.ts"
click node_knowledge_graph "https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/ai/KnowledgeGraphService.ts"
click node_rag_engine "https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/ai/RAGEngine.ts"
click node_embedding "https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/ai/rag/EmbeddingService.ts"
click node_ingestion "https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/ai/rag/DocumentIngestionService.ts"
click node_eden_memory "https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/ai/MemoryService.ts"
click node_interview "https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/ml_service/interview_engine.py"
click node_placement "https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/ml_service/placement_engine.py"
click node_feature_pipeline "https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/ml_service/pipeline/feature_pipeline.py"
click node_twin_service "https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/ml_service/services/digital_twin_service.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_app toneBlue
class node_learning_pages,node_academic_records,node_course_data,node_user_data toneAmber
class node_ai_page,node_twin_engine,node_twin_data,node_context_fusion,node_learning_dna,node_knowledge_graph,node_rag_engine,node_embedding,node_ingestion,node_eden_memory toneMint
class node_interview,node_placement toneRose
class node_feature_pipeline,node_twin_service,node_student toneIndigo
```

## Components

### User experience

- [Role-based app](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`

### Learning and academics

- [Learning pages](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/frontend/src/pages/academic/CoursesPage.tsx): `frontend/src/pages/academic/CoursesPage.tsx`
- [Academic records](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/controllers/academicResultController.ts): `backend/src/controllers/academicResultController.ts`
- [Course data](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/models/CollegeCourse.ts): `backend/src/models/CollegeCourse.ts`
- [User profiles](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/models/User.ts): `backend/src/models/User.ts`

### Eden intelligence

- [AI copilot](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/frontend/src/pages/ai/AICopilotPage.tsx): `frontend/src/pages/ai/AICopilotPage.tsx`
- [Digital twin](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/ai/DigitalTwinEngine.ts): `backend/src/ai/DigitalTwinEngine.ts`
- [Twin records](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/models/StudentDigitalTwin.ts): `backend/src/models/StudentDigitalTwin.ts`
- [Context fusion](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/ai/ContextFusionEngine.ts): `backend/src/ai/ContextFusionEngine.ts`
- [Learning DNA](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/ai/LearningDNA.ts): `backend/src/ai/LearningDNA.ts`
- [Knowledge graph](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/ai/KnowledgeGraphService.ts): `backend/src/ai/KnowledgeGraphService.ts`
- [RAG retrieval](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/ai/RAGEngine.ts): `backend/src/ai/RAGEngine.ts`
- [Embedding service](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/ai/rag/EmbeddingService.ts): `backend/src/ai/rag/EmbeddingService.ts`
- [Document ingestion](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/ai/rag/DocumentIngestionService.ts): `backend/src/ai/rag/DocumentIngestionService.ts`
- [Eden memory](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/backend/src/ai/MemoryService.ts): `backend/src/ai/MemoryService.ts`

### Career and assessment

- [Interview engine](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/ml_service/interview_engine.py): `ml_service/interview_engine.py`
- [Placement engine](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/ml_service/placement_engine.py): `ml_service/placement_engine.py`

### Machine learning

- [Feature pipeline](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/ml_service/pipeline/feature_pipeline.py): `ml_service/pipeline/feature_pipeline.py`
- [Twin prediction service](https://github.com/kabil-8/workspace-lifecycle-management-system/blob/main/ml_service/services/digital_twin_service.py): `ml_service/services/digital_twin_service.py`

### Other components

- **Student or staff**

## Connections

- Student or staff → Role-based app: opens (evidence: `frontend/src/App.tsx`)
- Role-based app → Learning pages: routes to (evidence: `frontend/src/App.tsx`)
- Role-based app → AI copilot: routes to (evidence: `frontend/src/App.tsx`)
- Academic records → Course data: reads and writes (evidence: `backend/src/controllers/academicResultController.ts`)
- Context fusion → Digital twin: requests twin (evidence: `backend/src/ai/ContextFusionEngine.ts`)
- Context fusion → Learning DNA: uses (evidence: `backend/src/ai/ContextFusionEngine.ts`)
- Context fusion → Knowledge graph: uses (evidence: `backend/src/ai/ContextFusionEngine.ts`)
- Context fusion → RAG retrieval: uses (evidence: `backend/src/ai/ContextFusionEngine.ts`)
- Context fusion → Eden memory: uses (evidence: `backend/src/ai/ContextFusionEngine.ts`)
- Digital twin → Twin records: reads and writes (evidence: `backend/src/ai/DigitalTwinEngine.ts`)
- Digital twin → User profiles: updates profile (evidence: `backend/src/ai/DigitalTwinEngine.ts`)
- RAG retrieval → Embedding service: generates vectors (evidence: `backend/src/ai/RAGEngine.ts`)
- RAG retrieval → Document ingestion: ingests documents (evidence: `backend/src/ai/RAGEngine.ts`)
- Eden memory → RAG retrieval: uses retrieval (evidence: `backend/src/ai/MemoryService.ts`)
- Twin prediction service → Feature pipeline: builds features (evidence: `ml_service/services/digital_twin_service.py`)
