devops
4383db7fa1
- ENCOACH_UNIFIED_SRS.md v2.0: updated header, added 8 new Part VIII-B sections (student leave, fees, lessons, gradebook, student progress, library, activities, facilities), extended permissions with roles CRUD and authority matrix, updated tech specs (93 pages, ~377 API routes, 41 modules), added implementation traceability to all sections - ENCOACH_ODOO19_BACKEND_SRS.md v3.0: updated status to implemented, added beyond-SRS features section, updated module count to 41, endpoint count to ~377 - ODOO_DEVELOPER_HANDOFF.md: rewritten with current repo references and implementation status - ENCOACH_SYSTEM_FEATURES_GUIDE.md: added system features guide - Superseded notices added to ODOO_BACKEND_SRS_v3.md, ODOO_MIGRATION_SRS_v2.md, ODOO_MIGRATION_SRS.md, ODOO_MIGRATION_FRONTEND_SRS.md, MATH_IT_ADAPTIVE_LEARNING_SRS.md Made-with: Cursor
101 lines
4.4 KiB
Markdown
101 lines
4.4 KiB
Markdown
# Odoo Developer Handoff — Implementation Complete
|
|
|
|
**Status:** All deliverables implemented and deployed to staging.
|
|
**Date:** March 11, 2026
|
|
|
|
---
|
|
|
|
## 1. Current Repositories
|
|
|
|
| Repository | URL | Description |
|
|
|-----------|-----|-------------|
|
|
| **Frontend v2** | `https://git.albousalh.com/devops/encoach_frontend_new_v2.git` | React 18 SPA (93 pages, 37 services, 29 types) |
|
|
| **Backend v2** | `https://git.albousalh.com/devops/encoach_backend_new_v2.git` | Odoo 19 backend (27 custom + 14 OpenEduCat = 41 modules) |
|
|
|
|
**Note:** The older repositories (`encoach_frontend_new_v1`, `encoach_be_odoo19`, `ielts-be-v0`) are superseded. All development should continue in the v2 repositories above.
|
|
|
|
---
|
|
|
|
## 2. Staging Environment
|
|
|
|
| Service | URL |
|
|
|---------|-----|
|
|
| **Frontend** | `http://5.189.151.117:3000` |
|
|
| **Backend (Odoo 19)** | `http://5.189.151.117:8069` |
|
|
|
|
Deployment is automated via Git post-receive hooks. Push to `main` triggers rebuild.
|
|
|
|
---
|
|
|
|
## 3. Documentation
|
|
|
|
| Document | Status | Description |
|
|
|----------|--------|-------------|
|
|
| `ENCOACH_UNIFIED_SRS.md` (v2.0) | **Current** | Unified frontend + backend SRS with implementation traceability |
|
|
| `ENCOACH_ODOO19_BACKEND_SRS.md` (v3.0) | **Current** | Backend-specific SRS with all API contracts and data models |
|
|
| `ENCOACH_PRODUCT_DESCRIPTION.md` | **Current** | Non-technical product description |
|
|
| `ENCOACH_SYSTEM_FEATURES_GUIDE.md` | **Current** | System features guide by sidebar section |
|
|
| `ODOO_BACKEND_SRS_v3.md` | **Superseded** | Replaced by `ENCOACH_ODOO19_BACKEND_SRS.md` v3.0 |
|
|
| `ODOO_MIGRATION_SRS_v2.md` | **Superseded** | Replaced by `ENCOACH_ODOO19_BACKEND_SRS.md` v3.0 |
|
|
| `ODOO_MIGRATION_SRS.md` | **Superseded** | Replaced by `ENCOACH_ODOO19_BACKEND_SRS.md` v3.0 |
|
|
| `ODOO_MIGRATION_FRONTEND_SRS.md` | **Superseded** | Replaced by `ENCOACH_UNIFIED_SRS.md` v2.0 |
|
|
|
|
---
|
|
|
|
## 4. What Was Implemented
|
|
|
|
### Frontend (93 page components)
|
|
|
|
- **28 root pages** -- login, register, FAQ, exam runner, etc.
|
|
- **33 admin pages** -- full LMS/platform administration
|
|
- **19 student pages** -- courses, adaptive learning, communication
|
|
- **14 teacher pages** -- course builder, AI workbench, grading
|
|
- **37 API service modules** calling ~280+ backend endpoints
|
|
- **14 AI components** wired to real backend AI services
|
|
|
|
### Backend (41 Odoo modules, ~377 API routes)
|
|
|
|
- **`encoach_api`** -- 16 controller files, ~120 routes (auth, users, entities, roles, exams, assignments, classrooms, stats, subscriptions, tickets, approvals, training, generation, AI analytics)
|
|
- **`encoach_lms_api`** -- 28 controller files, ~209 routes (courses, students, teachers, batches, timetable, attendance, grades, departments, academic, admissions, subject registration, institutional exams, course assignments, student leave, fees, lessons, gradebook, student progress, library, activities, facilities, notifications, FAQ, courseware, plagiarism, communication)
|
|
- **`encoach_adaptive_api`** -- 6 controller files, ~41 routes (taxonomy, diagnostic, proficiency, learning plans, content, coaching)
|
|
- **`encoach_resources`** -- 1 controller file, ~7 routes (resource CRUD)
|
|
|
|
### Beyond Original SRS
|
|
|
|
The developer also implemented:
|
|
|
|
- Student Leave Management (types, requests, approve/reject)
|
|
- Fees Management (plans, student fees, terms)
|
|
- Lessons Management (timetable-linked)
|
|
- Gradebook and Grading Assignments
|
|
- Student Progress Tracking (aggregate)
|
|
- Library Management (media, movements, cards)
|
|
- Activity Management (configurable types)
|
|
- Facility and Asset Management
|
|
- Roles CRUD, User Role Assignment, Authority Matrix
|
|
|
|
---
|
|
|
|
## 5. AI Service Credentials
|
|
|
|
The developer needs API keys for:
|
|
|
|
| Service | Purpose |
|
|
|---------|---------|
|
|
| **OpenAI** | GPT-4o and Whisper -- grading, coaching, content generation, speech-to-text |
|
|
| **AWS Polly** | Text-to-speech (neural voices) |
|
|
| **ELAI** | AI avatar video generation |
|
|
| **GPTZero** | AI writing detection |
|
|
|
|
These are in `06-All-Credentials-Inventory.md` locally. Keys must be provided **separately** -- never committed to the git repo. On staging, they are in `/opt/encoach/backend-v2/.env`.
|
|
|
|
---
|
|
|
|
## 6. Frontend Code Reference
|
|
|
|
For any new backend development, the frontend contract is defined in:
|
|
|
|
- **`src/services/*.ts`** (37 files) -- every URL path, request body shape, and response handling
|
|
- **`src/types/*.ts`** (29 files) -- all TypeScript interfaces the frontend expects from the API
|
|
- **`src/hooks/queries/*.ts`** (21 files) -- TanStack Query cache keys and query configurations
|