Public release from ruodoo-project: 19.0 - 2026-05-31 21:19:12 UTC

ruodoo_demo_data/README.md

@@ -0,0 +1,80 @@
+# ruodoo_demo_data — Описание модуля и требования к установке
+
+Модуль загружает единый набор демо-данных для всех модулей ruodoo: контрагентов, пользователей, продуктов, договоров, счетов, заказов, проектов, DMS и показателей.
+
+---
+
+## Зависимости
+
+Модуль требует наличия следующих модулей (все должны быть установлены **до** установки `ruodoo_demo_data`):
+
+- `base`, `base_setup`, `account`, `crm`, `project`, `sale`
+- `base_user_role`
+- `docx_report`
+- `l10n_ru_advance_payments`, `l10n_ru_attorney`, `l10n_ru_contract`, `l10n_ru_contract_account`, `l10n_ru_contract_sale`, `l10n_ru_doc`, `l10n_ru_upd_xml`
+- `mklab_base_indicators`, `mklab_base_indicators_extended`, `mklab_dms_document`, `mklab_project_task_indicators`
+- `dms`
+
+Если хотите валидацию ИНН через `base_vat` — он тоже должен быть установлен заранее.
+
+---
+
+## Валюта: рубли вместо долларов
+
+По умолчанию Odoo создаёт компанию с валютой USD. Чтобы все суммы считались в рублях, нужно сделать это вручную до или сразу после установки модуля.
+
+**Шаги:**
+
+1. Перейдите в `Бухгалтерия → Конфигурация → Валюты`.
+2. Найдите `Российский рубль (RUB)` и активируйте его (переключатель в колонке "Активна").
+3. Перейдите в `Настройки → Компании → [ваша компания]`.
+4. В поле "Валюта" выберите `RUB`.
+5. Сохраните.
+
+Если установить `l10n_ru` (российская локализация) **до** `ruodoo_demo_data` — RUB активируется автоматически, останется только выбрать его в настройках компании.
+
+---
+
+## OdooBot — имя не перезаписывается
+
+`base.partner_root` — это системный партнёр OdooBot. Ранее в `data/res_partner.xml` была запись, которая перезаписывала его имя на "Смирнов Дмитрий Александрович". Запись удалена — OdooBot не затрагивается.
+
+Имя директора компании задаётся только через `demo_user_director` (модель `res.users`) и `res.company.chief_id`.
+
+---
+
+## VAT (ИНН) для контрагентов
+
+Модуль `base_vat` проверяет поле `vat`. Для России ожидается 10 цифр ИНН юридического лица без каких-либо префиксов (формат: `7714321098`).
+
+Всем юридическим лицам в `data/res_partner.xml` и `data/res_company.xml` добавлено поле `vat` — только цифры ИНН с валидной контрольной суммой.
+
+| Партнёр | vat |
+|---|---|
+| ООО "Технологии Будущего" | 7714321098 |
+| ООО "Ритейл Плюс" | 7701987652 |
+| ООО "МегаТорг" | 7736543217 |
+| ООО "СтройМатериалы Групп" | 7802876540 |
+| ООО "Снабжение Плюс" | 7703456784 |
+| ООО "ПромКомплект" | 6670123457 |
+| ООО "Моя Компания" (main_partner) | 7704567896 |
+
+Физические лица (контакты, директора) поле `vat` не заполняют.
+
+---
+
+## Порядок установки (шаг за шагом)
+
+1. Установить российскую локализацию: `l10n_ru` (активирует RUB, создаёт план счетов).
+2. Установить все зависимые модули из списка выше.
+3. Перейти в `Настройки → Компании` и вручную установить валюту **RUB**.
+4. Установить `ruodoo_demo_data`.
+5. Проверить: OdooBot в чате должен остаться с именем "OdooBot".
+
+---
+
+## Известные ограничения
+
+- Данные загружаются с `noupdate="1"` — повторная установка не перезапишет изменения, сделанные вручную.
+- Если `base_vat` не установлен — поле `vat` сохраняется без валидации, ошибок не будет.
+- Если `base_vat` установлен — все ИНН в модуле проверены по алгоритму контрольной суммы и пройдут валидацию.