# service-architecture

Правило service-architecture описывает архитектуру Docker-сервисов Polar: общую инфраструктуру и отдельный стек приложения для каждого worktree. Помогает агенту учитывать связи между контейнерами и их адреса.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 1216 у репозитория
- Автор: fcakyon
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/fcakyon/claude-codex-settings/tree/HEAD/plugins/polar-skills/skills/polar-local-environment/rules/service-architecture.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/service-architecture

## Что делает

Инфраструктура работает в проекте `polar-shared`: PostgreSQL доступен как `db:5432`, Redis как `redis:6379`, MinIO как `minio:9000`, а аналитика — через `tinybird:7181`. Для каждого экземпляра приложения предусмотрены своя логическая база `polar_dev_<N>`, индекс Redis и бакеты MinIO. У общей инфраструктуры нет опубликованных портов хоста: обращаться к ней нужно через `dev docker exec <service> ...`.

Стек `polar-app-<N>` включает FastAPI API, worker с Dramatiq и Next.js frontend. API запускает миграции и загружает начальные данные при первом старте; web ждёт, пока API станет healthy. Контейнеры приложения подключаются к отдельной сети экземпляра и к `polar-shared`, но web остаётся вне общей сети, чтобы `api:8000` указывал на API своего экземпляра. Monitoring с Prometheus и Grafana включается через `--monitoring`. Поскольку порты общей инфраструктуры не опубликованы, подключение к ней с хоста через обычный порт не сработает.

## Требования
- Работает с: Docker

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add fcakyon/claude-codex-settings
```
В чате агента (не в терминале):
```text
/plugin install polar-skills@claude-settings
```

2. **Вручную: положить файлы**
- Файл: `.claude/rules/service-architecture.md` — Поле paths во frontmatter ограничивает файлы

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/service-architecture.mdc` — Во frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/service-architecture.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/service-architecture.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/service-architecture.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/fcakyon/claude-codex-settings/tree/HEAD/plugins/polar-skills/skills/polar-local-environment/rules/service-architecture.md

## Когда брать
- разделить общую инфраструктуру и стеки приложений по worktree
- найти адрес PostgreSQL, Redis или MinIO внутри сети Docker
- понять, какие сервисы должны запуститься до API и frontend
- проверить, где доступны порты приложения и мониторинга

## Примеры запросов агенту
- Объясни, как устроены Docker-сети и сервисы в `polar-app-<N>`.
- Проверь, куда подключаться к PostgreSQL и Redis из контейнера приложения.
- Почему frontend ждёт API и как включить Prometheus с Grafana?

## Похожие
- [infisical-self-host](https://affpapa.org/nevibecode/skills/infisical-self-host.md) — скилл · 834 установки
- [docker-compose-production](https://affpapa.org/nevibecode/skills/docker-compose-production.md) — скилл · 487 установок
- [GitLab Stack Config Generator](https://affpapa.org/nevibecode/skills/gitlab-stack-config-generator.md) — скилл · 303 установки
- [object-storage](https://affpapa.org/nevibecode/skills/object-storage.md) — скилл · 387 установок
- [valkey](https://affpapa.org/nevibecode/skills/valkey.md) — скилл · 142 установки
- [infra-audit](https://affpapa.org/nevibecode/skills/infra-audit.md) — скилл · ★ 937 у репозитория

Из того же набора: [fcakyon/claude-codex-settings](https://affpapa.org/nevibecode/by/fcakyon/claude-codex-settings.md) — 113 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
