Files
encoach_backend_v4/custom_addons/encoach_lms_api/controllers/faq.py
Yamen Ahmad 6ec68160c8 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
2026-04-19 03:13:23 +04:00

170 lines
6.4 KiB
Python

import logging
from odoo import http
from odoo.http import request
from odoo.addons.encoach_api.controllers.base import (
jwt_required, _json_response, _error_response, _get_json_body,
)
_logger = logging.getLogger(__name__)
def _ser_cat(c):
return {
'id': c.id,
'name': c.name or '',
'sequence': c.sequence,
'audience': c.audience or 'all',
'is_published': c.is_published,
'item_count': c.item_count or 0,
}
def _ser_item(i):
return {
'id': i.id,
'category_id': i.category_id.id,
'category_name': i.category_id.name or '',
'question': i.question or '',
'answer': i.answer or '',
'sequence': i.sequence,
'audience': i.audience or 'all',
'is_published': i.is_published,
}
class FaqController(http.Controller):
@http.route('/api/faq/categories', type='http', auth='public', methods=['GET'], csrf=False)
@jwt_required
def list_categories(self, **kw):
try:
M = request.env['encoach.faq.category'].sudo()
domain = []
if kw.get('audience'):
domain.append(('audience', 'in', [kw['audience'], 'all']))
recs = M.search(domain, order='sequence, id')
return _json_response([_ser_cat(r) for r in recs])
except Exception as e:
return _error_response(str(e), 500)
@http.route('/api/faq/categories', type='http', auth='public', methods=['POST'], csrf=False)
@jwt_required
def create_category(self, **kw):
try:
body = _get_json_body()
vals = {'name': body.get('name', '')}
if body.get('sequence') is not None:
vals['sequence'] = int(body['sequence'])
if body.get('audience'):
vals['audience'] = body['audience']
rec = request.env['encoach.faq.category'].sudo().create(vals)
return _json_response(_ser_cat(rec))
except Exception as e:
return _error_response(str(e), 500)
@http.route('/api/faq/categories/<int:cid>', type='http', auth='public', methods=['PATCH', 'PUT'], csrf=False)
@jwt_required
def update_category(self, cid, **kw):
try:
rec = request.env['encoach.faq.category'].sudo().browse(cid)
if not rec.exists():
return _error_response('Not found', 404)
body = _get_json_body()
vals = {}
for k in ('name', 'audience'):
if k in body:
vals[k] = body[k]
if 'sequence' in body:
vals['sequence'] = int(body['sequence'])
if 'is_published' in body:
vals['is_published'] = bool(body['is_published'])
if vals:
rec.write(vals)
return _json_response(_ser_cat(rec))
except Exception as e:
return _error_response(str(e), 500)
@http.route('/api/faq/categories/<int:cid>', type='http', auth='public', methods=['DELETE'], csrf=False)
@jwt_required
def delete_category(self, cid, **kw):
try:
rec = request.env['encoach.faq.category'].sudo().browse(cid)
if rec.exists():
rec.unlink()
return _json_response({'success': True})
except Exception as e:
return _error_response(str(e), 500)
# ── Items ────────────────────────────────────────────────────────
@http.route('/api/faq/items', type='http', auth='public', methods=['GET'], csrf=False)
@jwt_required
def list_items(self, **kw):
try:
M = request.env['encoach.faq.item'].sudo()
domain = []
if kw.get('category_id'):
domain.append(('category_id', '=', int(kw['category_id'])))
if kw.get('audience'):
domain.append(('audience', 'in', [kw['audience'], 'all']))
if kw.get('search'):
domain.append(('question', 'ilike', kw['search']))
recs = M.search(domain, order='sequence, id')
return _json_response([_ser_item(r) for r in recs])
except Exception as e:
return _error_response(str(e), 500)
@http.route('/api/faq/items', type='http', auth='public', methods=['POST'], csrf=False)
@jwt_required
def create_item(self, **kw):
try:
body = _get_json_body()
vals = {
'question': body.get('question', ''),
'answer': body.get('answer', ''),
'category_id': int(body.get('category_id', 0)),
}
if body.get('sequence') is not None:
vals['sequence'] = int(body['sequence'])
if body.get('audience'):
vals['audience'] = body['audience']
rec = request.env['encoach.faq.item'].sudo().create(vals)
return _json_response(_ser_item(rec))
except Exception as e:
return _error_response(str(e), 500)
@http.route('/api/faq/items/<int:iid>', type='http', auth='public', methods=['PATCH', 'PUT'], csrf=False)
@jwt_required
def update_item(self, iid, **kw):
try:
rec = request.env['encoach.faq.item'].sudo().browse(iid)
if not rec.exists():
return _error_response('Not found', 404)
body = _get_json_body()
vals = {}
for k in ('question', 'answer', 'audience'):
if k in body:
vals[k] = body[k]
if 'category_id' in body:
vals['category_id'] = int(body['category_id'])
if 'sequence' in body:
vals['sequence'] = int(body['sequence'])
if 'is_published' in body:
vals['is_published'] = bool(body['is_published'])
if vals:
rec.write(vals)
return _json_response(_ser_item(rec))
except Exception as e:
return _error_response(str(e), 500)
@http.route('/api/faq/items/<int:iid>', type='http', auth='public', methods=['DELETE'], csrf=False)
@jwt_required
def delete_item(self, iid, **kw):
try:
rec = request.env['encoach.faq.item'].sudo().browse(iid)
if rec.exists():
rec.unlink()
return _json_response({'success': True})
except Exception as e:
return _error_response(str(e), 500)