TNCSC_Odoo/addons/community_school/models/school_attendance.py
metatroncubeswdev 7ac5880f20 feat(community_school): core models + teacher attendance portal (Sessions 3-A, 3-B)
Session 3-A - core models: community.school.term, .level (admin-defined,
so the same module fits a Grade 1-12 school or a Beginner-Advanced
language school with no code change), .class (auto-creates a linked
slide.channel for LMS glue), .student, .enrollment, and .attendance, plus
is_teacher on res.partner. Class enrolled_count and enrollment
attendance_rate are stored/non-stored computes driven by the
enrollment/attendance one2many chains.

Session 3-B - teacher attendance + at-risk reporting: a portal page at
/school/attendance (auth='user', scoped to classes where teacher_id
matches the logged-in user's partner - works whether the teacher is an
internal or portal user) with a roster and batch save, built as a v19
Interaction (same pattern as event_qr_ticketing's check-in page). Marking
a student absent queues a configurable notice to the parent partner.
Enrollment.is_at_risk flags students below a configurable attendance
threshold (School settings page, same <app>/<block>/<setting> pattern as
community_membership), plus an admin pivot attendance report and an
At-Risk Students list.

Verified against a live Odoo 19 + Postgres 16 container: 14/14 automated
tests pass (class/slide-channel creation, enrolled_count tracking incl.
withdrawal, attendance_rate and at-risk computation, unique
enrollment+date constraint, absence email queuing), plus a full manual
live run - created a term/level/class/student/enrollment via JSON-RPC,
loaded the actual /school/attendance page as the teacher, POSTed a batch
save marking the student absent, and confirmed both the attendance record
and the queued "Absence notice" mail.mail record.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
2026-08-17 21:37:56 -04:00

32 lines
1.1 KiB
Python

from odoo import fields, models
class CommunitySchoolAttendance(models.Model):
_name = 'community.school.attendance'
_description = 'School Attendance'
_order = 'date desc, id desc'
enrollment_id = fields.Many2one('community.school.enrollment', required=True, ondelete='cascade')
class_id = fields.Many2one(related='enrollment_id.class_id', store=True)
date = fields.Date(required=True, default=fields.Date.context_today)
state = fields.Selection(
[
('present', 'Present'),
('absent', 'Absent'),
('late', 'Late'),
('excused', 'Excused'),
],
default='present', required=True,
)
notes = fields.Char()
_enrollment_date_uniq = models.Constraint(
'unique(enrollment_id, date)', 'Attendance for this student on this date is already recorded.',
)
def _send_absence_notice(self):
self.ensure_one()
template = self.env.ref('community_school.mail_template_absence_notice', raise_if_not_found=False)
if template:
template.send_mail(self.id, force_send=False)