docs: инфраструктура VM Сервисы + архитектура pulse-api и pulse-web

Инфраструктура/Сервисы/pulse-api-homelab-api.md

@@ -0,0 +1,49 @@
+# Pulse API (homelab-api)
+
+## Назначение
+Backend API для приложения Pulse — трекер привычек, задач, финансов, накоплений. Go REST API + Telegram бот.
+
+## Контейнеры
+
+| Имя | Образ |
+|-----|-------|
+| homelab-api | local build (Go) |
+| homelab-db | postgres:16-alpine |
+| pulse-api-dev | local build (dev instance, порт 8081) |
+
+## Порты
+
+| Контейнер | Внешний | Внутренний | Назначение |
+|-----------|---------|-----------|------------|
+| homelab-api | — | 8080 | REST API (через NPM → api.digital-home.site) |
+| pulse-api-dev | 8081 | 8080 | Dev-инстанс API |
+| homelab-db | — | 5432 | PostgreSQL |
+
+## Volumes
+
+| Volume | Путь контейнера | Содержимое |
+|--------|----------------|------------|
+| postgres_data | /var/lib/postgresql/data | БД |
+
+## Домен
+`https://api.digital-home.site`
+
+## Сети
+- `services_proxy` (external)
+- `internal` (между api и db)
+
+## Env переменные
+- `DATABASE_URL`
+- `JWT_SECRET`
+- `PORT`
+- `RESEND_API_KEY`
+- `FROM_EMAIL`
+- `FROM_NAME`
+- `APP_URL`
+- `TELEGRAM_BOT_TOKEN`
+
+## Статус
+✅ **Запущен** (homelab-api: Up 19 hours, homelab-db: Up 4 weeks, pulse-api-dev: Up 4 weeks)
+
+## Подробная документация
+→ [[pulse-api]]