type: standard
aspect: naming
title: "Единый стандарт именования платформы"
version: 2.0.0
date: 2026-03-30
status: active
replaces: naming-files.md v1.0.0

Единый стандарт именования платформы

ЧАСТЬ 1 — ФАЙЛЫ И ДОКУМЕНТЫ

Формула

[aspect]-[object]-[detail].[role].format

Часть	Обязательность	Описание
`aspect`	✅	Тема/раздел (9 фиксированных)
`object`	✅	Объект описания
`detail`	опционально	Уточнение
`role`	опционально	Роль файла (см. ниже)
`format`	✅	Расширение

9 аспектов (фиксированные)

Aspect	Вопрос	Пример
`typology`	ЧТО это?	`typology-project-types.md`
`structure`	КАК УСТРОЕНО?	`structure-workspace.md`
`format`	КАК ВЫГЛЯДИТ?	`format-document.md`
`naming`	КАК НАЗЫВАТЬ?	`naming-standard.md`
`lifecycle`	КАК ЖИВЁТ?	`lifecycle-project-states.md`
`policy`	ЧТО МОЖНО?	`policy-security.md`
`process`	КАК ДЕЛАТЬ?	`process-deployment.md`
`operation`	КАКИЕ ДЕЙСТВИЯ?	`operation-cleanup.md`
`guidance`	КАК ПРИМЕНЯТЬ?	`guidance-project-development-ai.md`

Роли файлов

Суффикс перед форматом — показывает назначение файла:

Role	Назначение	Пример
(нет)	Основной документ	`PROJECT.md`
`.tpl`	Шаблон	`PROJECT.tpl.md`
`.spec`	Спецификация, ТЗ	`feature.spec.md`
`.data`	Данные (machine-readable)	`catalog.data.csv`
`.cache`	Автогенерируемый файл	`state.cache.yaml`
`.task`	Задача	`import.task.yaml`

Суффиксы статуса (незавершённые)

NAME.draft.md    ← черновик в работе, структура есть
NAME.idea.md     ← сырая идея, не оформлена

find . -name "*.draft.md"   # все черновики
find . -name "*.idea.md"    # все идеи

Форматы

Format	Когда использовать
`.md`	Человек читает: документы, стандарты
`.yaml`	Машина парсит: конфигурации, метаданные
`.json`	API, обмен данными
`.csv`	Таблицы, каталоги, реестры
`.db`	SQLite — локальные БД с запросами

Регистр и разделители

Всё lowercase, только дефисы
Никаких подчёркиваний, точек, camelCase

✅ typology-project-types.md
❌ Typology_Project_Types.MD
❌ typologyProjectTypes.md

ЧАСТЬ 2 — СЛУЖЕБНЫЕ ФАЙЛЫ (UPPERCASE)

Служебные файлы не используют формулу. Всегда UPPERCASE, имя фиксированное.

Универсальные (в любой папке)

Файл	Назначение
`README.md`	Индекс папки, навигация
`CLAUDE.md`	Контекст для AI (короткий, только суть)
`AI.md`	Полные инструкции для AI-агента
`INDEX.md`	Полный индекс раздела
`CHANGELOG.md`	История изменений

Проектные (в папке проекта)

Файл	Назначение
`PROJECT.md`	Описание проекта (9 вопросов)
`STATUS.md`	Текущее состояние
`ROADMAP.md`	Планы и фазы
`TODO.md`	Список задач
`ARCHITECTURE.md`	Архитектура решения

Конфиденциальные (с точкой, в .gitignore)

Файл	Назначение
`.credentials.md`	Учётные данные
`SECRETS.md`	Секреты и ключи
`.env`	Переменные окружения
`.env.example`	Шаблон переменных (в git)

ЧАСТЬ 3 — ПАПКИ

Обычные папки

lowercase + дефисы:
  projects/lideravto-new/
  architect/standards/

Модули платформы (`@` prefix)

@name.type/
  infra/@md-viewer.service/
  infra/@postgres.db/
  library/@telegram.connector/
  system/@projector.agent/

Служебные папки (`_` prefix)

_draft/     черновики и незавершённые
_archive/   архив устаревшего
_tmp/       временные файлы

ЧАСТЬ 4 — КОМПОНЕНТЫ ПЛАТФОРМЫ

Иерархия

INSTANCE → COMPONENT → SERVICE

Уровень	Термин	Формат	Пример
Физический сервер / VM	Instance	`name` (строчные, дефис)	`node-eu`, `node-rf`
Логическая единица	Component	`@name.type`	`@papa.gateway`
Процесс внутри	Service	`service-name`	`wireguard`, `nginx`

Формат компонента

@name.type

@ — маркер компонента платформы
name — что делает: papa, projector, doctor
.type — класс из таблицы ниже

Типы компонентов

Текущие (используются сейчас)

Type	Назначение	Пример
`.service`	Платформенный сервис	`@scheduler.service`, `@md-viewer.service`
`.server`	Физический/виртуальный сервер	`@dev-pro.server`, `@beget-work.server`
`.agent`	AI-агент (Claude)	`@projector.agent`, `@doctor.agent`
`.app`	Веб-приложение	`@nocodb.app`, `@wikijs.app`
`.storage`	Файлы, бэкапы, S3	`@beget-s3.storage`, `@backup.storage`
`.connector`	Внешний API/сервис	`@openrouter.connector`, `@telegram.connector`
`.infra`	Инфраструктурный комплекс	`@kt-station.infra`

Новые (Platform 2.0)

Type	Назначение	Пример
`.gateway`	Сеть: VPN/DNS/proxy/nginx	`@papa.gateway`
`.tool`	Утилита, CLI	`@doctor.tool`
`.db`	База данных	`@postgres.db`
`.cache`	Кэш, очереди	`@redis.cache`
`.model`	LLM	`@ollama.model`
`.registry`	Git, пакеты, образы	`@gitea.registry`
`.monitor`	Наблюдение, алерты	`@prometheus.monitor`
`.data`	MDM, каталоги	`@catalog.data`
`.knowledge`	Wiki, RAG	`@wiki.knowledge`

Карта инстансов Platform 2.0

Instance: mama                 ← закрыт, источник истины
└── @mama.registry
    └── git-server, ssh

Instance: papa                 ← единственный публичный вход
└── @papa.gateway
    └── wireguard, coredns, nginx, gitea

Instance: projector            ← управление проектами
├── @projector.agent
└── @scheduler.service

Instance: worker               ← production окружение
├── @app.service
├── @postgres.db
└── @redis.cache

Instance: llm                  ← языковые модели
└── @ollama.model

Instance: backup               ← резервное хранилище
└── @backup.storage

Instance: data                 ← MDM / каталоги
└── @catalog.data

Instance: knowledge            ← база знаний / wiki
└── @wiki.knowledge

CHANGELOG

2026-03-30 — v2.0.0

Объединены naming-files.md (v1.0.0) и новый стандарт Platform 2.0
Добавлены роли файлов: .tpl, .spec, .data, .cache, .task
Добавлены суффиксы статуса: .draft, .idea
Добавлена Часть 3: именование папок (@, _)
Добавлена Часть 4: компоненты платформы (INSTANCE → COMPONENT → SERVICE)
Добавлен AI.md в служебные файлы
Расширен список типов .type по фактической практике
Instance gateway переименован в papa

2026-02-19 — v1.0.0

Базовая формула aspect-object-detail.md
9 аспектов, lowercase, дефисы

Версия: 2.0.0
Статус: active
Владелец: architect
Заменяет: naming-files.md v1.0.0