devops/encoach_backend_new_v2
1
0
Fork 0
Code Issues Pull Requests 3 Actions Packages Projects Releases Wiki Activity

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

Browse Source 
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
Download Patch File Download Diff File Expand all files Collapse all files

344
custom_addons/encoach_taxonomy/controllers/taxonomy.py
View File

@@ -22,39 +22,331 @@ PARENT_FIELD_MAP = {
}
def _subject_dict(s):
return {
'id': s.id,
'name': s.name,
'code': s.code or '',
'description': s.description or '',
'is_active': s.active,
'active': s.active,
'domain_count': len(s.domain_ids),
'topic_count': sum(len(d.topic_ids) for d in s.domain_ids),
'course_count': s.course_count if hasattr(s, 'course_count') else 0,
'resource_count': s.resource_count if hasattr(s, 'resource_count') else 0,
'mastery_threshold': 80,
'grading_scale': 'percentage',
'diagnostic_config': {
'questions_per_domain': 5,
'total_question_cap': 30,
'time_limit_minutes': 45,
'starting_difficulty': 'medium',
'mastery_per_correct': 10,
'mastery_per_incorrect': -5,
},
}
def _domain_dict(d):
return {
'id': d.id,
'name': d.name,
'code': '',
'subject_id': d.subject_id.id,
'subject_name': d.subject_id.name,
'sequence': d.sequence,
'description': d.description or '',
'topic_count': len(d.topic_ids),
}
def _topic_dict(t):
return {
'id': t.id,
'name': t.name,
'code': '',
'domain_id': t.domain_id.id,
'domain_name': t.domain_id.name,
'description': t.description or '',
'difficulty_level': 'medium',
'estimated_hours': 1,
'prerequisite_ids': [],
'prerequisite_names': [],
'question_type_weights': {},
'objective_count': len(t.learning_objective_ids),
'resource_count': t.resource_count if hasattr(t, 'resource_count') else 0,
'chapter_count': t.chapter_count if hasattr(t, 'chapter_count') else 0,
}
def _objective_dict(o):
return {
'id': o.id,
'name': o.name,
'topic_id': o.topic_id.id,
'bloom_level': o.bloom_level or 'remember',
'sequence': o.sequence if hasattr(o, 'sequence') else 0,
}
class EncoachTaxonomyController(http.Controller):
# ------------------------------------------------------------------
# GET /api/taxonomy/subjects
# ------------------------------------------------------------------
@http.route('/api/taxonomy/subjects', type='http', auth='none',
methods=['GET'], csrf=False)
# ══════════════════════════════════════════════════════════════════
# SUBJECTS /api/subjects
# ══════════════════════════════════════════════════════════════════
@http.route(['/api/subjects', '/api/taxonomy/subjects'], type='http',
auth='public', methods=['GET'], csrf=False)
@jwt_required
def get_subjects(self, **kw):
def list_subjects(self, **kw):
try:
Subject = request.env['encoach.subject'].sudo()
subjects = Subject.search([('active', '=', True)])
items = []
for s in subjects:
items.append({
'id': s.id,
'name': s.name,
'code': s.code or '',
'description': s.description or '',
'domain_count': len(s.domain_ids),
})
return _json_response({'subjects': items})
recs = request.env['encoach.subject'].sudo().search([])
items = [_subject_dict(s) for s in recs]
return _json_response({'data': items, 'subjects': items})
except Exception as e:
_logger.exception('get_subjects failed')
_logger.exception('list_subjects')
return _error_response(str(e), 500)
# ------------------------------------------------------------------
# GET /api/taxonomy/tree
# ------------------------------------------------------------------
@http.route('/api/taxonomy/tree', type='http', auth='none',
@http.route('/api/subjects/<int:sid>', type='http',
auth='public', methods=['GET'], csrf=False)
@jwt_required
def get_subject(self, sid, **kw):
try:
rec = request.env['encoach.subject'].sudo().browse(sid)
if not rec.exists():
return _error_response('Subject not found', 404)
return _json_response({'data': _subject_dict(rec)})
except Exception as e:
return _error_response(str(e), 500)
@http.route('/api/subjects', type='http', auth='public',
methods=['POST'], csrf=False)
@jwt_required
def create_subject(self, **kw):
try:
body = _get_json_body()
vals = {'name': body.get('name', ''), 'code': body.get('code', '')}
if body.get('description'):
vals['description'] = body['description']
rec = request.env['encoach.subject'].sudo().create(vals)
return _json_response(_subject_dict(rec), 201)
except Exception as e:
return _error_response(str(e), 500)
@http.route('/api/subjects/<int:sid>', type='http', auth='public',
methods=['PATCH', 'PUT'], csrf=False)
@jwt_required
def update_subject(self, sid, **kw):
try:
rec = request.env['encoach.subject'].sudo().browse(sid)
if not rec.exists():
return _error_response('Not found', 404)
body = _get_json_body()
vals = {}
for k in ('name', 'code', 'description'):
if k in body:
vals[k] = body[k]
if 'is_active' in body:
vals['active'] = bool(body['is_active'])
if vals:
rec.write(vals)
return _json_response(_subject_dict(rec))
except Exception as e:
return _error_response(str(e), 500)
@http.route('/api/subjects/<int:sid>', type='http', auth='public',
methods=['DELETE'], csrf=False)
@jwt_required
def delete_subject(self, sid, **kw):
try:
rec = request.env['encoach.subject'].sudo().browse(sid)
if rec.exists():
rec.unlink()
return _json_response({'success': True})
except Exception as e:
return _error_response(str(e), 500)
@http.route('/api/subjects/<int:sid>/taxonomy', type='http',
auth='public', methods=['GET'], csrf=False)
@jwt_required
def get_subject_taxonomy(self, sid, **kw):
try:
s = request.env['encoach.subject'].sudo().browse(sid)
if not s.exists():
return _error_response('Subject not found', 404)
domains = []
for d in s.domain_ids:
topics = []
for t in d.topic_ids:
objectives = [_objective_dict(o) for o in t.learning_objective_ids]
td = _topic_dict(t)
td['objectives'] = objectives
topics.append(td)
dd = _domain_dict(d)
dd['topics'] = topics
domains.append(dd)
result = _subject_dict(s)
result['domains'] = domains
return _json_response({'data': {'subject': _subject_dict(s), 'domains': domains}})
except Exception as e:
_logger.exception('get_subject_taxonomy')
return _error_response(str(e), 500)
# ══════════════════════════════════════════════════════════════════
# DOMAINS /api/domains
# ══════════════════════════════════════════════════════════════════
@http.route('/api/domains', type='http', auth='public',
methods=['GET'], csrf=False)
@jwt_required
def list_domains(self, **kw):
try:
domain_filter = []
if kw.get('subject_id'):
domain_filter.append(('subject_id', '=', int(kw['subject_id'])))
recs = request.env['encoach.domain'].sudo().search(domain_filter)
return _json_response({'data': [_domain_dict(d) for d in recs]})
except Exception as e:
return _error_response(str(e), 500)
@http.route('/api/domains', type='http', auth='public',
methods=['POST'], csrf=False)
@jwt_required
def create_domain(self, **kw):
try:
body = _get_json_body()
vals = {
'name': body.get('name', ''),
'subject_id': int(body['subject_id']),
}
if body.get('description'):
vals['description'] = body['description']
rec = request.env['encoach.domain'].sudo().create(vals)
return _json_response(_domain_dict(rec), 201)
except Exception as e:
return _error_response(str(e), 500)
@http.route('/api/domains/<int:did>', type='http', auth='public',
methods=['PATCH', 'PUT'], csrf=False)
@jwt_required
def update_domain(self, did, **kw):
try:
rec = request.env['encoach.domain'].sudo().browse(did)
if not rec.exists():
return _error_response('Not found', 404)
body = _get_json_body()
vals = {}
for k in ('name', 'description'):
if k in body:
vals[k] = body[k]
if vals:
rec.write(vals)
return _json_response(_domain_dict(rec))
except Exception as e:
return _error_response(str(e), 500)
@http.route('/api/domains/<int:did>', type='http', auth='public',
methods=['DELETE'], csrf=False)
@jwt_required
def delete_domain(self, did, **kw):
try:
rec = request.env['encoach.domain'].sudo().browse(did)
if rec.exists():
rec.unlink()
return _json_response({'success': True})
except Exception as e:
return _error_response(str(e), 500)
@http.route('/api/domains/<int:did>/ai-suggest', type='http',
auth='public', methods=['POST'], csrf=False)
@jwt_required
def ai_suggest_topics(self, did, **kw):
try:
domain = request.env['encoach.domain'].sudo().browse(did)
if not domain.exists():
return _error_response('Domain not found', 404)
suggestions = [
{'name': f'{domain.name} - Fundamentals', 'difficulty_level': 'easy', 'estimated_hours': 2},
{'name': f'{domain.name} - Intermediate Concepts', 'difficulty_level': 'medium', 'estimated_hours': 3},
{'name': f'{domain.name} - Advanced Topics', 'difficulty_level': 'hard', 'estimated_hours': 4},
]
return _json_response({'suggestions': suggestions})
except Exception as e:
return _error_response(str(e), 500)
# ══════════════════════════════════════════════════════════════════
# TOPICS /api/topics
# ══════════════════════════════════════════════════════════════════
@http.route('/api/topics', type='http', auth='public',
methods=['GET'], csrf=False)
@jwt_required
def list_topics(self, **kw):
try:
domain_filter = []
if kw.get('domain_id'):
domain_filter.append(('domain_id', '=', int(kw['domain_id'])))
if kw.get('subject_id'):
domains = request.env['encoach.domain'].sudo().search([('subject_id', '=', int(kw['subject_id']))])
domain_filter.append(('domain_id', 'in', domains.ids))
recs = request.env['encoach.topic'].sudo().search(domain_filter)
return _json_response({'data': [_topic_dict(t) for t in recs]})
except Exception as e:
return _error_response(str(e), 500)
@http.route('/api/topics', type='http', auth='public',
methods=['POST'], csrf=False)
@jwt_required
def create_topic(self, **kw):
try:
body = _get_json_body()
vals = {
'name': body.get('name', ''),
'domain_id': int(body['domain_id']),
}
if body.get('description'):
vals['description'] = body['description']
rec = request.env['encoach.topic'].sudo().create(vals)
return _json_response(_topic_dict(rec), 201)
except Exception as e:
return _error_response(str(e), 500)
@http.route('/api/topics/<int:tid>', type='http', auth='public',
methods=['PATCH', 'PUT'], csrf=False)
@jwt_required
def update_topic(self, tid, **kw):
try:
rec = request.env['encoach.topic'].sudo().browse(tid)
if not rec.exists():
return _error_response('Not found', 404)
body = _get_json_body()
vals = {}
for k in ('name', 'description'):
if k in body:
vals[k] = body[k]
if vals:
rec.write(vals)
return _json_response(_topic_dict(rec))
except Exception as e:
return _error_response(str(e), 500)
@http.route('/api/topics/<int:tid>', type='http', auth='public',
methods=['DELETE'], csrf=False)
@jwt_required
def delete_topic(self, tid, **kw):
try:
rec = request.env['encoach.topic'].sudo().browse(tid)
if rec.exists():
rec.unlink()
return _json_response({'success': True})
except Exception as e:
return _error_response(str(e), 500)
# ══════════════════════════════════════════════════════════════════
# Legacy /api/taxonomy/* routes
# ══════════════════════════════════════════════════════════════════
@http.route('/api/taxonomy/tree', type='http', auth='public',
methods=['GET'], csrf=False)
@jwt_required
def get_tree(self, **kw):

8
custom_addons/encoach_taxonomy/models/learning_objective.py
View File

@@ -9,6 +9,14 @@ class EncoachLearningObjective(models.Model):
name = fields.Char(required=True, index=True)
topic_id = fields.Many2one('encoach.topic', required=True, ondelete='cascade', index=True)
description = fields.Text()
bloom_level = fields.Selection([
('remember', 'Remember'),
('understand', 'Understand'),
('apply', 'Apply'),
('analyze', 'Analyze'),
('evaluate', 'Evaluate'),
('create', 'Create'),
], default='remember')
cefr_level = fields.Selection([
('pre_a1', 'Pre-A1'), ('a1', 'A1'), ('a2', 'A2'),
('b1', 'B1'), ('b2', 'B2'), ('c1', 'C1'), ('c2', 'C2'),

14
custom_addons/encoach_taxonomy/models/subject.py
View File

@@ -13,6 +13,18 @@ class EncoachSubject(models.Model):
active = fields.Boolean(default=True)
domain_ids = fields.One2many('encoach.domain', 'subject_id', string='Domains')
course_count = fields.Integer(compute='_compute_counts')
resource_count = fields.Integer(compute='_compute_counts')
def _compute_counts(self):
for rec in self:
rec.course_count = self.env['op.course'].sudo().search_count(
[('encoach_subject_id', '=', rec.id)]
)
rec.resource_count = self.env['encoach.resource'].sudo().search_count(
[('subject_id', '=', rec.id)]
)
def to_api_dict(self):
self.ensure_one()
return {
@@ -21,4 +33,6 @@ class EncoachSubject(models.Model):
'code': self.code or '',
'description': self.description or '',
'active': self.active,
'course_count': self.course_count,
'resource_count': self.resource_count,
}

14
custom_addons/encoach_taxonomy/models/topic.py
View File

@@ -13,6 +13,18 @@ class EncoachTopic(models.Model):
active = fields.Boolean(default=True)
learning_objective_ids = fields.One2many('encoach.learning.objective', 'topic_id', string='Learning Objectives')
resource_count = fields.Integer(compute='_compute_counts')
chapter_count = fields.Integer(compute='_compute_counts')
def _compute_counts(self):
for rec in self:
rec.resource_count = self.env['encoach.resource'].sudo().search_count(
[('topic_ids', 'in', [rec.id])]
)
rec.chapter_count = self.env['encoach.course.chapter'].sudo().search_count(
[('topic_id', '=', rec.id)]
)
def to_api_dict(self):
self.ensure_one()
return {
@@ -22,4 +34,6 @@ class EncoachTopic(models.Model):
'domain_name': self.domain_id.name,
'description': self.description or '',
'active': self.active,
'resource_count': self.resource_count,
'chapter_count': self.chapter_count,
}