# openeducat/openeducat_erp architecture

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

- Interactive diagram: https://gitdiagram.com/openeducat/openeducat_erp
- Repository: https://github.com/openeducat/openeducat_erp

## Overview

OpenEduCat Community Edition is a modular educational ERP for institutional administration. A principal workflow begins with an admission application, creates or links a student record, and can generate a fee invoice; academic modules separately manage courses, schedules, attendance, examinations, and results. The tree and excerpts support these stages and several additional product branches. Evidence is limited to the README, SOURCE INDEX, and sampled excerpts, so unsampled module relationships are not asserted.

Main entry points: [`openeducat_core/models/student.py`](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_core/models/student.py) (Student records), [`openeducat_admission/models/admission.py`](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_admission/models/admission.py) (Admissions), [`openeducat_attendance/models/attendance_session.py`](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_attendance/models/attendance_session.py) (Attendance), [`openeducat_fees/models/student.py`](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_fees/models/student.py) (Fee management)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_admissions["Admissions &amp; Finance"]
  node_admission["Admissions<br/>[admission.py]"]
  node_fees["Fee management<br/>[student.py]"]
  node_invoice[("Accounting invoices")]
end

subgraph group_academics["Academic Records"]
  node_student[("Student records<br/>[student.py]")]
  node_course[("Courses &amp; batches<br/>[course.py]")]
  node_program["Programs<br/>[program.py]"]
  node_migration["Student migration"]
end

subgraph group_operations["Learning Operations"]
  node_timetable["Timetable sessions<br/>[timetable.py]"]
  node_session_confirm["Session confirmation"]
  node_attendance["Attendance"]
  node_exams["Exam sessions<br/>[exam_session.py]"]
  node_assignment["Assignments<br/>[assignment.py]"]
end

subgraph group_services["Institution Services"]
  node_parent["Parent relationships<br/>[parent.py]"]
  node_library["Library lending<br/>[media_movement.py]"]
  node_classroom["Classrooms &amp; assets<br/>[classroom.py]"]
  node_facility["Facilities<br/>[facility.py]"]
end

subgraph group_insight["Reports &amp; Analytics"]
  node_reporting["Reports &amp; analytics"]
  node_attendance_report["Attendance reports"]
end

node_institution(("Institution staff"))

node_institution -->|"manages enrollment"| node_admission
node_institution -->|"manages profiles"| node_student
node_institution -->|"organizes courses"| node_course
node_institution -->|"manages schedules"| node_timetable
node_institution -->|"tracks attendance"| node_attendance
node_institution -->|"manages exams"| node_exams
node_institution -->|"collects fees"| node_fees
node_institution -->|"manages lending"| node_library
node_institution -.->|"manages assignments"| node_assignment
node_institution -.->|"manages relationships"| node_parent
node_institution -.->|"manages classrooms"| node_classroom
node_institution -.->|"manages facilities"| node_facility
node_institution -->|"reviews results"| node_reporting
node_admission -->|"creates student"| node_student
node_admission -->|"creates invoice"| node_invoice
node_fees -->|"creates invoice"| node_invoice
node_program -.->|"organizes courses"| node_course
node_migration -->|"updates enrollment"| node_student
node_session_confirm -->|"confirms sessions"| node_timetable
node_attendance -.->|"records attendance"| node_student
node_exams -.->|"produces results"| node_reporting
node_attendance -.->|"supports reporting"| node_attendance_report

