# Внимание: на сервере работает второй проект — 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*
*Не редактировать вручную без необходимости*