Custom Software Development Kit & Scaffolding

Developer handbook for setting up the Odoo 19 / SmartERP local development environment, using smarterp_docs generator scripts, CLI tunneling utilities, and custom module architecture.

• SmartERP Developer SDK and Architecture Overview

  Technical architecture, repository structure, Odoo 19 Community base, OCA dependencies, and Ashewa enterprise addon framework.

• Local Development Environment and Toolchain Setup

  Step-by-step instructions for configuring Python 3.12+, PostgreSQL 16, uv/pip, Docker, pre-commit git hooks, and VS Code / Antigravity development tools.

• Module Scaffolding and Codebase Governance Standards

  Creating compliant SmartERP custom addons, manifest declarations, directory layouts, and layered inheritance rules.

• Odoo 19 ORM Modeling and Database Field Types

  Defining data models, relational fields (Many2one, One2many, Many2many), computed attributes, stored indexes, and SQL constraints.

• View Architecture and Odoo 19 List View Migration

  Migrating legacy <tree> views to Odoo 19 <list> elements, form layouts, search filters, and responsive mobile design.

• Documentation Generator Tools and Diagram Tooling

  Using the smarterp_docs engine, scanning tools, building declarative vector diagrams, and screenshot manifest registration.

• CLI Utilities, Webhook Tunneling, and Playwright Testing

  Setting up local development webhook tunnels using ngrok or Cloudflare, and running automated Playwright end-to-end browser tests.

• Testing Strategies and Test-Driven Development (TDD)

  Writing unit tests with TransactionCase, HTTP tests with HttpCase, and creating fast offline test suites without database overhead.

• Git Workflow, Branch Parity, and GitLab Governance

  Operating rules for the Ashewa GitLab monorepo, strict branch parity across migration, dev, and main, and zero-leakage policies.

• Troubleshooting Common Developer and Runtime Issues

  Diagnostic trees for resolving registry reload blocks, schema locks, asset compilation errors, and dependency circularity.