feat: deploy infrastructure + disk/drive, calendar, presentation, workspaces, onboarding, demo user

2026-05-19 16:26:26 +03:00
parent 688d043dad
commit 3529c39b22
304 changed files with 18826 additions and 1176 deletions
@@ -0,0 +1,111 @@
+# Внимание: на сервере работает второй проект — VoIdeaAI
+
+## Дата развёртывания
+2026-05-19
+
+## Сервер
+81.177.141.34 — единый VPS для двух независимых проектов.
+
+---
+
+## 1. Проекты на сервере
+
+### Проект A: aegisone
+| Параметр | Значение |
+|----------|----------|
+| Порты | 8000 (FastAPI), 8080/9000 (PHP), 5432 (PostgreSQL) |
+| Директория | `/opt/projects/aegisone-php/`, `/opt/projects/aegisone-py/` |
+| Домен | aegisone.ru, service.aegisone.ru |
+| Тип | PHP + Python FastAPI |
+
+### Проект B: VoIdeaAI
+| Параметр | Значение |
+|----------|----------|
+| Порты | **8020** (FastAPI), **5444** (PostgreSQL), **6380** (Redis) |
+| Директория | `/opt/projects/voidea/` |
+| Домен | voideaai.ru, git.voideaai.ru (через nginx-proxy) |
+| Gitea | порт 3000, PostgreSQL 5433, git.voideaai.ru |
+| Тип | Python FastAPI + React Frontend |
+
+---
+
+## 2. Критические правила
+
+### НЕ занимать порты VoIdeaAI
+```
+8020  — FastAPI app
+5444  — PostgreSQL
+6380  — Redis
+5433  — Gitea PostgreSQL
+3000  — Gitea web
+```
+
+### nginx-proxy общий
+- Конфиги: `/opt/projects/nginx-proxy/conf.d/`
+- Файл VoIdea: `voideaai.ru.conf`
+- Файл Gitea: `git.voideaai.ru.conf`
+
+**Перед рестартом nginx — всегда проверять:**
+```bash
+docker compose -p nginx-proxy exec nginx nginx -t
+```
+
+### Docker
+- **Все контейнеры используют `network_mode: host`** (bridge не работает на этом VPS)
+- **Docker build** требует `network: host` в конфиге сборки
+- `docker system prune -af` удалит build cache ВСЕХ проектов — не запускать во время сборки
+- `docker compose -p voidea` — префикс для команд VoIdea
+- `docker compose -p gitea` — префикс для команд Gitea
+- `docker compose -p nginx-proxy` — префикс для nginx
+
+### Диск
+- 20GB всего, ~13GB свободно (на момент деплоя)
+- Перед крупными операциями: `df -h /`
+- При нехватке места: `docker builder prune -af`
+
+---
+
+## 3. Команды для проверки состояния VoIdeaAI
+
+```bash
+# Статус
+docker compose -p voidea ps
+
+# Логи
+docker compose -p voidea logs --tail=20 app
+
+# Проверка здоровья
+curl -s http://localhost:8020/health
+curl -s http://localhost:8020/api/v1/health
+
+# Состояние БД
+docker exec voidea-db-1 psql -U voidea -h localhost -p 5444 -d voidea -c "\dt"
+```
+
+---
+
+## 4. Что делать при проблемах с VoIdeaAI
+
+1. **Не работает voideaai.ru** — проверить nginx: `nginx -t`, проверить конфиг
+2. **VoIdea API не отвечает** — `docker compose -p voidea logs app`
+3. **VoIdea не может подключиться к БД** — проверить `localhost:5444`, логи `docker compose -p voidea logs db`
+4. **Gitea не открывается** — проверить порт 3000: `curl -s http://localhost:3000`
+
+Если проблема серьёзная — остановить VoIdea без ущерба для aegisone:
+```bash
+docker compose -p voidea down
+# aegisone продолжит работу независимо
+```
+
+---
+
+## 5. Контакты
+
+- По вопросам VoIdeaAI — обратиться к разработчику, ведущему проект VoIdea
+- Проекты независимы, команды разные
+- Изменения в nginx-proxy влияют на оба проекта — согласовывать
+
+---
+
+*Создан: 2026-05-19*
+*Не редактировать вручную без необходимости*