# precisionwebai/educonnect architecture

> Architecture diagram of the GitHub repository precisionwebai/educonnect, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/precisionwebai/educonnect
- Repository: https://github.com/precisionwebai/educonnect

## Overview

Educonnect is a school-workflow platform: users work through admissions, teaching and classroom records, staff operations, and school services, with authentication and role-based permissions governing access. The backend’s FastAPI application mounts those domain APIs; the README also documents dashboards, finance, reports, chat, and AI-assisted exam-paper workflows. The sampled admission and RAG code shows parts of those domain stages, but most API-to-frontend and unsampled service relationships cannot be verified, so they are not drawn.

Main entry points: [`backend/app/main.py`](https://github.com/precisionwebai/educonnect/blob/development/backend/app/main.py) (FastAPI app), [`backend/app/domains/academic/classroom/exams/rag/ingest.py`](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/academic/classroom/exams/rag/ingest.py) (Exam source ingestion), [`backend/app/domains/auth/router.py`](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/auth/router.py) (Authentication API), [`backend/app/domains/auth/service.py`](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/auth/service.py) (Auth and permissions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Application entry"]
  node_api["FastAPI app<br/>[main.py]"]
end

subgraph group_identity["Identity and access"]
  node_auth_api["Authentication API<br/>[router.py]"]
  node_auth_service["Auth and permissions<br/>[service.py]"]
  node_security["Token security<br/>[security.py]"]
end

subgraph group_learning["Academic workflows"]
  node_academic_api["Academic API<br/>[api.py]"]
  node_classroom["Classroom services<br/>[service.py]"]
  node_course["Course planning<br/>[service.py]"]
  node_exam_rag["Exam source ingestion<br/>[ingest.py]"]
  node_rag_extract["Source extraction<br/>[extract.py]"]
  node_rag_chunk["Text chunking<br/>[chunking.py]"]
  node_rag_embed["Text embeddings<br/>[embeddings.py]"]
  node_rag_store[("Vector storage<br/>[store.py]")]
  node_frontend_paper["Paper builder<br/>[usePaperBuilder.ts]"]
end

subgraph group_school_ops["School operations"]
  node_operations_api["Operations API<br/>[api.py]"]
  node_admission["Student admission<br/>[service.py]"]
  node_people_api["People API<br/>[api.py]"]
  node_staff["Staff profiles<br/>[service.py]"]
  node_services_api["School services API<br/>[api.py]"]
  node_leave["Leave workflows<br/>[service.py]"]
  node_finance_api["Finance API<br/>[api.py]"]
  node_insights_api["Reports API<br/>[api.py]"]
  node_main_api["Dashboard and chat API<br/>[api.py]"]
  node_admin_api["Administration API<br/>[api.py]"]
  node_frontend_admission["Admission screen<br/>[useAdmission.ts]"]
  node_frontend_chat["Chat workflow<br/>[useChat.ts]"]
end

node_user(("School users"))

node_user -->|"uses"| node_api
node_api -->|"mounts"| node_auth_api
node_api -->|"mounts"| node_main_api
node_api -->|"mounts"| node_academic_api
node_api -->|"mounts"| node_people_api
node_api -->|"mounts"| node_finance_api
node_api -->|"mounts"| node_operations_api
node_api -->|"mounts"| node_services_api
node_api -->|"mounts"| node_insights_api
node_api -->|"mounts"| node_admin_api
node_auth_api -.->|"delegates to"| node_auth_service
node_auth_service -->|"uses tokens"| node_security
node_academic_api -.->|"routes to"| node_classroom
node_course -->|"uses academic data"| node_classroom
node_exam_rag -->|"extracts sources"| node_rag_extract
node_exam_rag -->|"chunks pages"| node_rag_chunk
node_exam_rag -->|"embeds chunks"| node_rag_embed
node_exam_rag -->|"upserts vectors"| node_rag_store
node_operations_api -.->|"routes to"| node_admission
node_people_api -.->|"routes to"| node_staff
node_services_api -.->|"routes to"| node_leave
node_frontend_admission -.->|"submits forms"| node_admission
node_frontend_chat -.->|"uses chat API"| node_main_api
node_frontend_paper -.->|"uses exam sources"| node_exam_rag

click node_api "https://github.com/precisionwebai/educonnect/blob/development/backend/app/main.py"
click node_academic_api "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/academic/api.py"
click node_classroom "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/academic/classroom/service.py"
click node_course "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/academic/classroom/course/service.py"
click node_exam_rag "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/academic/classroom/exams/rag/ingest.py"
click node_rag_extract "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/academic/classroom/exams/rag/extract.py"
click node_rag_chunk "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/academic/classroom/exams/rag/chunking.py"
click node_rag_embed "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/academic/classroom/exams/rag/embeddings.py"
click node_rag_store "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/academic/classroom/exams/rag/store.py"
click node_auth_api "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/auth/router.py"
click node_auth_service "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/auth/service.py"
click node_security "https://github.com/precisionwebai/educonnect/blob/development/backend/app/core/security.py"
click node_operations_api "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/operations/api.py"
click node_admission "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/operations/admission/service.py"
click node_people_api "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/people/api.py"
click node_staff "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/people/staff/service.py"
click node_services_api "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/services/api.py"
click node_leave "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/services/leave/service.py"
click node_finance_api "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/finance/api.py"
click node_insights_api "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/insights/api.py"
click node_main_api "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/main/api.py"
click node_admin_api "https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/admin/api.py"
click node_frontend_admission "https://github.com/precisionwebai/educonnect/blob/development/frontend/src/components/features/admission/useAdmission.ts"
click node_frontend_chat "https://github.com/precisionwebai/educonnect/blob/development/frontend/src/components/features/chat/useChat.ts"
click node_frontend_paper "https://github.com/precisionwebai/educonnect/blob/development/frontend/src/components/features/exams/paper-builder/usePaperBuilder.ts"

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_api,node_user toneBlue
class node_auth_api,node_auth_service,node_security toneAmber
class node_academic_api,node_classroom,node_course,node_exam_rag,node_rag_extract,node_rag_chunk,node_rag_embed,node_rag_store,node_frontend_paper toneMint
class node_operations_api,node_admission,node_people_api,node_staff,node_services_api,node_leave,node_finance_api,node_insights_api,node_main_api,node_admin_api,node_frontend_admission,node_frontend_chat toneRose
```

## Components

### Application entry

- [FastAPI app](https://github.com/precisionwebai/educonnect/blob/development/backend/app/main.py): `backend/app/main.py`

### Identity and access

- [Authentication API](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/auth/router.py): `backend/app/domains/auth/router.py`
- [Auth and permissions](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/auth/service.py): `backend/app/domains/auth/service.py`
- [Token security](https://github.com/precisionwebai/educonnect/blob/development/backend/app/core/security.py): `backend/app/core/security.py`

### Academic workflows

- [Academic API](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/academic/api.py): `backend/app/domains/academic/api.py`
- [Classroom services](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/academic/classroom/service.py): `backend/app/domains/academic/classroom/service.py`
- [Course planning](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/academic/classroom/course/service.py): `backend/app/domains/academic/classroom/course/service.py`
- [Exam source ingestion](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/academic/classroom/exams/rag/ingest.py): `backend/app/domains/academic/classroom/exams/rag/ingest.py`
- [Source extraction](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/academic/classroom/exams/rag/extract.py): `backend/app/domains/academic/classroom/exams/rag/extract.py`
- [Text chunking](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/academic/classroom/exams/rag/chunking.py): `backend/app/domains/academic/classroom/exams/rag/chunking.py`
- [Text embeddings](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/academic/classroom/exams/rag/embeddings.py): `backend/app/domains/academic/classroom/exams/rag/embeddings.py`
- [Vector storage](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/academic/classroom/exams/rag/store.py): `backend/app/domains/academic/classroom/exams/rag/store.py`
- [Paper builder](https://github.com/precisionwebai/educonnect/blob/development/frontend/src/components/features/exams/paper-builder/usePaperBuilder.ts): `frontend/src/components/features/exams/paper-builder/usePaperBuilder.ts`

### School operations

- [Operations API](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/operations/api.py): `backend/app/domains/operations/api.py`
- [Student admission](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/operations/admission/service.py): `backend/app/domains/operations/admission/service.py`
- [People API](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/people/api.py): `backend/app/domains/people/api.py`
- [Staff profiles](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/people/staff/service.py): `backend/app/domains/people/staff/service.py`
- [School services API](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/services/api.py): `backend/app/domains/services/api.py`
- [Leave workflows](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/services/leave/service.py): `backend/app/domains/services/leave/service.py`
- [Finance API](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/finance/api.py): `backend/app/domains/finance/api.py`
- [Reports API](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/insights/api.py): `backend/app/domains/insights/api.py`
- [Dashboard and chat API](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/main/api.py): `backend/app/domains/main/api.py`
- [Administration API](https://github.com/precisionwebai/educonnect/blob/development/backend/app/domains/admin/api.py): `backend/app/domains/admin/api.py`
- [Admission screen](https://github.com/precisionwebai/educonnect/blob/development/frontend/src/components/features/admission/useAdmission.ts): `frontend/src/components/features/admission/useAdmission.ts`
- [Chat workflow](https://github.com/precisionwebai/educonnect/blob/development/frontend/src/components/features/chat/useChat.ts): `frontend/src/components/features/chat/useChat.ts`

### Other components

- **School users**

## Connections

- School users → FastAPI app: uses
- FastAPI app → Authentication API: mounts (evidence: `backend/app/main.py`)
- FastAPI app → Dashboard and chat API: mounts (evidence: `backend/app/main.py`)
- FastAPI app → Academic API: mounts (evidence: `backend/app/main.py`)
- FastAPI app → People API: mounts (evidence: `backend/app/main.py`)
- FastAPI app → Finance API: mounts (evidence: `backend/app/main.py`)
- FastAPI app → Operations API: mounts (evidence: `backend/app/main.py`)
- FastAPI app → School services API: mounts (evidence: `backend/app/main.py`)
- FastAPI app → Reports API: mounts (evidence: `backend/app/main.py`)
- FastAPI app → Administration API: mounts (evidence: `backend/app/main.py`)
- Authentication API → Auth and permissions: delegates to
- Auth and permissions → Token security: uses tokens (evidence: `backend/app/domains/auth/service.py`)
- Academic API → Classroom services: routes to
- Course planning → Classroom services: uses academic data (evidence: `backend/app/domains/academic/classroom/course/service.py`)
- Exam source ingestion → Source extraction: extracts sources (evidence: `backend/app/domains/academic/classroom/exams/rag/ingest.py`)
- Exam source ingestion → Text chunking: chunks pages (evidence: `backend/app/domains/academic/classroom/exams/rag/ingest.py`)
- Exam source ingestion → Text embeddings: embeds chunks (evidence: `backend/app/domains/academic/classroom/exams/rag/ingest.py`)
- Exam source ingestion → Vector storage: upserts vectors (evidence: `backend/app/domains/academic/classroom/exams/rag/ingest.py`)
- Operations API → Student admission: routes to
- People API → Staff profiles: routes to
- School services API → Leave workflows: routes to
- Admission screen → Student admission: submits forms
- Chat workflow → Dashboard and chat API: uses chat API
- Paper builder → Exam source ingestion: uses exam sources
