create-odoo-module 1.0.0

package/src/generators/odoo-generator.js

@@ -0,0 +1,794 @@
+'use strict';
+
+const path = require('path');
+const { writeFile, mkdirp } = require('../utils/file-system');
+const { CORE_DEPENDS, COMPATIBILITY_DATES } = require('../config/defaults');
+const { toSnakeCase } = require('../utils/string-utils');
+const logger = require('../utils/logger');
+
+/**
+ * Generate the complete Odoo Python module directory.
+ */
+async function generateOdooModule(targetDir, config) {
+  const odooDir = path.join(targetDir, 'odoo_module');
+  const s = config.moduleNameSnake;   // fleet_manager
+  const P = config.moduleNamePascal;  // FleetManager
+  const M = config.moduleNameOdoo;    // fleet.manager
+  const L = config.moduleNameLabel;   // Fleet Manager
+
+  logger.verbose(`Generating Odoo module at ${odooDir}`);
+
+  await mkdirp(odooDir);
+
+  // ── Directory skeleton ────────────────────────────────────────────────────
+  const dirs = [
+    'models', 'views', 'controllers', 'security',
+    'data', 'report', 'tests', 'i18n',
+    `static/src/js`, `static/src/scss`, `static/description`,
+  ];
+  if (config.withWizard) dirs.push('wizard');
+  for (const d of dirs) await mkdirp(path.join(odooDir, d));
+
+  // ── Build depends list ────────────────────────────────────────────────────
+  const depends = [...CORE_DEPENDS, ...config.extraDepends];
+  const compatDate = COMPATIBILITY_DATES[config.odooVersion] || '2024-01-01';
+
+  // ── File generation ───────────────────────────────────────────────────────
+  await Promise.all([
+    writeFile(path.join(odooDir, '__init__.py'),       genRootInit(s)),
+    writeFile(path.join(odooDir, '__manifest__.py'),   genManifest({ s, P, L, M, depends, compatDate, config })),
+    writeFile(path.join(odooDir, 'models', '__init__.py'),      genModelsInit(s, config)),
+    writeFile(path.join(odooDir, 'models', `${s}.py`),          genModel(s, P, M, L, config)),
+    writeFile(path.join(odooDir, 'controllers', '__init__.py'), genControllersInit(s)),
+    writeFile(path.join(odooDir, 'security', 'ir.model.access.csv'), genSecurityCsv(s, M)),
+    writeFile(path.join(odooDir, 'security', `${s}_security.xml`),   genSecurityXml(s, L)),
+    writeFile(path.join(odooDir, 'data', `${s}_data.xml`),           genDataXml(s, L)),
+    writeFile(path.join(odooDir, 'i18n', `${s}.pot`),                genPot(s, L)),
+    writeFile(path.join(odooDir, 'static', 'description', 'index.html'), genDescription(L, config)),
+    writeFile(path.join(odooDir, 'static', 'src', 'js',   `${s}.js`),   genJs(s, P, config)),
+    writeFile(path.join(odooDir, 'static', 'src', 'scss', `${s}.scss`), genScss(s)),
+  ]);
+
+  if (config.withTests) {
+    await Promise.all([
+      writeFile(path.join(odooDir, 'tests', '__init__.py'), genTestsInit(s)),
+      writeFile(path.join(odooDir, 'tests', `test_${s}.py`), genTests(s, P, M, L)),
+    ]);
+  }
+
+  if (config.withWizard) {
+    await Promise.all([
+      writeFile(path.join(odooDir, 'wizard', '__init__.py'), `from . import ${s}_wizard\n`),
+      writeFile(path.join(odooDir, 'wizard', `${s}_wizard.py`), genWizard(s, P, M, L)),
+      writeFile(path.join(odooDir, 'wizard', `${s}_wizard_views.xml`), genWizardView(s, P, L)),
+    ]);
+  }
+
+  if (config.withReports) {
+    await writeFile(path.join(odooDir, 'report', `${s}_report.xml`), genReport(s, P, M, L));
+    await writeFile(path.join(odooDir, 'report', `${s}_report_template.xml`), genReportTemplate(s, P, M, L));
+  }
+
+  // ── Root package.json for npm scripts ─────────────────────────────────────
+  await writeFile(path.join(targetDir, 'package.json'),     genPackageJson(s, L, config));
+  await writeFile(path.join(targetDir, '.env.example'),     genEnvExample(s, config));
+  await writeFile(path.join(targetDir, '.gitignore'),       genGitignore());
+  await writeFile(path.join(targetDir, 'README.md'),        genReadme(s, P, L, M, config));
+}
+
+// ═══════════════════════════════════════════════════════════════════════════════
+// Python / Odoo file generators
+// ═══════════════════════════════════════════════════════════════════════════════
+
+function genRootInit(s) {
+  return `# -*- coding: utf-8 -*-
+from . import models
+from . import controllers
+`;
+}
+
+function genManifest({ s, P, L, M, depends, compatDate, config }) {
+  const dependsList = depends.map(d => `'${d}'`).join(', ');
+  const dataFiles   = [
+    `'security/ir.model.access.csv'`,
+    `'security/${s}_security.xml'`,
+    `'views/${s}_views.xml'`,
+    `'views/${s}_menus.xml'`,
+    `'data/${s}_data.xml'`,
+  ];
+  if (config.withReports) dataFiles.push(`'report/${s}_report.xml'`, `'report/${s}_report_template.xml'`);
+  if (config.withWizard)  dataFiles.push(`'wizard/${s}_wizard_views.xml'`);
+
+  return `# -*- coding: utf-8 -*-
+{
+    'name': '${L}',
+    'version': '${config.odooVersion}.0.1.0.0',
+    'category': '${config.category}',
+    'summary': 'Auto-generated by create-odoo-module CLI',
+    'description': """
+        ${L} Module
+        ${'='.repeat(L.length + 7)}
+        Full-stack Odoo module with CRUD${config.withApi ? ' + REST API' : ''}.
+        Generated by create-odoo-module — https://create-odoo-module.dev
+    """,
+    'author': '${config.author}',
+    'website': '${config.website}',
+    'depends': [${dependsList}],
+    'data': [
+        ${dataFiles.join(',\n        ')},
+    ],
+    'assets': {
+        'web.assets_backend': [
+            '${s}/static/src/js/${s}.js',
+            '${s}/static/src/scss/${s}.scss',
+        ],
+    },
+    'demo': [],
+    'installable': True,
+    'application': True,
+    'auto_install': False,
+    'license': '${config.license || 'LGPL-3'}',
+}
+`;
+}
+
+function genModelsInit(s, config) {
+  let out = `# -*- coding: utf-8 -*-\nfrom . import ${s}\n`;
+  if (config.withWizard) out += `from . import ${s}_wizard\n`;
+  return out;
+}
+
+function genControllersInit(s) {
+  return `# -*- coding: utf-8 -*-\nfrom . import ${s}_controller\n`;
+}
+
+function genModel(s, P, M, L, config) {
+  return `# -*- coding: utf-8 -*-
+from odoo import api, fields, models, _
+from odoo.exceptions import UserError, ValidationError
+
+
+class ${P}(models.Model):
+    """
+    ${L} — Main model.
+    Generated by create-odoo-module (https://create-odoo-module.dev)
+    """
+    _name        = '${M}'
+    _description = '${L}'
+    _inherit     = ['mail.thread', 'mail.activity.mixin']
+    _order       = 'name asc'
+    _rec_name    = 'name'
+
+    # ── Identity ──────────────────────────────────────────────────────────────
+    name = fields.Char(
+        string='Name',
+        required=True,
+        tracking=True,
+        index=True,
+        copy=False,
+    )
+    reference = fields.Char(
+        string='Reference',
+        copy=False,
+        readonly=True,
+        default='New',
+    )
+    description = fields.Text(string='Description')
+    active = fields.Boolean(default=True, tracking=True)
+    color  = fields.Integer(string='Color')
+
+    # ── Status ───────────────────────────────────────────────────────────────
+    state = fields.Selection([
+        ('draft',     'Draft'),
+        ('confirmed', 'Confirmed'),
+        ('in_progress', 'In Progress'),
+        ('done',      'Done'),
+        ('cancelled', 'Cancelled'),
+    ], default='draft', tracking=True, string='Status', required=True)
+
+    # ── Relations ─────────────────────────────────────────────────────────────
+    user_id = fields.Many2one(
+        'res.users',
+        string='Responsible',
+        default=lambda self: self.env.user,
+        tracking=True,
+        index=True,
+    )
+    company_id = fields.Many2one(
+        'res.company',
+        string='Company',
+        default=lambda self: self.env.company,
+        required=True,
+        index=True,
+    )
+    tag_ids = fields.Many2many(
+        'res.partner.category',
+        string='Tags',
+    )
+
+    # ── Dates ────────────────────────────────────────────────────────────────
+    date_start  = fields.Date(string='Start Date')
+    date_end    = fields.Date(string='End Date')
+    create_date = fields.Datetime(readonly=True)
+    write_date  = fields.Datetime(readonly=True)
+
+    # ── Priority / KPIs ───────────────────────────────────────────────────────
+    priority = fields.Selection([
+        ('0', 'Normal'),
+        ('1', 'Low'),
+        ('2', 'High'),
+        ('3', 'Very High'),
+    ], default='0', string='Priority')
+
+    # ── Computed ─────────────────────────────────────────────────────────────
+    display_name = fields.Char(compute='_compute_display_name', store=True)
+    duration_days = fields.Integer(compute='_compute_duration', store=True, string='Duration (Days)')
+
+    @api.depends('name', 'reference', 'state')
+    def _compute_display_name(self):
+        for rec in self:
+            ref = rec.reference if rec.reference != 'New' else ''
+            rec.display_name = f"[{rec.state.upper()}] {rec.name}" + (f" ({ref})" if ref else '')
+
+    @api.depends('date_start', 'date_end')
+    def _compute_duration(self):
+        for rec in self:
+            if rec.date_start and rec.date_end:
+                rec.duration_days = (rec.date_end - rec.date_start).days
+            else:
+                rec.duration_days = 0
+
+    # ── Constraints ───────────────────────────────────────────────────────────
+    @api.constrains('date_start', 'date_end')
+    def _check_dates(self):
+        for rec in self:
+            if rec.date_start and rec.date_end and rec.date_start > rec.date_end:
+                raise ValidationError(_('Start date must be before end date.'))
+
+    _sql_constraints = [
+        ('reference_unique', 'UNIQUE(reference, company_id)',
+         'Reference must be unique per company.'),
+    ]
+
+    # ── Sequence ──────────────────────────────────────────────────────────────
+    @api.model_create_multi
+    def create(self, vals_list):
+        for vals in vals_list:
+            if vals.get('reference', 'New') == 'New':
+                vals['reference'] = self.env['ir.sequence'].next_by_code('${M}') or 'New'
+        return super().create(vals_list)
+
+    # ── Business Logic ────────────────────────────────────────────────────────
+    def action_confirm(self):
+        for rec in self:
+            if rec.state != 'draft':
+                raise UserError(_('Only draft records can be confirmed.'))
+        self.write({'state': 'confirmed'})
+
+    def action_start(self):
+        self.filtered(lambda r: r.state == 'confirmed').write({'state': 'in_progress'})
+
+    def action_done(self):
+        self.write({'state': 'done'})
+
+    def action_cancel(self):
+        if any(r.state == 'done' for r in self):
+            raise UserError(_('Cannot cancel a completed record.'))
+        self.write({'state': 'cancelled'})
+
+    def action_reset_draft(self):
+        self.write({'state': 'draft'})
+
+    # ── Smart button actions ───────────────────────────────────────────────────
+    def action_open_form(self):
+        self.ensure_one()
+        return {
+            'type': 'ir.actions.act_window',
+            'res_model': self._name,
+            'res_id': self.id,
+            'view_mode': 'form',
+            'target': 'current',
+        }
+`;
+}
+
+function genSecurityCsv(s, M) {
+  const s_ = s.replace(/\./g, '_');
+  return `id,name,model_id:id,group_id:id,perm_read,perm_write,perm_create,perm_unlink
+access_${s_}_user,${M} User,model_${s_.replace(/-/g, '_')},base.group_user,1,0,0,0
+access_${s_}_manager,${M} Manager,model_${s_.replace(/-/g, '_')},base.group_system,1,1,1,1
+`;
+}
+
+function genSecurityXml(s, L) {
+  return `<?xml version="1.0" encoding="utf-8"?>
+<odoo>
+    <data noupdate="1">
+        <!-- Groups -->
+        <record id="group_${s}_user" model="res.groups">
+            <field name="name">${L} / User</field>
+            <field name="category_id" ref="base.module_category_hidden"/>
+        </record>
+        <record id="group_${s}_manager" model="res.groups">
+            <field name="name">${L} / Manager</field>
+            <field name="category_id" ref="base.module_category_hidden"/>
+            <field name="implied_ids" eval="[(4, ref('group_${s}_user'))]"/>
+            <field name="users" eval="[(4, ref('base.user_root')), (4, ref('base.user_admin'))]"/>
+        </record>
+    </data>
+</odoo>
+`;
+}
+
+function genDataXml(s, L) {
+  return `<?xml version="1.0" encoding="utf-8"?>
+<odoo>
+    <data noupdate="1">
+        <!-- Sequence for ${L} -->
+        <record id="seq_${s}" model="ir.sequence">
+            <field name="name">${L} Sequence</field>
+            <field name="code">${s.replace(/_/g, '.')}</field>
+            <field name="prefix">${s.toUpperCase().slice(0,3)}/%(year)s/</field>
+            <field name="padding">5</field>
+            <field name="company_id" eval="False"/>
+        </record>
+    </data>
+</odoo>
+`;
+}
+
+function genPot(s, L) {
+  return `# Translation of ${L} module
+# Copyright (C) ${new Date().getFullYear()} - Your Company
+# This file is distributed under the same license as the ${L} package.
+#, fuzzy
+msgid ""
+msgstr ""
+"Project-Id-Version: ${s} 1.0\\n"
+"Report-Msgid-Bugs-To: \\n"
+"POT-Creation-Date: ${new Date().toISOString()}\\n"
+"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\\n"
+"Last-Translator: FULL NAME <EMAIL@ADDRESS>\\n"
+"Language-Team: LANGUAGE <LL@li.org>\\n"
+"MIME-Version: 1.0\\n"
+"Content-Type: text/plain; charset=UTF-8\\n"
+"Content-Transfer-Encoding: 8bit\\n"
+`;
+}
+
+function genDescription(L, config) {
+  return `<section class="oe_container">
+  <div class="oe_row oe_spaced">
+    <h2 class="oe_slogan">${L}</h2>
+    <h3 class="oe_slogan">Generated by create-odoo-module</h3>
+    <p class="oe_mt32 text-center">
+      Full-stack Odoo module with CRUD operations${config.withApi ? ', REST API' : ''}
+      ${config.withUi ? ', and Flutter mobile app' : ''}.
+    </p>
+  </div>
+</section>
+`;
+}
+
+function genJs(s, P, config) {
+  if (!config.withOwl) {
+    return `/** @odoo-module **/
+// ${P} — static JS
+// Generated by create-odoo-module (https://create-odoo-module.dev)
+console.log('[${s}] module loaded');
+`;
+  }
+  return `/** @odoo-module **/
+
+import { Component, useState, onWillStart } from "@odoo/owl";
+import { registry } from "@web/core/registry";
+import { useService } from "@web/core/utils/hooks";
+
+/**
+ * ${P} OWL Component
+ * Renders inside the Odoo webclient.
+ */
+class ${P}Widget extends Component {
+    static template = \`
+        <div class="${s}-widget">
+            <h3>{{ state.title }}</h3>
+            <p>Records loaded: {{ state.count }}</p>
+        </div>
+    \`;
+
+    setup() {
+        this.orm   = useService("orm");
+        this.state = useState({ title: "${P}", count: 0 });
+
+        onWillStart(async () => {
+            const count = await this.orm.searchCount("${s.replace(/_/g, '.')}", []);
+            this.state.count = count;
+        });
+    }
+}
+
+// Register as a systray item or action component
+registry.category("actions").add("${s}_action_widget", ${P}Widget);
+`;
+}
+
+function genScss(s) {
+  return `.o_${s} {
+  // Module root class — applied to form views
+  .o_field_widget {
+    // Custom field styling
+  }
+
+  .o_statusbar_status {
+    // Custom statusbar
+  }
+}
+`;
+}
+
+function genTestsInit(s) {
+  return `# -*- coding: utf-8 -*-
+from . import test_${s}
+`;
+}
+
+function genTests(s, P, M, L) {
+  return `# -*- coding: utf-8 -*-
+from odoo.tests import common, tagged
+
+
+@tagged('post_install', '-at_install', '${s}')
+class Test${P}(common.TransactionCase):
+    """
+    Unit tests for ${L} (${M}).
+    Run with: python -m pytest addons/${s}/tests/ -v
+    Or via Odoo: ./odoo-bin test -d mydb --test-tags ${s}
+    """
+
+    @classmethod
+    def setUpClass(cls):
+        super().setUpClass()
+        cls.Model = cls.env['${M}']
+        cls.user  = cls.env.ref('base.user_admin')
+
+    def _create_record(self, name='Test Record', **kwargs):
+        return self.Model.create({'name': name, **kwargs})
+
+    # ── Creation ─────────────────────────────────────────────────────────────
+    def test_01_create_basic(self):
+        rec = self._create_record()
+        self.assertTrue(rec.id, 'Record should have an ID after creation')
+        self.assertEqual(rec.name, 'Test Record')
+        self.assertEqual(rec.state, 'draft', 'Default state should be draft')
+
+    def test_02_sequence_assigned(self):
+        rec = self._create_record('Seq Test')
+        self.assertNotEqual(rec.reference, 'New', 'Sequence should be assigned on create')
+
+    # ── State machine ─────────────────────────────────────────────────────────
+    def test_03_confirm(self):
+        rec = self._create_record('Confirm Test')
+        rec.action_confirm()
+        self.assertEqual(rec.state, 'confirmed')
+
+    def test_04_cannot_confirm_twice(self):
+        rec = self._create_record('Double Confirm')
+        rec.action_confirm()
+        with self.assertRaises(Exception):
+            rec.action_confirm()
+
+    def test_05_done(self):
+        rec = self._create_record('Done Test')
+        rec.action_confirm()
+        rec.action_start()
+        rec.action_done()
+        self.assertEqual(rec.state, 'done')
+
+    def test_06_cancel(self):
+        rec = self._create_record('Cancel Test')
+        rec.action_cancel()
+        self.assertEqual(rec.state, 'cancelled')
+
+    def test_07_reset_draft(self):
+        rec = self._create_record('Reset Test')
+        rec.action_cancel()
+        rec.action_reset_draft()
+        self.assertEqual(rec.state, 'draft')
+
+    # ── Date constraint ───────────────────────────────────────────────────────
+    def test_08_date_constraint(self):
+        from odoo.exceptions import ValidationError
+        import datetime
+        with self.assertRaises(ValidationError):
+            self._create_record(
+                'Bad Dates',
+                date_start=datetime.date(2025, 12, 31),
+                date_end=datetime.date(2025, 1, 1),
+            )
+
+    # ── Computed fields ───────────────────────────────────────────────────────
+    def test_09_display_name(self):
+        rec = self._create_record('Display Test')
+        self.assertIn('draft', rec.display_name.lower())
+        self.assertIn('display test', rec.display_name.lower())
+
+    def test_10_duration(self):
+        import datetime
+        rec = self._create_record(
+            'Duration Test',
+            date_start=datetime.date(2025, 1, 1),
+            date_end=datetime.date(2025, 1, 11),
+        )
+        self.assertEqual(rec.duration_days, 10)
+`;
+}
+
+function genWizard(s, P, M, L) {
+  return `# -*- coding: utf-8 -*-
+from odoo import api, fields, models, _
+from odoo.exceptions import UserError
+
+
+class ${P}Wizard(models.TransientModel):
+    """Wizard for bulk actions on ${L}."""
+    _name        = '${M}.wizard'
+    _description = '${L} Wizard'
+
+    record_ids = fields.Many2many('${M}', string='Records')
+    action     = fields.Selection([
+        ('confirm', 'Confirm All'),
+        ('cancel',  'Cancel All'),
+    ], string='Action', required=True, default='confirm')
+    note = fields.Text(string='Note / Reason')
+
+    def action_execute(self):
+        self.ensure_one()
+        records = self.record_ids or self.env['${M}'].browse(self.env.context.get('active_ids', []))
+        if not records:
+            raise UserError(_('No records selected.'))
+
+        if self.action == 'confirm':
+            records.action_confirm()
+        elif self.action == 'cancel':
+            records.action_cancel()
+
+        return {'type': 'ir.actions.act_window_close'}
+`;
+}
+
+function genWizardView(s, P, L) {
+  return `<?xml version="1.0" encoding="utf-8"?>
+<odoo>
+    <record id="view_${s}_wizard_form" model="ir.ui.view">
+        <field name="name">${s}.wizard.form</field>
+        <field name="model">${s.replace(/_/g, '.')}.wizard</field>
+        <field name="arch" type="xml">
+            <form string="${L} — Bulk Action">
+                <group>
+                    <field name="record_ids" widget="many2many_tags"/>
+                    <field name="action"/>
+                    <field name="note" placeholder="Optional reason..."/>
+                </group>
+                <footer>
+                    <button name="action_execute" string="Execute" type="object" class="btn-primary"/>
+                    <button string="Cancel" class="btn-secondary" special="cancel"/>
+                </footer>
+            </form>
+        </field>
+    </record>
+
+    <record id="action_${s}_wizard" model="ir.actions.act_window">
+        <field name="name">${L} — Bulk Action</field>
+        <field name="res_model">${s.replace(/_/g, '.')}.wizard</field>
+        <field name="view_mode">form</field>
+        <field name="target">new</field>
+        <field name="binding_model_id" ref="${s}.model_${s}"/>
+        <field name="binding_view_types">list</field>
+    </record>
+</odoo>
+`;
+}
+
+function genReport(s, P, M, L) {
+  return `<?xml version="1.0" encoding="utf-8"?>
+<odoo>
+    <record id="action_report_${s}" model="ir.actions.report">
+        <field name="name">${L} Report</field>
+        <field name="model">${M}</field>
+        <field name="report_type">qweb-pdf</field>
+        <field name="report_name">${s}.report_${s}_template</field>
+        <field name="report_file">${s}/report/${s}_report_template</field>
+        <field name="print_report_name">'${L} - ' + object.name</field>
+        <field name="binding_model_id" ref="${s}.model_${s}"/>
+        <field name="binding_type">report</field>
+        <field name="paperformat_id" ref="base.paperformat_euro"/>
+    </record>
+</odoo>
+`;
+}
+
+function genReportTemplate(s, P, M, L) {
+  return `<?xml version="1.0" encoding="utf-8"?>
+<odoo>
+    <template id="report_${s}_template">
+        <t t-call="web.html_container">
+            <t t-foreach="docs" t-as="doc">
+                <t t-call="web.external_layout">
+                    <div class="page">
+                        <!-- Header -->
+                        <div class="row">
+                            <div class="col-6">
+                                <h2><t t-esc="doc.name"/></h2>
+                                <p class="text-muted">Ref: <t t-esc="doc.reference"/></p>
+                            </div>
+                            <div class="col-6 text-end">
+                                <span t-attf-class="badge bg-{{ 'success' if doc.state == 'done' else 'warning' }}">
+                                    <t t-esc="doc.state.upper()"/>
+                                </span>
+                            </div>
+                        </div>
+                        <hr/>
+                        <!-- Body -->
+                        <div class="row mt-3">
+                            <div class="col-6">
+                                <strong>Responsible:</strong>
+                                <t t-esc="doc.user_id.name"/>
+                            </div>
+                            <div class="col-6">
+                                <strong>Period:</strong>
+                                <t t-esc="doc.date_start"/> — <t t-esc="doc.date_end"/>
+                            </div>
+                        </div>
+                        <t t-if="doc.description">
+                            <div class="row mt-3">
+                                <div class="col-12">
+                                    <strong>Description:</strong>
+                                    <p><t t-esc="doc.description"/></p>
+                                </div>
+                            </div>
+                        </t>
+                        <!-- Footer -->
+                        <div class="row mt-5">
+                            <div class="col-12 text-muted text-center">
+                                <small>Generated by create-odoo-module — https://create-odoo-module.dev</small>
+                            </div>
+                        </div>
+                    </div>
+                </t>
+            </t>
+        </t>
+    </template>
+</odoo>
+`;
+}
+
+function genPackageJson(s, L, config) {
+  return JSON.stringify({
+    name: s.replace(/_/g, '-'),
+    version: '1.0.0',
+    description: `${L} Odoo module`,
+    private: true,
+    scripts: {
+      deploy:              'bash scripts/deploy.sh',
+      'deploy:win':        'powershell scripts/deploy.ps1',
+      dev:                 'docker-compose -f scripts/docker-compose.yml up -d',
+      'dev:stop':          'docker-compose -f scripts/docker-compose.yml down',
+      'dev:logs':          'docker-compose -f scripts/docker-compose.yml logs -f odoo',
+      ...(config.withUi ? {
+        'flutter:run':           'cd flutter_app && flutter run',
+        'flutter:build:android': 'cd flutter_app && flutter build apk --release',
+        'flutter:build:ios':     'cd flutter_app && flutter build ios --release',
+        'flutter:test':          'cd flutter_app && flutter test',
+        'flutter:analyze':       'cd flutter_app && flutter analyze',
+      } : {}),
+      'odoo:test':  `cd odoo_module && python -m pytest tests/ -v`,
+      'odoo:lint':  `cd odoo_module && python -m flake8 . --max-line-length=120 --exclude=__pycache__`,
+      'odoo:shell': 'docker exec -it odoo_dev odoo shell -d odoo',
+    },
+  }, null, 2);
+}
+
+function genEnvExample(s, config) {
+  return `# ── Odoo Server ──────────────────────────────────────────────────
+ODOO_URL=${(config.odooUrl || 'http://localhost:8069')}
+ODOO_DB=${(config.odooDb || 'odoo')}
+ODOO_USER=admin
+ODOO_PASSWORD=admin
+ODOO_ADDONS_PATH=/opt/odoo/custom-addons
+ODOO_SERVICE=odoo
+
+# ── Flutter App ───────────────────────────────────────────────────
+FLUTTER_ODOO_BASE_URL=${(config.odooUrl || 'http://localhost:8069')}
+FLUTTER_ODOO_DB=${(config.odooDb || 'odoo')}
+
+# ── Pro License (optional) ────────────────────────────────────────
+CREATE_ODOO_MODULE_PRO_KEY=
+`;
+}
+
+function genGitignore() {
+  return `# Python
+__pycache__/
+*.py[cod]
+*.pyo
+*.egg-info/
+.eggs/
+dist/
+build/
+*.egg
+.pytest_cache/
+.mypy_cache/
+
+# Odoo
+*.pot~
+
+# Flutter/Dart
+.dart_tool/
+.flutter-plugins
+.flutter-plugins-dependencies
+flutter_app/build/
+flutter_app/.dart_tool/
+flutter_app/pubspec.lock
+
+# Node
+node_modules/
+npm-debug.log*
+
+# Docker
+.docker/
+
+# Environment
+.env
+*.env.local
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+.DS_Store
+
+# Wrangler
+.wrangler/
+`;
+}
+
+function genReadme(s, P, L, M, config) {
+  return `# ${L}
+
+> Generated by [create-odoo-module](https://create-odoo-module.dev) — the Next.js for Odoo.
+
+## Quick Start
+
+\`\`\`bash
+cp .env.example .env          # Fill in your Odoo credentials
+${config.withDocker ? 'npm run dev              # Start local Odoo via Docker\n' : ''}\
+npm run deploy            # Upload module to Odoo
+${config.withUi ? 'npm run flutter:run      # Start Flutter app\n' : ''}\
+\`\`\`
+
+## What's Inside
+
+| Path | Description |
+|------|-------------|
+| \`odoo_module/\`  | Full Odoo Python module (${M}) |
+${config.withApi ? '| `controllers/`  | REST API GET/POST/PUT/DELETE |\n' : ''}\
+${config.withUi ? '| `flutter_app/`  | Flutter mobile app |\n' : ''}\
+${config.withReports ? '| `report/`       | QWeb PDF reports |\n' : ''}\
+| \`scripts/\`      | Deploy + Docker Compose |
+
+## Odoo Module Info
+
+- **Technical name**: \`${M}\`
+- **Version**: \`${config.odooVersion}.0.1.0.0\`
+- **Depends**: base, mail, web${config.extraDepends.length ? ', ' + config.extraDepends.join(', ') : ''}
+
+${config.withApi ? `## REST API\n\n| Method | Endpoint | Description |\n|--------|----------|-------------|\n| GET | \`/api/${s}\` | List records |\n| GET | \`/api/${s}/:id\` | Get record |\n| POST | \`/api/${s}\` | Create record |\n| PUT | \`/api/${s}/:id\` | Update record |\n| DELETE | \`/api/${s}/:id\` | Delete record |\n` : ''}
+
+## License
+
+LGPL-3 — see [LICENSE](LICENSE)
+`;
+}
+
+module.exports = { generateOdooModule };