Files

Yamen Ahmad 11a7265460 feat(v3): restructure project + add complete frontend

- Restructure: move backend from new_project/ to backend/
- Add full React/TypeScript frontend (37 pages, 17 services, 16 type defs, 11 query hooks)
- Add docs/ with SRS specs, user stories, and workflow documentation
- Update .gitignore for new directory layout

Workflows implemented:
  WF1 User Signup, WF2 Placement Test, WF3 Exam Configuration,
  WF4 General English Exam, WF5 Course Generation,
  WF6 Entity Student Onboarding, AI Course Generation,
  Adaptive Learning Engine UI, White-Label Branding, Score Release

Made-with: Cursor

2026-04-10 17:26:42 +04:00

4.4 KiB

Raw Blame History

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

4.4 KiB Raw Blame History