Skip to content

ROADMAP.md

Latest commit

 

History

History
97 lines (75 loc) · 5.34 KB

ROADMAP.md

File metadata and controls

97 lines (75 loc) · 5.34 KB
Raw

URY-RU — Дорожная карта

URY-RU — форк URY (open-source система управления рестораном на базе ERPNext), адаптированный для российского рынка.

Цель: создать open-source аналог iiko, не уступающий по функционалу.

Лицензия

Апстрим URY распространяется под AGPL-3.0. URY-RU сохраняет ту же лицензию.

Архитектура

URY — монорепо, содержащее несколько приложений:

Директория Назначение
ury/ Основное Frappe-приложение (бэкенд, doctype, отчёты, API)
pos/ POS-фронтенд (Vite/React)
mosaic/ Kitchen Display System (KDS)
self-order/ Самообслуживание (QR-меню)
urypos/ Устаревший POS (legacy)
packages/ Общие core/ui пакеты
ury_ru/ Новое Frappe-приложение — российская локализация и интеграции

Модули (приложение ury_ru)

Каждый модуль — это Frappe-модуль внутри приложения ury_ru (папка ury_ru/ury_ru/<module>/, имя модуля в ury_ru/modules.txt).

Модуль Название Интеграции
URY_RU_1C Обмен с 1С 1С:Предприятие (CommerceML / REST / обмен через файлы)
URY_RU_Fiscal Фискализация АТОЛ, ШТРИХ-М, ОФД, 54-ФЗ
URY_RU_Payments Платежи Т-Банк, Сбер, СБП
URY_RU_Delivery Доставка Яндекс Еда, Маркет Деливери
URY_RU_Marking Маркировка Честный знак
URY_RU_EGAIS Алкоголь ЕГАИС
URY_RU_Mercury Ветконтроль Меркурий

Полный список интеграций

  1. 1С — обмен номенклатурой, остатками, ценами, заказами, выручкой
  2. АТОЛ / ШТРИХ-М — ККТ (кассовое оборудование)
  3. ОФД — операторы фискальных данных
  4. 54-ФЗ — фискальные чеки, ФФД 1.2
  5. Т-Банк — эквайринг
  6. Сбер — эквайринг (Сбербанк)
  7. СБП — Система быстрых платежей (QR)
  8. Яндекс Еда — агрегатор доставки
  9. Маркет Деливери — агрегатор доставки
  10. Честный знак — маркировка товаров
  11. ЕГАИС — учёт алкоголя
  12. Меркурий — ветеринарный учёт

Этапы (план работ)

Этап 0 — База (текущий)

  • Форк URY в webzuweb/URY-RU
  • Каркас приложения ury_ru + модули
  • Детальный проект и каркас кода всех 7 модулей (интерфейс провайдера + реестр + simulated + заглушки + doctypes)
  • Развернуть dev-окружение (bench + erpnext + ury)
  • CI: линтеры, тесты

Этап 1 — 1С и мастер-данные

  • Модуль URY_RU_1C: обмен номенклатурой/остатками/ценами
  • Настройка форматов обмена (XML/CommerceML, JSON)

Этап 2 — Фискализация (54-ФЗ)

  • Модуль URY_RU_Fiscal: драйверы АТОЛ и ШТРИХ-М
  • Печать чеков, ФФД 1.2, интеграция с ОФД

Этап 3 — Платежи

  • Модуль URY_RU_Payments: Т-Банк, Сбер, СБП
  • Привязка платежей к чекам/заказам

Этап 4 — Доставка и агрегаторы

  • Модуль URY_RU_Delivery: Яндекс Еда, Маркет Деливери
  • Приём заказов, статусы, меню-фиды

Этап 5 — Маркировка, ЕГАИС, Меркурий

  • Модуль URY_RU_Marking (Честный знак)
  • Модуль URY_RU_EGAIS
  • Модуль URY_RU_Mercury

Этап 6 — Производство и паритет с iiko

  • Сверка функционала с iiko (склад, производство, техкарты, банкеты, программы лояльности)
  • Закрытие пробелов

Правила разработки

  • Код RU-локализации не должен менять файлы апстрима ury/ без необходимости. Всё новое — в ury_ru/ и через Frappe-хуки (override, hooks).
  • При изменениях апстрима — минимизировать, документировать, готовить к rebase.
  • Периодически синхронизировать upstream/develop.
  • Каждый модуль — изолирован: настройки в отдельном Doctype Settings, подключение через hooks.py.