Developer Guide¶
Last Updated: February 2026
Overview¶
This section contains development standards, workflows, and reference material for all Scott Recycling custom Odoo modules.
Development Workflow¶
Environment Progression¶
Local Dev (localhost:1818) --> Cloud Test (exp.scottrecycling.com) --> Production
| | |
git push git pull git pull
| | |
Branch: jan Branch: jan Branch: main
DB: test1 DB: test DB: production
Git Workflow¶
- Develop on your local machine against
localhost:1818/ databasetest1 - Commit to the
janbranch (or your feature branch) - Push to
scottrecycling101remote - Pull on cloud test server and test thoroughly
- Merge to
mainand pull on production after approval
Branch Convention¶
| Branch | Purpose |
|---|---|
main |
Production-ready code only |
jan |
Current active development |
experimental |
Experimental features not ready for testing |
| Feature branches | Short-lived branches for specific features |
Repository Structure¶
SR-Odoo/
sr_*/ # Scott Recycling custom modules
oca_*/ # OCA community modules (may have local patches)
Dan-Odoo/ # Additional custom modules
asterisk-dev/ # Asterisk Docker dev environment
docs/ # Handoff documents (legacy)
scott_ai*/ # AI integration modules
Guides¶
- Development Standards — Module structure, manifest format, naming conventions
- Server Reference — Configuration, service management, database access
- Debugging & Troubleshooting — Logs, debug mode, common patterns, shell, OWL, security
- Deployment — Upgrade checklist, deployment steps, troubleshooting
- Module Reference — Links to all software guide documentation
- Telephony Integration — VitalPBX setup and developer guide