176 lines
8.1 KiB
Markdown
176 lines
8.1 KiB
Markdown
# Техническое задание MVP: ERP для мастеров
|
||
|
||
## 1. Концепция продукта
|
||
|
||
**Название:** ERP для мастеров
|
||
**Позиционирование:** "Умный учет для мастеров — от хаоса к порядку без лишних затрат"
|
||
**Целевая аудитория:** Микропроизводства и мастерские 1-15 человек
|
||
|
||
### 1.1 Ключевая ценность MVP
|
||
Превращение хаотичного хранения в организованную систему с QR-адресацией и мобильным сканированием.
|
||
|
||
### 1.2 Целевые вертикали
|
||
- Мебельные/столярные мастерские
|
||
- Ювелирные производства
|
||
- Кондитерские/пекарни
|
||
- Мастерские по ремонту
|
||
|
||
### 1.3 Пользовательские сценарии
|
||
|
||
```mermaid
|
||
journey
|
||
title Пользовательский сценарий: Организация склада
|
||
section Настройка
|
||
Создание организации: 5: Мастер
|
||
Выбор шаблона помещения: 4: Мастер
|
||
Настройка размеров: 3: Мастер
|
||
Генерация QR-кодов: 5: Система
|
||
Печать этикеток: 4: Мастер
|
||
section Использование
|
||
Сканирование QR-кода: 5: Мастер
|
||
Размещение товара: 4: Мастер
|
||
Поиск товара: 5: Мастер
|
||
Перемещение товара: 3: Мастер
|
||
```
|
||
|
||
---
|
||
|
||
## 2. Функциональные требования MVP
|
||
|
||
### 2.1 Модуль организации складского пространства
|
||
|
||
#### 2.1.1 Шаблоны помещений
|
||
**Требования:**
|
||
- 3 готовых шаблона: Гараж, Мастерская, Склад
|
||
- Автоматическая генерация мест хранения из шаблона
|
||
- Простая настройка размеров помещения
|
||
- Возможность добавления/удаления элементов мебели
|
||
|
||
**Адресация мест:**
|
||
- Шкафы: Шкаф-Полка-Ячейка (Ш1-П2-Я3)
|
||
- Напольное хранение: Зона-Участок (З1-У2)
|
||
- Столы: Стол-Элемент (С1-Я1, С1-Пов)
|
||
|
||
#### 2.1.2 QR-маркировка
|
||
**Требования:**
|
||
- Генерация уникальных QR-кодов для каждого места
|
||
- Кодирование в QR: ID места, адрес, координаты
|
||
- Печать этикеток на обычном принтере (A4) через Document Service
|
||
- Сетка этикеток на лист с предварительным просмотром
|
||
- Кэширование сгенерированных QR-кодов в Redis
|
||
|
||
#### 2.1.3 Виртуальная карта
|
||
**Требования:**
|
||
- Схематичный вид расположения мест
|
||
- Цветовое кодирование загруженности:
|
||
- Зеленый: свободно
|
||
- Желтый: частично заполнено
|
||
- Красный: переполнено
|
||
- Интерактивность: клик на место → список товаров
|
||
|
||
### 2.2 Мобильное приложение (Angular PWA)
|
||
|
||
#### 2.2.1 Сканирование QR-кодов
|
||
**Требования:**
|
||
- Сканирование камерой телефона через @zxing/ngx-scanner
|
||
- Распознавание QR-кодов в реальном времени
|
||
- Автоматический переход к операции с местом
|
||
- Обработка ошибок сканирования
|
||
- Offline поддержка через Service Worker
|
||
|
||
#### 2.2.2 Быстрые операции
|
||
**Требования:**
|
||
- Размещение товара: сканирование места → выбор товара → подтверждение
|
||
- Поиск товара: сканирование места → показ списка товаров
|
||
- Перемещение: сканирование места откуда → сканирование места куда → выбор товара
|
||
- State management через NgRx для сложных операций
|
||
|
||
### 2.3 Справочники
|
||
|
||
#### 2.3.1 Товары
|
||
**Требования:**
|
||
- Создание товара: название, описание, категория
|
||
- Редактирование товара
|
||
- Поиск по названию или описанию
|
||
- Категории: Сырье, Готовая продукция, Инструменты, Расходники
|
||
|
||
#### 2.3.2 Места хранения
|
||
**Требования:**
|
||
- Иерархическая структура: помещение → зона → место
|
||
- Характеристики места: тип, размеры, ограничения
|
||
- Статус места: свободно, занято, зарезервировано
|
||
|
||
### 2.4 Операции
|
||
|
||
#### 2.4.1 Размещение товаров
|
||
**Требования:**
|
||
- Выбор товара из справочника
|
||
- Выбор места размещения
|
||
- Указание количества
|
||
- Автоматическое обновление статуса места
|
||
- Валидация через gRPC между сервисами
|
||
|
||
#### 2.4.2 Поиск товаров
|
||
**Требования:**
|
||
- Поиск по названию товара
|
||
- Поиск по адресу места
|
||
- Поиск по категории
|
||
- Результат: список мест с товарами
|
||
- Кэширование результатов поиска в Redis
|
||
|
||
### 2.5 Document Service
|
||
|
||
#### 2.5.1 Генерация документов
|
||
**Требования:**
|
||
- Генерация PDF этикеток с QR-кодами
|
||
- Создание Excel отчетов по товарам
|
||
- Экспорт данных в Word документы
|
||
- Шаблонизация через Jinja2
|
||
- Асинхронная обработка через Redis
|
||
|
||
#### 2.5.2 Кэширование
|
||
**Требования:**
|
||
- Кэширование сгенерированных документов
|
||
- TTL для документов: 24 часа
|
||
- Автоматическая очистка старых документов
|
||
- Статистика использования кэша
|
||
|
||
---
|
||
|
||
## 3. Нефункциональные требования
|
||
|
||
### 3.1 Производительность
|
||
- Время отклика API: ≤ 200мс
|
||
- Время загрузки PWA: ≤ 3 секунды
|
||
- Поддержка до 1000 товаров на организацию
|
||
|
||
### 3.2 Безопасность
|
||
- JWT аутентификация
|
||
- Organization-scope на всех данных
|
||
- HTTPS для всех соединений
|
||
- Валидация входных данных
|
||
|
||
### 3.3 Удобство использования
|
||
- Мобильно-ориентированный интерфейс
|
||
- Интуитивная навигация
|
||
- Минимум кликов для основных операций
|
||
- Обработка ошибок с понятными сообщениями
|
||
|
||
---
|
||
|
||
## 4. Технические ограничения
|
||
|
||
### 4.1 Что НЕ реализуется в MVP
|
||
- Computer Vision (распознавание чеков)
|
||
- Сложная аналитика и отчеты
|
||
- Офлайн режим работы
|
||
- Интеграции с внешними системами
|
||
- 3D визуализация
|
||
- Гибкие производственные сценарии
|
||
|
||
### 4.2 Упрощения для MVP
|
||
- Вместо графического редактора: готовые шаблоны
|
||
- Вместо умных подсказок: базовые правила размещения
|
||
- Вместо сложного offline: кэш + простая синхронизация
|
||
- Вместо CV чеков: ручной ввод с автодополнением
|