Структура каталога проекта

Каталог odpm-проекта (например client_addons-19/) — это рабочая оболочка окружения на вашем компьютере. Исходники модулей могут физически лежать в другом месте (в ODOO_PROJECTS_DIR или по пути file://).

Файлы в корне каталога окружения

Объект	Назначение
odpm.json	Описание стека (ссылка на файл из git репозитория модулей)
user_settings.json	Модули, база, поведение git, режим разработки
.env	Порты, сценарий, каталоги резервных копий и клонов (важнее ~/.odpm/.env)
odoo.conf или {имя_платформы}.conf	Настройки Odoo на диске — отдельная статья
docker-compose.yml	Генерируется odpm — не править вручную
Dockerfile, .dockerignore	Генерируются odpm
venv/	Окружение Python на хосте (подключается в контейнер)

Каталог .odpm/

Объект	Назначение
deps.lock.json	Фиксация ревизий git — хранить в git
runtime/config.json	Служебный контракт host→container — не коммитить, не править
database/last_run.json	Снимок конфигурации PostgreSQL (fingerprint) — не коммитить; см. database-state.md
runtime/debug-profile.json	IDE-neutral профиль отладчика (developer) — не коммитить, не править
secrets.example.json	Шаблон ключей секретов — хранить в git
secrets.json	Source секретов модулей — не коммитить; см. секреты
runtime/secrets.json	Materialized copy для mount в контейнер — не коммитить, не править
dockerignore	Шаблон для корневого .dockerignore

Прочие каталоги

Объект	Назначение
dependencies/	Служебные ссылки на клоны зависимостей
data/odoo/	Домашний каталог процесса в контейнере, тесты, кэш
.vscode/	Настройки отладки (сценарий разработчика)

Где лежат исходники платформы и модулей

• Репозитории, клонируемые по HTTPS/SSH, — в ODOO_PROJECTS_DIR (задаётся в .env).
• Проекты по ссылкам вида file:// — лежат по указанному абсолютному пути, без клонирования и переключения между версиями.

При включённой опции create_module_links в корне могут появляться символические ссылки для удобства навигации в редакторе — см. отладка.