click node_admission "https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_admission/models/admission.py"
click node_student "https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_core/models/student.py"
click node_fees "https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_fees/models/student.py"
click node_course "https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_core/models/course.py"
click node_program "https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_core/models/program.py"
click node_migration "https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_activity/wizard/student_migrate_wizard.py"
click node_timetable "https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_timetable/models/timetable.py"
click node_session_confirm "https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_timetable/wizard/session_confirmation.py"
click node_attendance "https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_attendance/models/attendance_session.py"
click node_exams "https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_exam/models/exam_session.py"
click node_assignment "https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_assignment/models/assignment.py"
click node_parent "https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_parent/models/parent.py"
click node_library "https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_library/models/media_movement.py"
click node_classroom "https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_classroom/models/classroom.py"
click node_facility "https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_facility/models/facility.py"
click node_reporting "https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_exam/report/student_marksheet.py"
click node_attendance_report "https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_attendance/report/student_attendance_report.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_admission,node_fees,node_invoice toneBlue
class node_student,node_course,node_program,node_migration toneAmber
class node_timetable,node_session_confirm,node_attendance,node_exams,node_assignment toneMint
class node_parent,node_library,node_classroom,node_facility toneRose
class node_reporting,node_attendance_report,node_institution toneIndigo
```

## Components

### Admissions & Finance

- [Admissions](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_admission/models/admission.py): `openeducat_admission/models/admission.py`
- [Fee management](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_fees/models/student.py): `openeducat_fees/models/student.py`
- **Accounting invoices**

### Academic Records

- [Student records](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_core/models/student.py): `openeducat_core/models/student.py`
- [Courses & batches](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_core/models/course.py): `openeducat_core/models/course.py`
- [Programs](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_core/models/program.py): `openeducat_core/models/program.py`
- [Student migration](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_activity/wizard/student_migrate_wizard.py): `openeducat_activity/wizard/student_migrate_wizard.py`

### Learning Operations

- [Timetable sessions](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_timetable/models/timetable.py): `openeducat_timetable/models/timetable.py`
- [Session confirmation](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_timetable/wizard/session_confirmation.py): `openeducat_timetable/wizard/session_confirmation.py`
- [Attendance](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_attendance/models/attendance_session.py): `openeducat_attendance/models/attendance_session.py`
- [Exam sessions](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_exam/models/exam_session.py): `openeducat_exam/models/exam_session.py`
- [Assignments](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_assignment/models/assignment.py): `openeducat_assignment/models/assignment.py`

### Institution Services

- [Parent relationships](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_parent/models/parent.py): `openeducat_parent/models/parent.py`
- [Library lending](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_library/models/media_movement.py): `openeducat_library/models/media_movement.py`
- [Classrooms & assets](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_classroom/models/classroom.py): `openeducat_classroom/models/classroom.py`
- [Facilities](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_facility/models/facility.py): `openeducat_facility/models/facility.py`

### Reports & Analytics

- [Reports & analytics](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_exam/report/student_marksheet.py): `openeducat_exam/report/student_marksheet.py`
- [Attendance reports](https://github.com/openeducat/openeducat_erp/blob/19.0/openeducat_attendance/report/student_attendance_report.py): `openeducat_attendance/report/student_attendance_report.py`

### Other components

- **Institution staff**

## Connections

- Institution staff → Admissions: manages enrollment
- Institution staff → Student records: manages profiles
- Institution staff → Courses & batches: organizes courses
- Institution staff → Timetable sessions: manages schedules
- Institution staff → Attendance: tracks attendance
- Institution staff → Exam sessions: manages exams
- Institution staff → Fee management: collects fees
- Institution staff → Library lending: manages lending
- Institution staff → Assignments: manages assignments
- Institution staff → Parent relationships: manages relationships
- Institution staff → Classrooms & assets: manages classrooms
- Institution staff → Facilities: manages facilities
- Institution staff → Reports & analytics: reviews results
- Admissions → Student records: creates student (evidence: `openeducat_admission/models/admission.py`)
- Admissions → Accounting invoices: creates invoice (evidence: `openeducat_admission/models/admission.py`)
- Fee management → Accounting invoices: creates invoice (evidence: `openeducat_fees/models/student.py`)
- Programs → Courses & batches: organizes courses
- Student migration → Student records: updates enrollment (evidence: `openeducat_activity/wizard/student_migrate_wizard.py`)
- Session confirmation → Timetable sessions: confirms sessions (evidence: `openeducat_timetable/wizard/session_confirmation.py`)
- Attendance → Student records: records attendance
- Exam sessions → Reports & analytics: produces results
- Attendance → Attendance reports: supports reporting
