type: standard
aspect: naming
title: "Миграция под стандарт naming-workspace v2.0.0"
version: 1.0.0
date: 2026-03-30
status: active

Миграция платформы под naming-workspace v2.0.0

Что нужно исправить в воркспейсе, чтобы соответствовать новому стандарту.

1 — infra/ — переименование компонентов

Требует переименования

Текущее	Новое	Причина
`infra/@admin.portal`	`infra/@admin.ui`	`.portal` не в стандарте → `.ui` (только интерфейс)
`infra/@home-pc.server`	`infra/@home-pc.pc`	Это компьютер оператора, не сервер → `.pc`
`infra/@backup.service`	`infra/@backup.storage`	Хранит бэкапы → `.storage`, а не `.service`

Уже соответствует

Компонент	Тип	Статус
`@beget-panel.web`	`.web` — сайт	✅
`@kt-scraper.pc`	`.pc` — компьютер	✅
`@beget-s3.storage`	`.storage`	✅
`@nocodb.app`	`.app` — приложение	✅
`@wikijs.app`	`.app`	✅
`@openrouter.connector`	`.connector`	✅
`@kt-station.infra`	`.infra`	✅
`@md-viewer.service`	`.service`	✅
`@*.server`	`.server`	✅

Требует обсуждения

Компонент	Вопрос
`infra/@proxy.service`	Выполняет роль gateway (nginx+reverse proxy) → рассмотреть `.gateway`?
`infra/@manage.service`	Что делает? Если управляющий интерфейс → `.ui` или `.app`

2 — library/ — миграция на @name.type

Сейчас library/ использует plain папки без @. По стандарту — переход на @name.type.

План переименования

Текущее	Новое	Тип
`library/connectors/`	`library/@connectors.lib`	`.lib` — библиотека коннекторов
`library/adapters/`	`library/@adapters.lib`	`.lib`
`library/parsers/`	`library/@parsers.lib`	`.lib`
`library/services/`	`library/@services.lib`	`.lib`
`library/integrations/`	`library/@integrations.lib`	`.lib`
`library/functions/`	`library/@functions.lib`	`.lib`
`library/primitives/`	`library/@primitives.lib`	`.lib`
`library/core/`	`library/@core.lib`	`.lib`
`library/models/`	`library/@models.lib`	`.lib`
`library/storages/`	`library/@storages.lib`	`.lib`
`library/utils/`	`library/@utils.lib`	`.lib`
`library/components/`	`library/@components.lib`	`.lib`
`library/applications/`	`library/@applications.lib`	`.lib`
`library/artifacts/`	`library/@artifacts.lib`	`.lib`
`library/configurations/`	`library/@configurations.lib`	`.lib`
`library/extensions/`	`library/@extensions.lib`	`.lib`

Приоритет: Низкий — это внутренняя структура кода. Переименование затронет Python imports (from library.connectors.api...). Выполнять поэтапно с рефакторингом импортов.

Вариант-минимум: Переименовать только верхний уровень в library/ (16 папок), без внутренней структуры API-субдиректорий. Импорты придётся обновить.

3 — Документы со старым именем стандарта

INDEX.md и CLAUDE.md — обновить ссылки

Файлы, которые ссылаются на naming-files.md (устаревший):

Файл	Что изменить
`architect/CLAUDE.md`	Ссылка `naming-files.md` → `naming-workspace.md`
`architect/INDEX.md`	Строка в таблице naming/ → `naming-workspace.md`, убрать `naming-files.md`
`architect/standards/naming/README.md`	Обновить список, добавить `naming-workspace.md` как основной

4 — Файлы нарушающие формулу (UPPERCASE не-служебные)

Документы с именами в UPPERCASE, которые не являются служебными файлами:

Файл	Проблема	Вариант исправления
`architect/standards/_draft/PLATFORM_COMPONENTS.md`	UPPERCASE, но не служебный	→ `structure-platform-components.md` или удалить если покрыто другими
`architect/management/GAPS.md`	Проектный файл	✅ допустимо (проектный раздел)
`architect/management/ROADMAP.md`	Проектный файл	✅ допустимо
`architect/management/KNOWN_ISSUES.md`	Проектный файл	✅ допустимо

5 — Черновики без суффикса .draft

Файлы, которые по сути черновики, но не имеют .draft суффикса:

Файл	Действие
`architect/concept/PLATFORM_V2.md`	Если активен → оставить; если черновик → `platform-v2.draft.md`
`architect/projects/*/PROJECT.md` (незавершённые)	Добавить `.draft` если не финализированы

6 — Проектный файл naming-standard — закрыть

Файл	Действие
`architect/projects/naming-standard/PROJECT.md`	Обновить статус → Phase 10 (завершено), дата закрытия 2026-03-30
`architect/projects/CLAUDE.md`	Убрать `naming-standard` из активных проектов

7 — Новые типы из стандарта — проверить применение

Новые типы, которых раньше не было. Убедиться что компоненты получают правильный тип:

Тип	Когда применять	Пример в воркспейсе
`.gateway`	nginx + VPN + DNS в одном	`@papa.gateway` (Platform 2.0)
`.ui`	только веб-интерфейс	`@admin.ui` (вместо @admin.portal)
`.system`	сложный комплекс сервисов	`@bot-platform.system` если есть
`.adapter`	адаптер формата	`@ozon.adapter` если отдельный компонент
`.integration`	бизнес-интеграция	`@ozon-1c.integration`
`.monitor`	мониторинг + алерты	`@prometheus.monitor`

ПРИОРИТЕТЫ

Приоритет	Действие	Сложность
🔴 Сейчас	Обновить ссылки в INDEX.md, CLAUDE.md	Малая
🔴 Сейчас	Переименовать `@admin.portal` → `@admin.ui`	Малая
🔴 Сейчас	Переименовать `@home-pc.server` → `@home-pc.pc`	Малая
🔴 Сейчас	Закрыть проект naming-standard	Малая
🟡 Скоро	Переименовать `@backup.service` → `@backup.storage`	Средняя (systemd)
🟡 Скоро	README.md в naming/ обновить	Малая
🟢 Потом	Миграция library/ на @name.type	Большая (Python imports)
🟢 Потом	Аудит UPPERCASE не-служебных файлов	Средняя

Версия: 1.0.0
Дата: 2026-03-30
Базируется на: naming-workspace.md v2.0.0