Files

Yamen Ahmad 3e83d8d7d5 feat: add complete EnCoach backend — Odoo 19 + all addons

Includes:
- Odoo 19 framework (odoo/)
- 27 custom EnCoach addons (new_project/custom_addons/)
  - encoach_core, encoach_api, encoach_lms_api, encoach_adaptive_api
  - encoach_exam, encoach_taxonomy, encoach_adaptive, encoach_assignment
  - encoach_ai, encoach_ai_grading, encoach_ai_generation, encoach_ai_media
  - encoach_courseware, encoach_communication, encoach_subscription
  - encoach_notification, encoach_approval, encoach_branding
  - encoach_classroom, encoach_registration, encoach_stats
  - encoach_faq, encoach_ticket, encoach_training, encoach_resources
  - encoach_adaptive_ai, encoach_sis
- 21 OpenEduCat Enterprise modules (new_project/enterprise-19/)
- 14 OpenEduCat Community modules (new_project/openeducat_erp-19.0/)
- Configuration: odoo.conf, requirements.txt, scripts
- 200+ REST API endpoints with JWT authentication
- SRS and test documentation

Made-with: Cursor

2026-04-01 17:10:04 +04:00

2.8 KiB

Raw Blame History

Odoo 19 Community – Local setup (macOS)

Run Odoo 19 Community on your Mac.

Option A: Run with Docker (easiest)

No Python or PostgreSQL needed on your machine.

Requirements: Docker Desktop for Mac.

cd /Users/yamenahmad/projects2026/odoo/odoo19
docker compose up -d

Open http://localhost:8069. First time: create a new database (name, email, password).

Test that it’s running:

./test_odoo.sh

Stop: docker compose down

Manual terminal guide (no scripts): see MANUAL-RUN.md for step-by-step commands only.

Option B: Run from source (venv + PostgreSQL)

Prerequisites

macOS (Sonoma, Ventura, or Monterey)

Homebrew – brew.sh – install with:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Xcode Command Line Tools (for compilers):
```
xcode-select --install
```

1. Install PostgreSQL and wkhtmltopdf

brew install postgresql@15 wkhtmltopdf
brew services start postgresql@15

Create an Odoo database user (optional; you can also use your macOS user):

# Using your current user (no password by default on Mac)
createuser -s $(whoami)

# Or create a dedicated user with password:
createuser -s odoo
# Then in psql: ALTER USER odoo WITH PASSWORD 'odoo';

2. Run the setup script

From this directory:

chmod +x setup.sh
./setup.sh

This will:

Clone Odoo 19.0 into ./odoo/
Create a Python virtual environment in ./venv/
Install Python dependencies from odoo/requirements.txt

3. Configure Odoo (optional)

Copy the example config and edit if needed:

cp odoo.conf.example odoo.conf

db_user: your PostgreSQL user (e.g. your Mac username or odoo)
db_password: leave empty if you use trust auth (typical on Mac)
addons_path: defaults to odoo/addons (Community only)

4. Run Odoo

./run.sh

Or manually:

source venv/bin/activate
cd odoo && ./odoo-bin -c ../odoo.conf

Open http://localhost:8069
First run: create a new database (name, email, password, language)
Default admin login after creating DB: email admin, password admin (if you use the demo setup)

Useful options

Custom database name: ./odoo-bin -c odoo.conf -d mydb
Development mode (auto-reload): add --dev=all to the command
Install modules at start: -i sale,crm (comma-separated)

Troubleshooting

Port 8069 in use: change xmlrpc_port in odoo.conf or run with --http-port=8070
PostgreSQL connection refused: ensure it’s running: brew services start postgresql@15
Python / pip errors: use Python 3.10, 3.11, or 3.12; create a fresh venv and run pip install -r odoo/requirements.txt again

2.8 KiB Raw Blame History Unescape Escape