feat: institutional + support + training admin sections (backend + frontend)

Ship three fully-wired admin areas end-to-end with APIs, seeds, tests and docs.

Backend (new `encoach_lms_api` addon + existing addons):
- Institutional: academic years/terms, departments, admission registers & admissions,
  courses/batches, lessons, fees (terms + student fees + invoicing with income-account
  auto-wiring), gradebook (assignments/grades), library, facilities (encoach.asset),
  student leave, result templates + marksheets (incl. delete-with-cascade).
- Support: `encoach.ticket` model + CRUD/assignee routes; payment records derived
  from `op.student.fees.details` and `account.move`; platform settings backed by
  `encoach.code` and `ir.config_parameter` (packages + grading config).
- Training: `encoach.vocab.item` + `encoach.grammar.rule` (plus progress models)
  with CRUD, pagination, search/level filters, and upsert-style progress endpoints.
  Odoo 19 compatibility: `_sql_constraints` replaced with `@api.constrains`;
  `ValidationError`/`UserError` mapped to HTTP 400.

Frontend:
- Rewire institutional admin pages (Academic Year Manager, Admissions, Courses,
  Lessons, Fees, Gradebook, Library, Facilities, Student Leave, Marksheets,
  Taxonomy, Resources) to real APIs with React Query invalidation and dialogs.
- New typed services: `payments.service.ts`, `platformSettings.service.ts`,
  `training.service.ts`. Updated `fees/gradebook/lms/courseware/taxonomy/
  resources/student-progress/generation` services + related types.
- Rewrite `VocabularyPage`, `GrammarPage`, `PaymentRecordPage`, `SettingsPage`,
  `TicketsPage` to consume live data with search/filter/progress/CRUD flows.
- New shared components: `TaxonomyCascade`, `MaterialViewer`, `teacher/TeacherLibrary`.
- Favicons/branding assets and misc. UX polish across teacher/student pages.

Tooling & QA:
- Seeders: `seed_demo.py`, `seed_demo_data.py`, `seed_institutional.py` (idempotent,
  covers institutional + support + training fixtures incl. income-account wiring).
- API write-flow test suites: `test_write_flows.py` (institutional),
  `test_support_flows.py` (support), `test_training_flows.py` (training),
  `test_ai_full.py`. All suites pass end-to-end.
- Docs: add `docs/PROJECT_SUMMARY.md` with per-section scope, artifacts and QA.
- `.gitignore`: ignore `pgdata_bak_*/`, `frontend/.vite/`, `frontend/dist/`,
  `frontend/node_modules/`.

Made-with: Cursor
This commit is contained in:
Yamen Ahmad
2026-04-19 03:13:23 +04:00
parent 74d83af57f
commit 6ec68160c8
59 changed files with 9076 additions and 143 deletions

View File

@@ -1 +1,2 @@
from . import resource
from . import resource_tag

View File

@@ -19,7 +19,16 @@ class EncoachResource(models.Model):
('rejected', 'Rejected'),
], default='approved')
subject_id = fields.Many2one('encoach.subject', ondelete='set null')
domain_id = fields.Many2one('encoach.domain', ondelete='set null', string='Domain')
topic_ids = fields.Many2many('encoach.topic')
learning_objective_ids = fields.Many2many(
'encoach.learning.objective', 'encoach_resource_obj_rel',
'resource_id', 'objective_id', string='Learning Objectives',
)
tag_ids = fields.Many2many(
'encoach.resource.tag', 'encoach_resource_tag_rel',
'resource_id', 'tag_id', string='Tags',
)
file = fields.Binary(attachment=True)
url = fields.Char()
difficulty = fields.Selection([
@@ -39,6 +48,22 @@ class EncoachResource(models.Model):
approved = fields.Boolean(default=False)
ielts_certified = fields.Boolean(default=False)
def _get_course_count(self):
Mat = self.env.get('encoach.chapter.material')
if Mat is None:
for rec in self:
rec.course_count = 0
return
Mat = self.env['encoach.chapter.material'].sudo()
for rec in self:
mats = Mat.search([('resource_id', '=', rec.id)])
rec.course_count = len(set(
m.chapter_id.course_id.id for m in mats
if m.chapter_id and m.chapter_id.course_id
))
course_count = fields.Integer(compute='_get_course_count')
def to_api_dict(self):
self.ensure_one()
creator = self.creator_id
@@ -48,8 +73,13 @@ class EncoachResource(models.Model):
'type': self.type or '',
'resource_type': self.type or 'document',
'subject_id': self.subject_id.id if self.subject_id else None,
'subject_name': self.subject_id.name if self.subject_id else '',
'domain_id': self.domain_id.id if self.domain_id else None,
'domain_name': self.domain_id.name if self.domain_id else '',
'topic_ids': self.topic_ids.ids,
'topic_names': self.topic_ids.mapped('name'),
'learning_objective_ids': self.learning_objective_ids.ids,
'learning_objective_names': self.learning_objective_ids.mapped('name'),
'url': self.url or '',
'has_file': bool(self.file),
'difficulty': self.difficulty or '',
@@ -61,8 +91,12 @@ class EncoachResource(models.Model):
'cefr_level': self.cefr_level or '',
'grammar_topic': self.grammar_topic or '',
'vocab_band': self.vocab_band or '',
'tag_ids': self.tag_ids.ids,
'tag_names': self.tag_ids.mapped('name'),
'tags': [{'id': t.id, 'name': t.name, 'color': t.color or '#6b7280'} for t in self.tag_ids],
'ai_generated': self.ai_generated,
'approved': self.approved,
'course_count': self.course_count,
'created_at': self.create_date.isoformat() if self.create_date else '',
'file_name': self.name,
}

View File

@@ -0,0 +1,30 @@
from odoo import models, fields
class EncoachResourceTag(models.Model):
_name = 'encoach.resource.tag'
_description = 'Resource Tag'
_order = 'name'
name = fields.Char(required=True, index=True)
color = fields.Char(size=20, help='Hex color code for UI badge, e.g. #3b82f6')
description = fields.Text()
active = fields.Boolean(default=True)
resource_ids = fields.Many2many(
'encoach.resource', 'encoach_resource_tag_rel',
'tag_id', 'resource_id', string='Resources',
)
_sql_constraints = [
('name_uniq', 'unique(name)', 'Tag name must be unique.'),
]
def to_api_dict(self):
self.ensure_one()
return {
'id': self.id,
'name': self.name,
'color': self.color or '#6b7280',
'description': self.description or '',
'resource_count': len(self.resource_ids),
}