ems.enrollment_close_wizard (models/enrollment/enrollment_close_wizard.py, issue #643).
Once the enrollment period is over, every enrollment still in draft or sent belongs to someone who never formalised it. What has to happen to that person depends on who they are, so the wizard resolves one action per person (not per enrollment), shows it in a preview and only applies it when confirmed.
| Where | Launched on | People considered |
|---|---|---|
Matrícules list, Actions → Close unconfirmed enrollments (header button action_ems_close_unconfirmed on sale.order) |
the selected enrollments | the customers of the selected draft/sent ones |
Pre-inscripció list, Actions → Close unconfirmed enrollments (same button on res.partner) |
the selected applicants | each of them, with or without an enrollment |
Both lists show their header buttons in the list “Actions” dropdown (see actions_dropdown.md); in Matrícules, next to “Send Enrollment”. The Pre-inscripció list also gets a Without enrollment filter (no draft, sent or confirmed enrollment), which is how the applicants imported from GEDAC who never got an offer are found.
Every draft/sent enrollment of a person is handled, not only the selected ones: a person is either
leaving or not. A person holds at most one live enrollment per course (the
sale_order_unique_enrollment_per_course index), so a confirmed enrollment is never one of the
pending ones: one for the running course or a later one means they are staying, even while still
waiting for a group (transition_status = 'unplaced'), and only the pending ones are cancelled.
The Without enrollment filter reads res.partner.ems_has_enrollment, a non-stored, searchable
boolean: any draft, sent or confirmed enrollment, whatever the course.
flowchart TD
P["Person with draft/sent enrollments<br/>(or a selected applicant)"] --> PAY{"Any of them with a payment,<br/>transaction or invoice?"}
PAY -- yes --> REV["review: nothing is touched"]
PAY -- no --> STAYS{"Student with a group, expelled,<br/>or a confirmed enrollment for the<br/>running course or a later one?"}
STAYS -- yes --> CAN["cancel: only the enrollments"]
STAYS -- no --> ST{"contact_type"}
ST -- student --> WD["withdraw: same steps as the<br/>withdrawal wizard"]
ST -- "alumni / withdrawal" --> CAN
ST -- applicant --> HIST{"Was a student before?<br/>(academic history or has_graduated)"}
HIST -- yes --> EX["ex_student: back to alumni (graduated)<br/>or withdrawal, exit data restored"]
HIST -- no --> TRACE{"Corporate account or<br/>convalidations?"}
TRACE -- yes --> ARC["archive: cancel, revoke portal, archive"]
TRACE -- no --> DEL["delete"]
| Action | Enrollments | Contact |
|---|---|---|
review |
untouched | untouched |
cancel |
cancelled | untouched |
withdraw |
cancelled | res.partner._ems_register_exit(), the withdrawal wizard’s own steps: exit data, academic history frozen, operational records cleared, alumni/withdrawal, Google grace period, portal revoked, archived |
ex_student |
cancelled | exit data restored from the newest academic history record that has one (exit_type, its course, exit_date); then _ems_leave_centre(): alumni if has_graduated, withdrawal otherwise, Google grace period, portal revoked, archived |
archive |
cancelled | portal revoked (family kept if another child is enrolled), archived |
delete |
deleted | portal revoked for the family as above; portal users deleted; the contact deleted with what cascades from it (authorizations, documents, bank accounts) |
An applicant who was a student before got there through sale.order._ems_offer_to_ex_student(),
which clears the exit data when the offer is sent; ex_student is its reverse.
A deletion runs in a savepoint: if anything still references the contact (a restricted foreign
key nobody foresaw), it falls back to archive and the summary lists it as an issue. The same
happens to an archive the portal revoke could not clear (see _ems_leave_centre()).
Cancellation uses sale.order._action_cancel(), Odoo’s own, which sends no email. The only emails
sent are the Google Workspace grace-period warnings of withdraw and ex_student.
Same as the withdrawal wizard (res.partner._ems_user_can_register_exits()): secretary, Head of
Studies, administrator. Anybody else gets a UserError on open and on apply.
The form (js_class="ems_enrollment_close_wizard_form", static/src/js/backend/
enrollment_close_wizard_form.js) is a blockingActionFormView: “Apply” locks the screen with a
message while it runs (see blocking_action_form.js for why there is no live counter).
preview_html (computed from the lines) gives the number of people and enrollments and,
per action, how many people get it and what it means.action_apply() reopens the wizard with result_html (people per action actually
applied, portals revoked, issues) and log_file, a CSV with one row per person (contact type,
enrollments, planned action, action applied, issues), downloaded on its own by the
auto_download_binary widget. A failed deletion shows as planned “Delete the person”, applied
“Archive”.