architect/standards/arch-services-structure.md

type: standard
layer: arch
object: services
aspect: structure
form: text
title: "Структура services/"
status: active
version: 1.0.0
date: 2026-04-15
knowledge_level: У1
parent: arch-platform-structure.md

Структура services/

Компонент ЧТО ЗАПУЩЕНО — production docker-сервисы проектов клиентов.

1. ВОПРОС КОМПОНЕНТА

Какие бизнес-сервисы сейчас запущены в production?

services/ — единое место для production docker-сервисов всех клиентских проектов. Не код проекта (он в projects/), не платформенные сервисы (они в system/) — только то, что прямо сейчас работает для клиентов.

2. СТРУКТУРА

services/
└── @{имя}.service/     один сервис = один проект
    ├── docker-compose.yml
    ├── .env.example
    ├── config/
    └── CLAUDE.md        (опционально)

Каждый модуль — @{имя}.service/. Имя совпадает с именем проекта в projects/org/.

3. ТЕКУЩИЕ СЕРВИСЫ

Модуль Проект Статус
@pirotehnika.service/ projects/org/pirotehnika/ production
@idealshop.service/ projects/org/idealshop/ production
@babyrisk.service/ projects/org/babyrisk/ production
@telegram-vip.service/ — production
@pro1-admin.service/ — production
@nocodb-products.service/ — production

4. ПРАВИЛА ИМЕНОВАНИЯ

Формат модуля: @{имя}.service/

projects/org/pirotehnika/    ←→   services/@pirotehnika.service/
projects/org/idealshop/      ←→   services/@idealshop.service/

5. СОДЕРЖИМОЕ МОДУЛЯ

@{имя}.service/
├── docker-compose.yml     — манифест сервиса
├── .env.example           — шаблон переменных (без секретов!)
├── config/                — конфиги приложения
│   ├── nginx.conf         — если есть nginx
│   └── app.conf
└── CLAUDE.md              — только если есть нюансы

Правило .env: файл .env с реальными значениями живёт в $DATASPACE, не в git. В git только .env.example с заглушками.

6. СВЯЗЬ С ДРУГИМИ КОМПОНЕНТАМИ

projects/org/{проект}/    ← код и данные проекта
services/@{проект}.service/ ← docker-конфиг для запуска
infra/@{сервер}.server/   ← сервер, где это запущено

Деплой: код из projects/ → docker-образ → запуск через services/.

7. РАЗНИЦА services/ VS system/

services/ system/
Для кого клиенты / бизнес платформа
Управляет Проектор Архитектор / Оператор
Примеры @pirotehnika.service @rebuild.service
Финансирование клиент платформа

СВЯЗАННЫЕ ДОКУМЕНТЫ