Перейти к содержанию

Alatyr Service

Магистральная платформа и внешняя техническая служба для установленных систем объекта на alatyr-service.ru. Первые продажи уже идут через тенант ИП Головин Р.Ю.

Видение

Платформа объединяет обследование, восстановление, документацию и обслуживание инженерных объектов. Продаёт частным клиентам и бизнесу связь, Wi-Fi, камеры, удалённый доступ, серверы и обслуживание. Один технический ответственный вместо продажи отдельных работ — единый куратор для видеонаблюдения, СКУД, сигнализации, сети, серверного оборудования и резервного питания.

Публичный оффер разделён на три посадочные страницы: «Внешняя техническая служба для бизнеса», «Обслуживание видеонаблюдения», «Приёмка существующих систем на обслуживание». Целевые объекты — государственные, социальные, коммерческие и частные, без перечисления конкретных площадок.

Два контура монетизации

Первый контур — мониторинг и регламентированная реакция через собственника, диспетчерскую, экстренные службы или лицензированного партнёра. Опирается на паспорт объекта.

Второй контур — распределение повторных работ между собственными и партнёрскими бригадами. Исполнитель получает документированную конфигурацию, доступы и историю объекта — это делает работу воспроизводимой и продаваемой.

Ключевые архитектурные решения

  • Multi-tenant by default — с MT-01 tenant является архитектурным якорем; новые таблицы, API, RAG-коллекции обязаны нести tenant_id. Эпик MT (17 задач) закрывает миграцию существующих таблиц
  • Объект как центральная сущность — заявка хранит обращение до принятия, объект объединяет клиента, ответственное ИП, договоры, документы, команду и работы. Счета и абонентки встроены в объект
  • Три слоя данных — статика и каталог в Git/RAG, объекты и управленческие платежи в CRM, бухгалтерская первичка в «Моё Дело»
  • Одна CRM для двух ИП — own_companies + ownCompanyId на договорах и объектах, чтобы ИП Р.Ю. и ИП А.Р. (Коробочка) вести в одной системе
  • PostgreSQL после защиты SQLite — production использует SQLite с проверяемыми backup-ами; переход на PostgreSQL включён в MT-эпик

Стек

  • TypeScript-приложение на VPS vm-mini
  • Node.js, systemd, nginx, GitHub Actions
  • SQLite с ежедневным проверяемым backup (CRM-63 закрыт)
  • МойСклад — каталог, остатки, синхронизация 142 услуг
  • МоёДело — бухгалтерская первичка, платёжный статус
  • ЮKassa — платежи через ИП Коробочка
  • Vaultwarden — хранение секретов
  • alatyr-storage-api — файловое хранилище на ragserver
  • RAG-ассистент — read-only через AGENT_READ_TOKEN

Разделы проекта

  • CRM — управление объектами, заявками, клиентами, документами (~64 активных задач)
  • MT — мультитенантный эпик (17 задач)
  • RAG — интеграция с локальной RAG-платформой (10 задач)
  • INF — общая инфраструктура (5 задач)
  • Документы — договорооборот, сметы, счета, акты, КС-2/КС-3

Пока задачи ведутся в общем TODO.md; после INF-05 переезжают в projects/alatyr-service/<section>/tasks/.

Ссылки