Files
public/ruodoo_demo_data/README.md

81 lines
4.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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` установлен — все ИНН в модуле проверены по алгоритму контрольной суммы и пройдут валидацию.