How precisionwebai/educonnect works
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: main.py FastAPI app · ingest.py Exam source ingestion · router.py Authentication API · service.py Auth and permissions
Components 26
Application entry
- FastAPI app
backend/app/main.py
Identity and access
- Authentication API
backend/app/domains/auth/router.py - Auth and permissions
backend/app/domains/auth/service.py - Token security
backend/app/core/security.py
Academic workflows
- Academic API
backend/app/domains/academic/api.py - Classroom services
backend/app/domains/academic/classroom/service.py - Course planning
backend/app/domains/academic/classroom/course/service.py - Exam source ingestion
backend/app/domains/academic/classroom/exams/rag/ingest.py - Source extraction
backend/app/domains/academic/classroom/exams/rag/extract.py - Text chunking
backend/app/domains/academic/classroom/exams/rag/chunking.py - Text embeddings
backend/app/domains/academic/classroom/exams/rag/embeddings.py - Vector storage
backend/app/domains/academic/classroom/exams/rag/store.py - Paper builder
frontend/src/components/features/exams/paper-builder/usePaperBuilder.ts
School operations
- Operations API
backend/app/domains/operations/api.py - Student admission
backend/app/domains/operations/admission/service.py - People API
backend/app/domains/people/api.py - Staff profiles
backend/app/domains/people/staff/service.py - School services API
backend/app/domains/services/api.py - Leave workflows
backend/app/domains/services/leave/service.py - Finance API
backend/app/domains/finance/api.py - Reports API
backend/app/domains/insights/api.py - Dashboard and chat API
backend/app/domains/main/api.py - Administration API
backend/app/domains/admin/api.py - Admission screen
frontend/src/components/features/admission/useAdmission.ts - Chat workflow
frontend/src/components/features/chat/useChat.ts
Other components
- School users
Connections 24
- School users → FastAPI app: uses
- FastAPI app → Authentication API: mounts
backend/app/main.py - FastAPI app → Dashboard and chat API: mounts
backend/app/main.py - FastAPI app → Academic API: mounts
backend/app/main.py - FastAPI app → People API: mounts
backend/app/main.py - FastAPI app → Finance API: mounts
backend/app/main.py - FastAPI app → Operations API: mounts
backend/app/main.py - FastAPI app → School services API: mounts
backend/app/main.py - FastAPI app → Reports API: mounts
backend/app/main.py - FastAPI app → Administration API: mounts
backend/app/main.py - Authentication API → Auth and permissions: delegates to
- Auth and permissions → Token security: uses tokens
backend/app/domains/auth/service.py - Academic API → Classroom services: routes to
- Course planning → Classroom services: uses academic data
backend/app/domains/academic/classroom/course/service.py - Exam source ingestion → Source extraction: extracts sources
backend/app/domains/academic/classroom/exams/rag/ingest.py - Exam source ingestion → Text chunking: chunks pages
backend/app/domains/academic/classroom/exams/rag/ingest.py - Exam source ingestion → Text embeddings: embeds chunks
backend/app/domains/academic/classroom/exams/rag/ingest.py - Exam source ingestion → Vector storage: upserts vectors
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