Import Vector lab project

2026-06-06 18:31:55 +00:00
commit fcc22063ed
105 changed files with 31639 additions and 0 deletions
@@ -0,0 +1,117 @@
+# Инструкция по развертыванию SAR-MCHS на LXC 108
+
+## Текущее состояние
+
+Проект развернут на LXC 108 (Lab) по адресу: **192.168.0.108**
+
+## Доступ к сервисам
+
+- **Backend API**: http://192.168.0.108:8000
+  - Swagger документация: http://192.168.0.108:8000/docs
+  - ReDoc: http://192.168.0.108:8000/redoc
+  
+- **Frontend**: http://192.168.0.108:3000
+
+- **Adminer** (управление БД): http://192.168.0.108:8080
+  - Система: PostgreSQL
+  - Сервер: postgres
+  - Пользователь: postgres
+  - Пароль: postgres
+  - База данных: sar_mchs
+
+- **PostgreSQL**: 192.168.0.108:5432
+
+## Управление проектом
+
+### Запуск проекта
+```bash
+cd /root/sar-mchs
+docker compose up -d
+```
+
+### Остановка проекта
+```bash
+cd /root/sar-mchs
+docker compose down
+```
+
+### Перезапуск с пересборкой
+```bash
+cd /root/sar-mchs
+docker compose down
+docker compose up -d --build
+```
+
+### Просмотр логов
+```bash
+# Все сервисы
+docker compose logs -f
+
+# Конкретный сервис
+docker compose logs -f backend
+docker compose logs -f frontend
+docker compose logs -f postgres
+```
+
+### Статус сервисов
+```bash
+docker compose ps
+```
+
+## Настройка
+
+Переменные окружения находятся в файле `/root/sar-mchs/.env`
+
+Важные переменные:
+- `ANTHROPIC_API_KEY` - API ключ для Claude (требуется для функции анализа)
+- `JWT_SECRET` - секрет для JWT токенов
+- `DATABASE_URL` - строка подключения к PostgreSQL
+- `CORS_ORIGINS` - разрешенные origins для CORS
+
+## Структура проекта
+
+```
+/root/sar-mchs/
+├── backend/              # FastAPI backend
+│   ├── api/v1/          # API endpoints
+│   ├── main.py          # Точка входа
+│   ├── requirements.txt
+│   └── Dockerfile
+├── frontend/            # React frontend
+│   ├── src/
+│   ├── public/
+│   ├── package.json
+│   └── Dockerfile
+├── docker-compose.yml   # Конфигурация Docker Compose
+├── .env                 # Переменные окружения
+└── README.md
+```
+
+## Подключение к LXC 108
+
+Из Proxmox хоста:
+```bash
+pct exec 108 -- bash
+```
+
+Через SSH с вашей машины:
+```bash
+ssh root@192.168.0.65 "pct exec 108 -- bash"
+```
+
+## Следующие шаги
+
+1. Добавить ANTHROPIC_API_KEY в .env файл
+2. Настроить базу данных (миграции Alembic)
+3. Создать модели SQLAlchemy
+4. Реализовать аутентификацию с JWT
+5. Интегрировать Claude API для анализа документов
+6. Разработать React компоненты для frontend
+
+## Проверка работоспособности
+
+Все сервисы запущены и доступны:
+- ✅ PostgreSQL 16 (порт 5432)
+- ✅ Adminer (порт 8080)
+- ✅ Backend API (порт 8000)
+- ✅ Frontend (порт 3000)