refactor project

This commit is contained in:
2026-01-12 22:42:22 +03:00
parent d32e367383
commit afd6b2c1fd
16 changed files with 806 additions and 2342 deletions

142
ROADMAP.md Normal file
View File

@ -0,0 +1,142 @@
# HotelTask - Дорожная карта
## Текущий статус: Проектирование
---
## Этап 0: Аналитика
**Статус:** Завершен
- [x] Собраны бизнес-требования
- [x] Структурированы FR/NFR
- [x] Определены роли пользователей
- [x] Определен scope MVP
---
## Этап 1: Проектирование
**Статус:** В процессе
- [x] Высокоуровневая архитектура
- [ ] Схема БД (ERD)
- [ ] API контракты (OpenAPI)
- [ ] Модель данных Task
---
## Этап 2: MVP
**Статус:** Ожидает
### Что входит в MVP:
**Управление пользователями:**
- Регистрация и авторизация
- Роли: Администратор, Менеджер/Супервайзер, Линейный сотрудник
- Привязка к подразделениям
**Управление задачами:**
- CRUD операции с задачами
- Все статусы: новая, в работе, ожидает, выполнена, пауза, отменена
- Типы задач, приоритеты, сроки
- Назначение исполнителей
**Уведомления:**
- Push-уведомления о новых задачах
- Уведомления о завершении задач
**Комментарии и вложения:**
- Комментарии к задачам
- Прикрепление фото и файлов
- История изменений
**Поиск и фильтрация:**
- Поиск по названию и описанию
- Фильтры по статусу, приоритету, сотруднику, дате
**Интерфейсы:**
- Веб-интерфейс (адаптивный)
**Интеграции:**
- Базовая интеграция с PMS
- Система адаптеров
- Управление связями между системами
### Разработка MVP:
- [ ] Инфраструктура (Docker, Kafka, PostgreSQL, Redis)
- [ ] tasks-service
- [ ] users-service
- [ ] permissions-service
- [ ] notification-service
- [ ] file-storage-service
- [ ] API Gateway
- [ ] Web Admin
- [ ] PMS Adapter
---
## Этап 3: Расширение функционала
**Статус:** Планируется
### 3.1 Аудит и аналитика
- audit-service
- Отчет по выполненным задачам за период
- Статистика по сотрудникам
- Статистика по типам задач
- Процент просроченных задач
### 3.2 Планировщик
- scheduler-service
- Создание регулярных/периодических задач
- Автоматическое создание задач по расписанию
### 3.3 Трекинг времени
- Время начала и окончания задачи
- Учет времени выполнения
---
## Этап 4: Специализированные модули
**Статус:** Планируется
### 4.1 Модуль мероприятий (Events Management)
- events-service
- Описание мероприятия
- Автоматическая декомпозиция на задачи
- Массовое создание связанных задач
- Формирование документа "функшн"
### 4.2 Специализированный интерфейс горничных
- Пошаговый процесс уборки
- Обязательное фото до и после
- Фиксация времени уборки
### 4.3 Складской модуль
- Учет материалов по службам
- Списание при выполнении задач
---
## Этап 5: Расширение каналов
**Статус:** Планируется
### 5.1 Мобильные приложения
- Android приложение (8.0+)
- iOS приложение (14+)
### 5.2 Интерфейс для гостей
- Telegram-бот / веб-приложение
- Базовые услуги с кнопками
- Автоматическое создание задач из запросов
### 5.3 Голосовой ввод
- Транскрипция голосовых сообщений в текст
### 5.4 Интеграция с AI
- Обработка свободных текстовых запросов
---
## Что НЕ входит в ближайшие планы:
- Гранулярные права доступа (кастомные permissions)
- Настройка типов уведомлений для пользователя
- Интеграция с Консьерж Resonline