type: concept
aspect: management
title: "DMS — Система управления документами платформы"
version: 0.1.0
date: 2026-03-30
status: draft

DMS — Система управления документами платформы

ЧЕРНОВИК — не применять до финализации

СУТЬ

DMS (Document Management System) — свод правил, определяющий:
- что является документом платформы
- как документ называется, форматируется, хранится
- как документ живёт: от идеи до архива
- как документы связаны между собой и остаются актуальными

DMS не создаёт новых инструментов — он описывает правила работы с существующими файлами в git-репозитории.

ОБЛАСТЬ ПРИМЕНЕНИЯ

DMS управляет документами платформы:

architect/     ← методология, стандарты, концепция
system/        ← агенты, планировщик, монитор
infra/         ← инфраструктура
projects/      ← бизнес-проекты (частично — CLAUDE.md, INDEX.md)

DMS не управляет:
- Кодом (*.py, *.go, *.ts) — управляется git
- Данными (*.csv, *.xlsx, images) — управляется dataspace
- Секретами (.env, credentials) — управляется отдельной политикой

ТИПЫ ДОКУМЕНТОВ

Классификация по назначению

→ Полный список: typology-document-types.md

Классификация по статусу

ЖИЗНЕННЫЙ ЦИКЛ ДОКУМЕНТА

.idea.md → .draft.md → [REVIEW] → [PLAN] → [MIGRATION] → .md → arh/

Детальный процесс: process-platform-change.md

Принципы

1. Нет прямого редактирования активных стандартов — только через .draft
2. Любая идея фиксируется как .idea.md до оформления
3. Черновик поглощает идею — .idea.md удаляется при создании .draft.md
4. Архив обязателен — старая версия не удаляется, а перемещается в arh/

ИМЕНОВАНИЕ

→ naming-workspace.md — единый стандарт

Ключевые правила:
- Файлы: [aspect]-[object]-[detail].[role].format
- Только латиница, дефисы — запрещены пробелы и подчёркивания
- Сервисные: UPPERCASE.md (человек читает) / lowercase.yaml (машина читает)

ФОРМАТИРОВАНИЕ

→ format-document.md — стандарт документа

Обязательно для всех документов платформы:
- YAML frontmatter: type, title, version, date, status
- Версионирование: major.minor.patch
- Язык: платформа = только латиница; проекты = латиница или русский

ХРАНЕНИЕ И СТРУКТУРА

Где живут документы

architect/
├── concept/       ← концептуальные документы (14+)
├── standards/
│   ├── naming/    ← правила именования
│   ├── structure/ ← правила структуры
│   ├── format/    ← правила формата
│   ├── process/   ← процессы
│   ├── policy/    ← политики
│   ├── typology/  ← типологии
│   ├── lifecycle/ ← жизненный цикл
│   ├── operation/ ← операции
│   └── guidance/  ← руководства
├── management/
│   └── dms/       ← этот документ
└── arh/           ← архив

Принципы размещения

• Один аспект — одна папка: структурные правила → standards/structure/
• Черновик рядом с активным: standards/process/process-X.draft.md → standards/process/process-X.md
• Архив централизован: arh/ — для всего устаревшего

РЕЕСТРЫ И НАВИГАЦИЯ

Три уровня реестров

Правила реестров

1. INDEX.md обновляется при добавлении/удалении документа — это часть плана миграции
2. README.md — для людей, краткое (5-15 строк)
3. CLAUDE.md — для AI, включает навигацию и правила работы

→ Подробнее: naming-workspace.md §Сервисные файлы

ВЕРСИОНИРОВАНИЕ

Схема версий

major.minor.patch

major — несовместимые изменения (смена концепции)
minor — новые правила, расширение
patch — уточнения, исправления ошибок

Правила

• Каждый документ имеет версию в frontmatter
• История изменений — секция ## ИСТОРИЯ или ## CHANGELOG в конце документа
• При архивировании старая версия сохраняется в arh/name-YYYY-MM-DD.md

АКТУАЛИЗАЦИЯ

Проблема устаревания

Документы устаревают. Без системы актуализации реестр превращается в кладбище.

Правила актуализации

1. Обнаружение конфликта — при работе с документом, заметил противоречие → создаём .draft
2. Периодический аудит — раз в квартал проверка актуальности стандартов
3. Связи — при изменении документа А проверить, что документы Б и В ссылающиеся на него не устарели
4. Индикатор актуальности — в frontmatter поле date показывает последнее обновление

Признаки устаревшего документа

• date старше 6 месяцев и нет поля status: active
• Ссылается на удалённые файлы или несуществующие пути
• Противоречит более новому стандарту
• Содержит TODO, TBD, незакрытые вопросы

ПОИСК И ОБНАРУЖЕНИЕ

Как найти нужный документ

1. По теме → architect/INDEX.md — полный индекс
2. По аспекту → standards/{aspect}/README.md
3. По типу → frontmatter type: ...
4. По статусу → find . -name "*.draft.md" для черновиков

Черновики в системе

# Найти все активные черновики
find architect/ -name "*.draft.md"

# Найти все идеи
find architect/ -name "*.idea.md"

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

Типы связей

Принцип: не дублировать

Если правило уже есть в документе А — документ Б ссылается на А, не копирует.
Дублирование = источник рассинхронизации.

ПОЛИТИКА DMS

1. Всё в git — никаких "живых" документов вне репозитория
2. Черновик обязателен — нет прямого изменения активных документов
3. Реестр как часть изменения — не обновил INDEX.md = изменение не завершено
4. Одна истина — если правило есть в двух местах, одно из них лишнее
5. Ссылки, не копии — предпочитать ссылку дублированию
6. Архив, не удаление — устаревшее → arh/, не rm

ОТКРЫТЫЕ ВОПРОСЫ

• [ ] Нужен ли автоматический реестр черновиков? (скрипт, CI проверка?)
• [ ] Как версионировать документы при переименовании — хранить replaces: в frontmatter?
• [ ] Какой период считать "устаревшим" — 3 месяца? 6 месяцев? зависит от типа?
• [ ] Шаблоны для каждого типа документа — создать в architect/templates/?
• [ ] Связь с .queue/ — задача на изменение документа = .task.yaml в очереди?
• [ ] Как управлять документами проектов (не платформы) — отдельный подраздел?

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

Версия: 0.1.0 (черновик)
Дата: 2026-03-30