odoo-17

仓库原始内容

按源仓库内容呈现，保留标题、案例、代码、表格、链接以及原文引用的演示图片。

Odoo 17 Skill - Master Index

Master index for all Odoo 17 development guides. Read the appropriate guide from references/ based on your task.

Quick Reference

Topic	File	When to Use
Actions	`references/odoo-17-actions-guide.md`	Creating actions, menus, scheduled jobs, server actions
API Decorators	`references/odoo-17-decorator-guide.md`	Using @api decorators, compute fields, validation
Controllers	`references/odoo-17-controller-guide.md`	Writing HTTP endpoints, routes, web controllers
Data Files	`references/odoo-17-data-guide.md`	XML/CSV data files, records, shortcuts
Development	`references/odoo-17-development-guide.md`	Creating modules, manifest, reports, security, wizards
Field Types	`references/odoo-17-field-guide.md`	Defining model fields, choosing field types
Manifest	`references/odoo-17-manifest-guide.md`	manifest.py configuration, dependencies, hooks
Migration	`references/odoo-17-migration-guide.md`	Upgrading modules, data migration, version changes
Mixins	`references/odoo-17-mixins-guide.md`	mail.thread, activities, email aliases, tracking
Model Methods	`references/odoo-17-model-guide.md`	Writing ORM queries, CRUD operations, domain filters
OWL Components	`references/odoo-17-owl-guide.md`	Building OWL UI components, hooks, services
Performance	`references/odoo-17-performance-guide.md`	Optimizing queries, fixing slow code, preventing N+1
Reports	`references/odoo-17-reports-guide.md`	QWeb reports, PDF/HTML, templates, paper formats
Security	`references/odoo-17-security-guide.md`	Access rights, record rules, field permissions
Testing	`references/odoo-17-testing-guide.md`	Writing tests, mocking, assertions, browser testing
Transactions	`references/odoo-17-transaction-guide.md`	Handling database errors, savepoints, UniqueViolation
Translation	`references/odoo-17-translation-guide.md`	Adding translations, localization, i18n
Views & XML	`references/odoo-17-view-guide.md`	Writing XML views, actions, menus, QWeb templates

Coding Conventions

Apply the relevant convention section in the guide you open. Conventions are advisory: preserve the style of an existing stable addon and keep diffs focused. When guidance conflicts, prefer Odoo 17 runtime/source behavior, then the surrounding addon style, then the convention.

Module layout and asset placement: development and controller guides.
XML formatting and external IDs: data, view, action, report, and security guides.
Python naming, imports, recordsets, transactions, and translations: model,

field, decorator, performance, transaction, and translation guides.

JavaScript and CSS/SCSS: development guide.

File Structure

skills/odoo-17.0/
├── SKILL.md                          # This file - master index
└── references/                       # Development guides
    ├── odoo-17-actions-guide.md
    ├── odoo-17-controller-guide.md
    ├── odoo-17-data-guide.md
    ├── odoo-17-decorator-guide.md
    ├── odoo-17-development-guide.md
    ├── odoo-17-field-guide.md
    ├── odoo-17-manifest-guide.md
    ├── odoo-17-migration-guide.md
    ├── odoo-17-mixins-guide.md
    ├── odoo-17-model-guide.md
    ├── odoo-17-owl-guide.md
    ├── odoo-17-performance-guide.md
    ├── odoo-17-reports-guide.md
    ├── odoo-17-security-guide.md
    ├── odoo-17-testing-guide.md
    ├── odoo-17-transaction-guide.md
    ├── odoo-17-translation-guide.md
    └── odoo-17-view-guide.md

Base Code Reference (Odoo 17)

All guides are based on analysis of Odoo 17 source code:

odoo/models.py - ORM implementation
odoo/fields.py - Field types
odoo/api.py - Decorators
odoo/http.py - HTTP layer
odoo/exceptions.py - Exception types
odoo/tools/translate.py - Translation system
odoo/addons/base/models/res_lang.py - Language model
addons/web/static/src/core/l10n/translation.js - JS translations