refactor documentation

This commit is contained in:
2025-08-26 20:39:12 +04:00
parent 76dd059647
commit 1882f82596
12 changed files with 965 additions and 2130 deletions

View File

@@ -0,0 +1,135 @@
# Техническое задание MVP: ERP для мастеров
## 1. Концепция продукта
**Название:** ERP для мастеров
**Позиционирование:** "Умный учет для мастеров — от хаоса к порядку без лишних затрат"
**Целевая аудитория:** Микропроизводства и мастерские 1-15 человек
### 1.1 Ключевая ценность MVP
Превращение хаотичного хранения в организованную систему с QR-адресацией и мобильным сканированием.
### 1.2 Целевые вертикали
- Мебельные/столярные мастерские
- Ювелирные производства
- Кондитерские/пекарни
- Мастерские по ремонту
---
## 2. Функциональные требования MVP
### 2.1 Модуль организации складского пространства
#### 2.1.1 Шаблоны помещений
**Требования:**
- 3 готовых шаблона: Гараж, Мастерская, Склад
- Автоматическая генерация мест хранения из шаблона
- Простая настройка размеров помещения
- Возможность добавления/удаления элементов мебели
**Адресация мест:**
- Шкафы: Шкаф-Полка-Ячейка (Ш1-П2-Я3)
- Напольное хранение: Зона-Участок (З1-У2)
- Столы: Стол-Элемент (С1-Я1, С1-Пов)
#### 2.1.2 QR-маркировка
**Требования:**
- Генерация уникальных QR-кодов для каждого места
- Кодирование в QR: ID места, адрес, координаты
- Печать этикеток на обычном принтере (A4)
- Сетка этикеток на лист с предварительным просмотром
#### 2.1.3 Виртуальная карта
**Требования:**
- Схематичный вид расположения мест
- Цветовое кодирование загруженности:
- Зеленый: свободно
- Желтый: частично заполнено
- Красный: переполнено
- Интерактивность: клик на место → список товаров
### 2.2 Мобильное приложение (PWA)
#### 2.2.1 Сканирование QR-кодов
**Требования:**
- Сканирование камерой телефона
- Распознавание QR-кодов в реальном времени
- Автоматический переход к операции с местом
- Обработка ошибок сканирования
#### 2.2.2 Быстрые операции
**Требования:**
- Размещение товара: сканирование места → выбор товара → подтверждение
- Поиск товара: сканирование места → показ списка товаров
- Перемещение: сканирование места откуда → сканирование места куда → выбор товара
### 2.3 Справочники
#### 2.3.1 Товары
**Требования:**
- Создание товара: название, описание, категория
- Редактирование товара
- Поиск по названию или описанию
- Категории: Сырье, Готовая продукция, Инструменты, Расходники
#### 2.3.2 Места хранения
**Требования:**
- Иерархическая структура: помещение → зона → место
- Характеристики места: тип, размеры, ограничения
- Статус места: свободно, занято, зарезервировано
### 2.4 Операции
#### 2.4.1 Размещение товаров
**Требования:**
- Выбор товара из справочника
- Выбор места размещения
- Указание количества
- Автоматическое обновление статуса места
#### 2.4.2 Поиск товаров
**Требования:**
- Поиск по названию товара
- Поиск по адресу места
- Поиск по категории
- Результат: список мест с товарами
---
## 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 чеков: ручной ввод с автодополнением