# 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]]