OS Education
School management for Odoo 18 with clear academic setup, student enrollment, grade entry, result computation, CSV import, and bilingual report cards.
Models As Containers
Read it top to bottom: each box is a model, and the models nested inside it are the records it holds. The dashed line on every box is a real sample record so you can see the data at a glance.
os.edu.school
Top container. Holds the identity printed on every report and opens onto the whole academic setup.
res.config.settings — default split-PDF behavior for report cards.Sample: split PDF = onos.edu.academic.year
Groups one school year: its time structure and all operational records.
os.edu.term — belongs to this year, holds term number and dates.Sample: Term 1 (Sep–Dec)os.edu.grade.level — stage, code, Arabic name, sequence.Sample: Grade 5 (Primary)os.edu.subject — max grade, passing grade, behavior flag; attached to grade levels.Sample: Mathematics, max 100 / pass 50os.edu.exam.supervisor — supervisor signature tied to year & term.Sample: Mr. Khalid, Term 1os.edu.classroom
The working container for class operations: grade level + year + section + teacher + capacity.
os.edu.student
Brings together profile, yearly registration, marks, and report cards.
os.edu.enrollment — places the student in a year, grade & class (one per year).Sample: Grade 5, 2026–2027, Class ASubject marks turn into one publishable result for the term.
os.edu.grade.entry — one student × one subject × one term; computes pass & letter.Sample: Math 92 / 100 → A, Passedos.edu.term.result — totals, average, rank, state, certificate; built from the entries above.Sample: avg 91.40%, rank 3, PublishedTemporary containers for safe batch actions across the records above.
os.edu.grade.import.wizard — CSV grades by term, class, subject, student code.Sample: import 28 rows → Term 1, Mathos.edu.result.compute.wizard — builds/updates term results and assigns ranks.Sample: compute Grade 5–A, Term 1os.edu.certificate.wizard — prints report cards as one PDF or split PDFs in a ZIP.Sample: 28 cards → ZIPAcademic Workflow
Application Guide
1. Prepare the School Setup
- Create the school profile with English and Arabic names, license information, curriculum, logo, certificate header images, stamp, principal name, and official signatures.
- Create the academic year, including Gregorian dates, Hijri year, number of weeks, number of terms, and year state.
- Create each academic term under the selected academic year, with start date, end date, and term number.
- Define grade levels such as Primary, Intermediate, and Secondary. Add Arabic names, short codes, and display sequence for clean ordering.
- Create classrooms or sections by combining academic year, grade level, section name, teacher, and capacity.
- Create subjects with English and Arabic names, default maximum grade, passing grade, sequence, and the grade levels where each subject is taught.
2. Manage Students And Enrollment
- Create student profiles with English and Arabic names, photo, nationality, identity details, date of birth, admission date, gender, and current status.
- The app automatically assigns each new student a student code using the
os.edu.studentsequence. - Assign the current grade level and classroom so the student appears in the correct class navigation and reports.
- Create enrollment records to place students into an academic year, grade level, and classroom.
- Each student can have only one enrollment per academic year, which keeps yearly registration clean and prevents duplicate academic records.
3. Enter Grades
- Use Student Grade Entry to record each student's grade for a subject and term.
- The grade entry carries the student, subject, term, academic year, classroom, maximum grade, passing grade, actual grade, pass result, and letter grade.
- When a subject is selected, the default maximum and passing grades are copied from the subject setup.
- The app prevents negative grades and blocks grades higher than the maximum grade.
- Use the CSV import wizard for bulk entry. The import reads student codes and grades, then creates new grade entries or updates existing entries for the same student, subject, and term.
4. Compute Results And Print Report Cards
- Use the Compute Term Results wizard after grade entries are ready for a term.
- The wizard collects grade entries by term and optional classroom, then creates or updates student term result records.
- Term results calculate total grade, maximum total, average percentage, average letter, rank, absence days, and publication state.
- Managers can confirm or publish results, then print the bilingual report card from the result record.
- The Certificate Wizard prints report cards in batches and can download one merged PDF or a ZIP containing separate PDF files per student.
Roles And Permissions
The daily operator role. Users can view the academic setup and work with student, enrollment, and grade-entry records without deleting operational data.
The academic administration role. Managers inherit User permissions and can maintain all academic records, compute results, and print batch certificates.
The highest education role. Administrators inherit Manager permissions and are intended for users who own module configuration and school-level governance.
All Models At A Glance
- Stores school identity, curriculum, logo, certificate header images, stamp, and signatures.
- Navigation counts for students, classrooms, subjects, and results.
- Controls year dates, Hijri year, weeks, terms, and state.
- Parent for terms, classrooms, enrollments, grade entries, and results.
- Belongs to an academic year and stores term number and dates.
- Links grade entries, term results, and exam supervisors.
- Defines primary, intermediate, and secondary levels.
- Connects classrooms, students, enrollments, and subjects.
- Combines grade level, academic year, section, teacher, and capacity.
- Groups students, enrollments, grade entries, and results.
- Stores English/Arabic names, code, max grade, and passing grade.
- Can be assigned to multiple grade levels.
- Tracks student code, personal data, nationality, class, grade, and contact.
- Uses chatter and activities for academic administration follow-up.
- Links a student to an academic year, grade level, and classroom.
- Prevents duplicate enrollment for the same student and academic year.
- Stores supervisor name, signature, academic year, and term.
- Provides shortcuts to term grade entries and results.
- Records student, subject, term, year, classroom, grade, and pass status.
- Computes letter grades and validates grades against maximum marks.
- Summarizes grade entries into totals, averages, letters, rank, and absence days.
- Supports draft, confirmed, and published states plus certificate tracking.
- Adds the default option for split PDF report card downloads.
- Stores the setting in
os_edu.report_cards_split_pdf.
- Imports CSV grades by term, classroom, subject, and student code.
- Creates or updates grade entries and reports row-level errors.
- Builds or updates term results from existing grade entries.
- Can confirm or publish results and assign classroom ranks.
- Selects term results for batch report card printing.
- Can download one merged PDF or separate PDFs inside a ZIP file.
Key Relationship Fields
| Source Model | Relationship Fields | Target Models |
|---|---|---|
os.edu.academic.year |
term_ids |
os.edu.term |
os.edu.term |
academic_year_id |
os.edu.academic.year |
os.edu.classroom |
grade_level_id, academic_year_id, teacher_id |
os.edu.grade.level, os.edu.academic.year, hr.employee |
os.edu.student |
current_classroom_id, current_grade_id, partner_id, enrollment_ids |
os.edu.classroom, os.edu.grade.level, res.partner, os.edu.enrollment |
os.edu.enrollment |
student_id, academic_year_id, grade_level_id, classroom_id |
os.edu.student, os.edu.academic.year, os.edu.grade.level, os.edu.classroom |
os.edu.subject |
grade_level_ids |
os.edu.grade.level |
os.edu.grade.entry |
student_id, subject_id, term_id, academic_year_id, classroom_id |
os.edu.student, os.edu.subject, os.edu.term, os.edu.academic.year, os.edu.classroom |
os.edu.term.result |
student_id, term_id, academic_year_id, classroom_id |
os.edu.student, os.edu.term, os.edu.academic.year, os.edu.classroom |
os.edu.exam.supervisor |
academic_year_id, term_id |
os.edu.academic.year, os.edu.term |
os.edu.grade.import.wizard |
term_id, classroom_id, subject_id |
os.edu.term, os.edu.classroom, os.edu.subject |
os.edu.result.compute.wizard |
academic_year_id, term_id, classroom_id |
os.edu.academic.year, os.edu.term, os.edu.classroom |
os.edu.certificate.wizard |
term_id, classroom_id, result_ids |
os.edu.term, os.edu.classroom, os.edu.term.result |
Legend
Setup
- School structure and academic configuration.
People
- Students, enrollment, and supervisory records.
Assessment
- Grade entry and result computation records.
Wizards
- Transient tools for import, compute, and print workflows.
Please log in to comment on this module