# 📚 ERP для мастеров - Документация проекта

## 🎯 Обзор проекта

**Название:** ERP для мастеров  
**Позиционирование:** "Умный учет для мастеров — от хаоса к порядку без лишних затрат"  
**Целевая аудитория:** Микропроизводства и мастерские 1-15 человек

### Ключевая ценность
Превращение хаотичного "гаражного" производства в организованную систему с минимальными затратами на оборудование и максимальной простотой использования.

---

## 📋 Структура документации

### 🚀 MVP (Текущий этап)
- [[MVP-План|MVP План]] - Концентрированный план минимально жизнеспособного продукта
- [[Техническое-задание-MVP|Техническое задание MVP]] - Функциональные требования для MVP
- [[Архитектура-MVP|Архитектура MVP]] - Базовая техническая архитектура

### 🔮 Post-MVP (Будущие этапы)
- [[Post-MVP/Computer-Vision|Computer Vision]] - Распознавание чеков и товаров
- [[Post-MVP/Аналитика|Аналитика]] - Отчеты и бизнес-аналитика
- [[Post-MVP/Расширенные-функции|Расширенные функции]] - Интеграции, AI, безопасность

---

## 🚀 Быстрый старт

### Для разработчиков
1. Начните с [[MVP-План|MVP плана]] для понимания приоритетов
2. Изучите [[Архитектура-MVP|архитектуру]] для технических деталей
3. Ознакомьтесь с [[Техническое-задание-MVP|ТЗ]] для понимания MVP функций

### Для менеджеров
1. [[MVP-План|MVP план]] - временные рамки и ресурсы
2. [[Техническое-задание-MVP|ТЗ]] - функциональные требования и метрики
3. [[Post-MVP/Расширенные-функции|Расширенные функции]] - долгосрочная перспектива

---

## 📊 Ключевые метрики

### MVP метрики
- **Время размещения товара:** ≤ 30 секунд
- **Время поиска места:** ≤ 20 секунд
- **7-дневная ретенция:** ≥ 50%
- **Активация:** создание схемы + печать QR в первую сессию

### Технические метрики
- **Время отклика API:** ≤ 200мс
- **Доступность:** ≥ 99.5%
- **Ошибки сканирования:** ≤ 1%

---

## 🛠️ Технологический стек

### Backend
- **Язык:** Go
- **База данных:** PostgreSQL
- **Кэширование:** Redis
- **Аутентификация:** JWT

### Core Service
- **Язык:** Go (Gin)
- **База данных:** PostgreSQL
- **Аутентификация:** JWT
- **Межсервисная коммуникация:** gRPC

### Document Service
- **Язык:** Python (FastAPI)
- **Кэширование:** Redis
- **Документы:** PDF, Excel, Word
- **Шаблоны:** Jinja2

### Frontend
- **Фреймворк:** Angular PWA
- **Дизайн:** Material UI + Tailwind CSS
- **QR Scanner:** @zxing/ngx-scanner
- **State Management:** NgRx

### Инфраструктура
- **Контейнеризация:** Docker + Docker Compose
- **Межсервисная коммуникация:** gRPC + Protocol Buffers
- **Безопасность:** HTTPS, CORS, JWT
- **Мониторинг:** Prometheus + Grafana

---

## 📅 Временные рамки

### MVP разработка
- **Общее время:** 8-10 недель
- **Команда:** 2 разработчика + 1 дизайнер
- **Бюджет:** $30,000-50,000

### Этапы
1. **Фундамент** (2 недели) - инфраструктура и аутентификация
2. **Шаблоны + QR** (3 недели) - генерация мест и кодов
3. **Мобильное приложение** (2 недели) - PWA и сканирование
4. **Базовые операции** (2 недели) - управление товарами
5. **Тестирование** (1 неделя) - пилот с реальными пользователями

---

## 🎯 Целевые вертикали

- Мебельные/столярные мастерские
- Ювелирные производства
- Кондитерские/пекарни
- Мастерские по ремонту
- 3D-печать и прототипирование
- Рекламные агентства (POS-материалы)
- Художественные мастерские
- Производство моделей и сувениров

---

## 🔗 Связанные теги

#erp #master-workshop #inventory-management #qr-codes #mobile-app #saas #micro-production #warehouse-management #pwa #go #postgresql #react

---

## 📝 Примечания

- Все документы обновляются по мере развития проекта
- MVP фокусируется на организации складского пространства с QR-адресацией
- Post-MVP функции вынесены в отдельные документы для будущих этапов
- Архитектура подготовлена для масштабирования на полный продукт