` | Generate listening dialog | | POST | `/api/exam/listening/` | Generate listening exercises | | GET | `/api/exam/writing/` | Generate writing task | | GET | `/api/exam/speaking/` | Generate speaking task | | POST | `/api/exam/level/` | Generate level-test exercises | ### AI Media (7) | Method | Endpoint | Description | |--------|----------|-------------| | POST | `/api/exam/listening/media` | Generate listening MP3 (AWS Polly) | | POST | `/api/exam/listening/transcribe` | Transcribe audio to dialog | | POST | `/api/exam/listening/instructions` | Generate instructions MP3 | | POST | `/api/exam/speaking/media` | Start AI avatar video generation | | GET | `/api/exam/speaking/media/` | Poll video generation status | | GET | `/api/exam/speaking/avatars` | List speaking avatars | | POST | `/api/transcribe` | Transcribe audio file (Whisper) | ### Training (4) | Method | Endpoint | Description | |--------|----------|-------------| | POST | `/api/training` | Generate personalised training plan | | GET | `/api/training/` | Get training by ID | | POST | `/api/training/tips` | Get contextual tips | | GET | `/api/training/walkthrough` | Get walkthrough | ### Subscriptions & Payments (5) | Method | Endpoint | Description | |--------|----------|-------------| | GET | `/api/packages` | List subscription packages | | POST | `/api/stripe` | Create Stripe checkout session | | POST | `/api/paypal` | Create PayPal order | | POST | `/api/paypal/approve` | Capture / approve PayPal order | | POST | `/api/paymob` | Create PayMob payment intention | ### Tickets (4) | Method | Endpoint | Description | |--------|----------|-------------| | GET | `/api/tickets` | List support tickets | | POST | `/api/tickets` | Create ticket | | PATCH | `/api/tickets/` | Update ticket | | DELETE | `/api/tickets/` | Delete ticket | ### Storage (2) | Method | Endpoint | Description | |--------|----------|-------------| | POST | `/api/storage` | Upload file | | POST | `/api/storage/delete` | Delete file | ### Grading (2) | Method | Endpoint | Description | |--------|----------|-------------| | POST | `/api/grading/multiple` | Grade multiple short-answer exercises | | POST | `/api/exam/grade/summary` | Generate grading summary | --- ## Quick Test ```bash # 1. Register a user curl -s http://127.0.0.1:8069/api/register \ -H "Content-Type: application/json" \ -d '{"email":"test@test.com","password":"Pass1234","name":"Test User","type":"student"}' # 2. Login – get JWT token TOKEN=$(curl -s http://127.0.0.1:8069/api/login \ -H "Content-Type: application/json" \ -d '{"credential":"test@test.com","password":"Pass1234"}' \ | python3 -c "import sys,json; print(json.load(sys.stdin)['token'])") # 3. Get current user (authenticated) curl -s http://127.0.0.1:8069/api/user \ -H "Authorization: Bearer $TOKEN" | python3 -m json.tool # 4. List exams curl -s "http://127.0.0.1:8069/api/exam?module=reading" \ -H "Authorization: Bearer $TOKEN" | python3 -m json.tool # 5. Create a ticket curl -s http://127.0.0.1:8069/api/tickets \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $TOKEN" \ -d '{"subject":"Test ticket","description":"Just testing","type":"feedback"}' # 6. List packages curl -s http://127.0.0.1:8069/api/packages \ -H "Authorization: Bearer $TOKEN" | python3 -m json.tool ``` --- ## File Structure ``` addons_extra/ ├── encoach_core/ │ ├── __manifest__.py │ ├── models/ # entity, role, permission, code, invite, res_users, user_entity_rel │ ├── security/ # security.xml (groups), ir.model.access.csv │ ├── data/ # constants.xml, assign_admin_group.xml │ ├── views/ # menu.xml + views for every model │ └── scripts/ # migrate_mongodb.py, migrate_firebase_auth.py, rebuild_faiss.py, import_avatars.py ├── encoach_exam/ │ ├── models/ # exam.py, approval_workflow.py │ └── views/ ├── encoach_classroom/ │ ├── models/ # group.py │ └── views/ ├── encoach_assignment/ │ ├── models/ # assignment.py │ └── views/ ├── encoach_stats/ │ ├── models/ # session.py, stat.py │ └── views/ ├── encoach_evaluation/ │ ├── models/ # evaluation.py, ai_job.py │ └── views/ ├── encoach_ai/ │ └── services/ # openai_service.py, prompt_service.py ├── encoach_ai_grading/ │ └── services/ # grading_service.py, gptzero_service.py ├── encoach_ai_generation/ │ └── services/ # reading, listening, writing, speaking, level generators ├── encoach_ai_media/ │ ├── models/ # elai_avatar.py │ ├── services/ # polly_service.py, elai_service.py, whisper_service.py │ └── views/ ├── encoach_training/ │ ├── models/ # training.py, tip.py, walkthrough.py │ ├── services/ # training_service.py, faiss_service.py │ └── views/ ├── encoach_subscription/ │ ├── models/ # package.py, payment.py, discount.py │ ├── services/ # stripe_service.py, paypal_service.py, paymob_service.py │ └── views/ ├── encoach_registration/ │ └── services/ # code_service.py ├── encoach_ticket/ │ ├── models/ # ticket.py │ └── views/ └── encoach_api/ └── controllers/ # 16 controller files (auth, users, exams, classrooms, etc.) ``` --- ## Key Technical Decisions - **JSON fields** (`fields.Json`) used extensively for complex nested data (exam parts, scores, solutions) to match existing MongoDB document shapes. - **JWT authentication** via `PyJWT` for stateless API auth, stored secret in `ir.config_parameter`. - **Odoo 19 changes**: `group_ids` (not `groups_id`), no `category_id` on `res.groups`, `models.Constraint` instead of `_sql_constraints`. - **Security**: Each model has ACL rules for Student (read-only), Teacher (read/write), Admin (full CRUD), and `base.group_system` (Odoo admin full CRUD). - **Admin user** is automatically added to the EnCoach Developer group (which implies Admin and Teacher) on install.