klg-asutk-app/DEPLOY.md

🚀 Руководство по развёртыванию КЛГ АСУ ТК v27

Быстрый старт

1. Клонировать и обновить репозиторий

# Если новый клон
git clone https://github.com/YOUR_ORG/klg-asutk-app.git
cd klg-asutk-app

# Если обновление — распаковать zip поверх
unzip klg-asutk-app-v27-fgis.zip -d /tmp/v27
rsync -av --exclude='node_modules' --exclude='.next' --exclude='.git' \
  /tmp/v27/ ./

# Закоммитить
git add -A
git commit -m "v27: ФГИС РЭВС integration + production hardening"
git push origin main

2. Настроить окружение

cp .env.example .env
nano .env

Ключевые переменные:

# База данных
DB_USER=klg
DB_PASSWORD=<strong_password>
DB_NAME=klg

# Безопасность
SECRET_KEY=<random_64_chars>
KC_ADMIN_PASSWORD=<keycloak_password>

# ФГИС РЭВС (для production)
FGIS_API_URL=https://fgis-revs.favt.gov.ru/api/v2
FGIS_ORG_ID=<ваш_id_организации>
FGIS_API_KEY=<api_ключ_фгис>

3. Запустить

# Вариант A: Docker (рекомендуется)
make prod

# Вариант B: Вручную
make docker-up       # PostgreSQL + Redis + Keycloak
make install         # Зависимости
make migrate         # Миграции БД
make dev             # Dev-серверы

4. Проверить

make health          # Состояние системы
make test            # 164 теста
make fgis-status     # Статус ФГИС РЭВС

---

Обновление существующей установки

Из GitHub

git pull origin main
make install         # Обновить зависимости
make migrate         # Новые миграции
make docker-rebuild  # Пересобрать контейнеры

Из ZIP-архива

# 1. Бэкап
make backup-db

# 2. Распаковать поверх
unzip -o klg-asutk-app-v27-fgis.zip -d .

# 3. Установить новые зависимости
cd backend && pip install openpyxl reportlab psutil --break-system-packages
cd ..

# 4. Применить миграции
make migrate

# 5. Перезапустить
make docker-rebuild
# или для dev:
# Ctrl+C на серверах, затем make dev

---

Структура проекта

klg-asutk-app/
├── backend/                    # FastAPI (Python)
│   ├── app/
│   │   ├── api/routes/         # 33 route files, 174 endpoints
│   │   ├── models/             # 20 SQLAlchemy models
│   │   ├── services/           # fgis_revs, ws_manager, email, scheduler
│   │   └── main.py             # Entry point
│   ├── migrations/             # 4 SQL files
│   ├── tests/                  # 144 tests
│   ├── Dockerfile
│   └── requirements.txt
├── app/                        # Next.js pages (35 pages)
├── components/                 # React components (52)
├── hooks/                      # Custom hooks
├── lib/                        # Utilities
├── e2e/                        # Playwright E2E tests (20)
├── public/                     # Static files + PWA
├── docker-compose.yml          # Full stack
├── Makefile                    # All commands
├── Dockerfile                  # Frontend
└── .env.example

---

ФГИС РЭВС: настройка production

1. Получить сертификат ГОСТ

# Разместить файлы:
mkdir -p certs/fgis
cp client.pem certs/fgis/
cp client.key certs/fgis/
cp ca-bundle.pem certs/fgis/

2. Настроить .env

FGIS_API_URL=https://fgis-revs.favt.gov.ru/api/v2
FGIS_ORG_ID=<id из личного кабинета ФГИС>
FGIS_API_KEY=<ключ API>

3. Зарегистрироваться в СМЭВ 3.0

Для юридически значимого обмена данными требуется:

• Регистрация в СМЭВ 3.0 (Постановление Правительства РФ № 697)
• УКЭП (усиленная квалифицированная электронная подпись)
• Сертификат ГОСТ Р 34.10-2012

4. Включить auto-sync

Auto-sync запускается scheduler-ом каждые 24 часа автоматически. Для ручного запуска:

make fgis-sync

---

Команды Makefile

Команда	Описание
make help	Показать все команды
make dev	Запуск dev-серверов
make prod	Production через Docker
make test	Все тесты (164)
make migrate	Применить миграции
make health	Проверка здоровья
make fgis-sync	Синхронизация ФГИС РЭВС
make fgis-status	Статус подключения ФГИС
make backup-db	Бэкап PostgreSQL
make docker-rebuild	Пересборка контейнеров
make clean	Очистка кеша

---

CI/CD (GitHub Actions)

Workflow .github/workflows/ci.yml автоматически:

1. Запускает backend тесты (pytest)
2. Запускает frontend lint
3. Собирает Docker образы
4. (Optional) деплоит на сервер

---

© АО «REFLY» — Разработчик АСУ ТК КЛГ