Платформа — Документная Система

ЧТО?     → содержание — о чём документ
ЧЕМ?     → формат    — в каком виде записан (.md, .yaml, .csv)
КАК?     → структура — как организован внутри
ГДЕ?     → путь      — где физически находится
СКОЛЬКО? → объём     — размер, количество разделов

ЗАЧЕМ?  → назначение — для чего создан
КТО?    → аудитория  — кто читает
КОГДА?  → версия     — когда создан / изменён

$WORKSPACE = исходники (source)
$DATASPACE = результат обработки (output / binary / data)

✅ Код:          .py .js .ts .tsx .jsx .php .go .sh
✅ Документация: .md .ai.md .fx.md .txt .rst
✅ Конфигурация: .yaml .json .toml .ini .xml
✅ Web-код:      .html .css .scss .less
✅ Шаблоны:      .twig .tpl .j2
✅ SQL:          .sql
✅ Специальные:  .gitignore .gitkeep Dockerfile Makefile LICENSE

❌ Графика:    .svg .ico .jpg .jpeg .png .gif .webp
❌ Шрифты:     .woff2 .ttf .otf .eot
❌ Медиа:      .mp4 .avi .mov .mp3 .wav
❌ Документы:  .pdf .docx .doc .rtf
❌ Данные:     .xlsx .xls .ods .csv
❌ Базы:       .db .sqlite

У0  ТЕОРИЯ        Универсальные законы. Не зависят от платформы.
                  Меняется: НИКОГДА (LOCKED)

У0  КОНЦЕПЦИЯ     Как МЫ видим нашу платформу.
                  Меняется: редко, только большие решения

У1  СТАНДАРТЫ     Наши правила — как делать конкретные вещи.
                  Меняется: при эволюции платформы

У2  ПАТТЕРНЫ      Рецепты — типовые решения типовых задач.
                  Меняется: по мере накопления опыта

У3  ШАБЛОНЫ       Заготовки — готовые формы для заполнения.
                  Меняется: постоянно растёт

У4  РЕАЛИЗАЦИЯ    Конкретный код / конфиг / данные.
                  Меняется: часто

У0 ТЕОРИЯ → У0 КОНЦЕПЦИЯ → У1 СТАНДАРТЫ → У2 ПАТТЕРНЫ → У3 ШАБЛОНЫ → У4 РЕАЛИЗАЦИЯ

ПЛАТФОРМА
  ├── АРХ          arch/             — методология, стандарты, теория
  ├── ПРО          project/          — проекты
  │     └── ПРОЕКТ     project/org/{name}/
  │           └── КОМПОНЕНТ    @name.type/
  │                 └── ПОДКОМПОНЕНТ
  ├── DOMAINS ⏸    domains/          — стеки и специализации
  ├── SYS ⏸        system/           — общее
  ├── SERVICES ⏸   services/         — сервисы
  └── ИНФРА ⏸      infra/            — серверы, деплой

                  АРХ   ПРО   ПРОЕКТ   КОМПОНЕНТ
У0 ТЕОРИЯ          ✅    —      —          —
У0 КОНЦЕПЦИЯ       ✅    —      —          —
У1 СТАНДАРТ        ✅    —      —          —
У2 ПАТТЕРН         ✅    ✅     —          —
У3 ШАБЛОН          ✅    ✅     ✅         —
У4 РЕАЛИЗАЦИЯ      —     —     ✅         ✅

У4 РЕАЛИЗАЦИЯ → ВОПЛОЩЕНИЕ → АРТЕФАКТ
                               (работающий сервис / данные / продукт)

УРОВЕНЬ        АВТОР              ДОСТУП
────────────────────────────────────────────────────
У0 ТЕОРИЯ      Архитектор         Архитектор
У0 КОНЦЕПЦИЯ   Архитектор         Архитектор, Проектор
У1 СТАНДАРТ    Архитектор         Все роли
У2 ПАТТЕРН     Арх + Кодер        Проектор, Кодер
У3 ШАБЛОН      Кодер              Проектор, Кодер, Инфра
У4 РЕАЛИЗАЦИЯ  Кодер + Инфра      Кодер, Инфра, AI

---
type: standard|concept|decision|pattern|template|analysis|research|practice|plan|instruction|ticket
title: "Название документа"
status: draft|development|testing|active|archived|deprecated
date: YYYY-MM-DD
---

version: X.Y.Z      # для версионируемых документов (стандарты, концепции)
owner: architect     # для документов с явным владельцем

id: ADR-001                  # для decisions / tickets
priority: HIGH               # для tickets
knowledge_level: У1          # У0|У1|У2|У3|У4
fractal_level: arch          # arch|pro|project|component|subcomponent
parent: path/to.md           # ссылка вверх по каскаду
derived_from: path/to.md     # деривация: от какого документа
part_of: path/to.md          # декомпозиция: частью чего является
spawns: [a.md, b.md]         # что породил
phase: 3                     # фаза Проектора (0–15), только для проектных документов
tags: [api, security]
audience: [architect, coder]

standards/format/
  ├── format-file-types.md        ← родитель
  └── format-file-types-web.md   ← дочерний

standards/
  ├── naming.md                   ← было
  └── naming/                     ← стало (декомпозиция)
        ├── naming.md             ← родитель (теперь индекс)
        ├── naming-files.md
        └── naming-folders.md

project/org/
  └── pirotehnika/
        ├── CLAUDE.md             ← обязательно
        └── ...

# .git/hooks/pre-commit
LOCKED=$(git diff --cached --name-only | grep "\.fx\.md$")
if [ -n "$LOCKED" ]; then
  echo "❌ Защищённый файл: $LOCKED"
  echo "Требуется согласование с Архитектором."
  exit 1
fi

DRAFT → DEV → TEST → PROD → ARCHIVE

ДРОБИТЬ   — если части используются раздельно
ДЕРЖАТЬ   — если используются вместе
МАКСИМУМ  — 5000 строк (~100 страниц)

MAJOR.MINOR.PATCH

PATCH  — опечатки, форматирование       1.0.0 → 1.0.1
MINOR  — новая секция, уточнения        1.0.1 → 1.1.0
MAJOR  — изменение структуры, breaking  1.1.0 → 2.0.0