update documentation

This commit is contained in:
2025-08-26 20:50:21 +04:00
parent 1882f82596
commit f663ff286d
7 changed files with 580 additions and 80 deletions

View File

@@ -15,6 +15,24 @@
- Кондитерские/пекарни
- Мастерские по ремонту
### 1.3 Пользовательские сценарии
```mermaid
journey
title Пользовательский сценарий: Организация склада
section Настройка
Создание организации: 5: Мастер
Выбор шаблона помещения: 4: Мастер
Настройка размеров: 3: Мастер
Генерация QR-кодов: 5: Система
Печать этикеток: 4: Мастер
section Использование
Сканирование QR-кода: 5: Мастер
Размещение товара: 4: Мастер
Поиск товара: 5: Мастер
Перемещение товара: 3: Мастер
```
---
## 2. Функциональные требования MVP
@@ -37,8 +55,9 @@
**Требования:**
- Генерация уникальных QR-кодов для каждого места
- Кодирование в QR: ID места, адрес, координаты
- Печать этикеток на обычном принтере (A4)
- Печать этикеток на обычном принтере (A4) через Document Service
- Сетка этикеток на лист с предварительным просмотром
- Кэширование сгенерированных QR-кодов в Redis
#### 2.1.3 Виртуальная карта
**Требования:**
@@ -49,20 +68,22 @@
- Красный: переполнено
- Интерактивность: клик на место → список товаров
### 2.2 Мобильное приложение (PWA)
### 2.2 Мобильное приложение (Angular PWA)
#### 2.2.1 Сканирование QR-кодов
**Требования:**
- Сканирование камерой телефона
- Сканирование камерой телефона через @zxing/ngx-scanner
- Распознавание QR-кодов в реальном времени
- Автоматический переход к операции с местом
- Обработка ошибок сканирования
- Offline поддержка через Service Worker
#### 2.2.2 Быстрые операции
**Требования:**
- Размещение товара: сканирование места → выбор товара → подтверждение
- Поиск товара: сканирование места → показ списка товаров
- Перемещение: сканирование места откуда → сканирование места куда → выбор товара
- State management через NgRx для сложных операций
### 2.3 Справочники
@@ -87,6 +108,7 @@
- Выбор места размещения
- Указание количества
- Автоматическое обновление статуса места
- Валидация через gRPC между сервисами
#### 2.4.2 Поиск товаров
**Требования:**
@@ -94,6 +116,24 @@
- Поиск по адресу места
- Поиск по категории
- Результат: список мест с товарами
- Кэширование результатов поиска в Redis
### 2.5 Document Service
#### 2.5.1 Генерация документов
**Требования:**
- Генерация PDF этикеток с QR-кодами
- Создание Excel отчетов по товарам
- Экспорт данных в Word документы
- Шаблонизация через Jinja2
- Асинхронная обработка через Redis
#### 2.5.2 Кэширование
**Требования:**
- Кэширование сгенерированных документов
- TTL для документов: 24 часа
- Автоматическая очистка старых документов
- Статистика использования кэша
---