# Клонировать
git clone https://github.com/Av75057/1c-mcp-sales-analyst.git
cd 1c-mcp-sales-analyst

# Настроить
cp .env.example .env
# Отредактировать .env: DEEPSEEK_API_KEY, C1_BASE_URL, C1_USERNAME, C1_PASSWORD

# Установить
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"

# Запустить Web UI
./start.sh web
# → http://localhost:8000 | admin / admin123

# Аутентификация
POST /api/auth/login          # username + password → JWT
POST /api/auth/logout         # сброс cookie
GET  /api/auth/me             # текущий пользователь

# Чат
GET  /api/chat/sessions       # список сессий
POST /api/chat/sessions       # создать сессию
GET  /api/chat/sessions/{id}/messages
POST /api/chat/sessions/{id}/messages  # отправить сообщение
GET  /api/chat/search?q=      # поиск по сообщениям

# Поиск
POST /api/search/nomenclature # поиск с фильтрами
GET  /api/search/autocomplete?q=  # автодополнение
GET  /api/search/synonyms     # список синонимов

# Админка
GET  /admin/                  # дашборд
GET  /admin/users/            # пользователи
GET  /admin/audit/            # логи аудита
GET  /admin/monitoring/       # мониторинг
GET  /admin/settings/         # настройки
GET  /admin/integrations/     # интеграции
GET  /admin/tools/            # MCP инструменты
GET  /admin/system/           # система

# Мониторинг
GET  /health                  # health check
GET  /health/live             # liveness probe
GET  /metrics                 # Prometheus метрики

# 1С
POST /hs/api/v1/batch         # batch-запросы
GET  /hs/api/stock            # остатки
GET  /hs/api/sales            # продажи

# Все тесты
pytest tests/ -v

# По модулям
pytest tests/test_search.py
pytest tests/test_chat_models.py
pytest tests/test_guardrails.py
pytest tests/test_resilience.py
pytest tests/test_admin.py
pytest tests/integration/

# С coverage
pytest tests/ --cov=src --cov=web --cov-report=term
pytest tests/ --cov=src --cov=web --cov-report=html
# → открыть htmlcov/index.html

# Сборка
docker compose build

# Запуск всех сервисов
docker compose up -d

# Только proxy + web-ui
docker compose up -d proxy open-webui

# Логи
docker compose logs -f

src/
├── admin/            # Админ-панель (16 модулей)
├── anonymization/    # Анонимизация ПДн (токены ПЕРС/ОРГ/КОНТ/ФИН/ДОК)
├── auth/             # JWT + RBAC аутентификация
├── audit/            # Аудит + AuditLogger
├── chat/             # История сессий чата
├── clients/          # C1Client + BatchC1Client
├── data_quality/     # Качество данных (Pydantic, валидация, anomalies)
├── events/           # Event Bus (publish/subscribe, dead letter)
├── guardrails/       # Верификация AI + защита
├── health/           # Health checks /health /health/live /health/ready
├── mcp/              # MCP tools registry
├── metadata/         # Метаданные 1С (config, describe, get_structure)
├── observability/    # Prometheus метрики + middleware
├── proactive/        # Proactive analytics (scheduler, отчёты)
├── query/            # Декларативный QueryBuilder для 1С
├── rag/              # База знаний (SQLite + поиск)
├── reflection/       # Self-Reflection (AI критик ответов)
├── resilience/       # Circuit Breaker
├── search/           # FTS5 + fuzzy + synonyms + autocomplete
├── security/         # Security headers + rate limiting + ReadOnlyGuard
├── workflows/        # Workflow engine + бизнес-workflow
└── whatif/           # What-If симуляции

web/
├── app.py          # FastAPI приложение
└── templates/      # HTML шаблоны