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

$WORKSPACE = исходники (source) — документация, код на языках
$DATASPACE = результат обработки — скомпилированное, форматированное, данные

export WORKSPACE=/opt/claude-workspace    # ИСХОДНИКИ (git)
export DATASPACE=/mnt/beget-s3            # РЕЗУЛЬТАТ ОБРАБОТКИ + ДАННЫЕ (S3)

┌─────────────────────────────────────────────────────┐
│ СЛУЖЕБНЫЕ                                           │
│                                                     │
│ Описывают место/сущность для обрабатывающей системы │
│ Читают: git, AI (Claude), файловая система          │
│                                                     │
│ Примеры: README.md  CLAUDE.md  AI.md  INDEX.md      │
│          .gitignore  .cache  .tmp  __pycache__/     │
├─────────────────────────────────────────────────────┤
│ СОДЕРЖАТЕЛЬНЫЕ                                      │
│                                                     │
│ Несут знание и смысл — для людей и агентов          │
│ Читают: люди, AI-агенты                             │
│                                                     │
│ Примеры: Концепция, Стандарт, Инструкция, Практика  │
│          STATUS.md  TODO.md  LICENSE  Шаблоны       │
├─────────────────────────────────────────────────────┤
│ ТЕХНИЧЕСКИЕ                                         │
│                                                     │
│ Являются реализацией — создаются и исполняются      │
│ Читают: инструменты (docker, python, node)          │
│                                                     │
│ Примеры: Код (.py .js .php), Конфигурация (.yml)    │
│          Данные (.csv .json), Тесты, Бинарные       │
└─────────────────────────────────────────────────────┘

arch/       ← ЧТО МЫ ЗНАЕМ?        стандарты, методология
project/    ← КАК МЫ УПРАВЛЯЕМ?    процессы, фазы, документы
domains/    ← ЧТО МЫ СТРОИМ?       IT / производство / бизнес / данные
infra/      ← ГДЕ ЭТО РАБОТАЕТ?    серверы, деплой, поддержка
system/     ← ЧЕМ МЫ РАБОТАЕМ?     общие библиотеки, коннекторы, MCP
services/   ← КТО ОБСЛУЖИВАЕТ?     планировщик, мониторинг

$WORKSPACE/
│
├── CLAUDE.md                    ← навигатор для Claude Code
├── README.md                    ← публичное описание
├── AI.md                        ← контекст для AI агентов
├── INDEX.md                     ← оглавление workspace
├── .gitignore
│
├── arch/                        ← СЛОЙ 1: ЗНАНИЯ
│   ├── architect.ai.md          ← агент архитектора
│   ├── AI.md
│   ├── CLAUDE.md
│   ├── theory/                  ← теория (LOCKED)
│   ├── concept/                 ← концепция платформы
│   ├── standards/               ← стандарты
│   ├── patterns/                ← паттерны
│   ├── decisions/               ← ADR
│   └── templates/               ← шаблоны документов
│
├── project/                     ← СЛОЙ 2: УПРАВЛЕНИЕ
│   ├── CLAUDE.md
│   ├── @projector.module/       ← модуль проектирования
│   ├── @manager.module/         ← модуль управления
│   ├── @tester.module/          ← модуль тестирования
│   ├── org/                     ← клиентские проекты
│   │   ├── it/
│   │   ├── production/          ⏸
│   │   ├── business/            ⏸
│   │   └── data/                ⏸
│   └── sys/                     ← системные проекты платформы
│
├── domains/                     ← СЛОЙ 3: ИСПОЛНЕНИЕ
│   ├── @it.domain/              ← домен IT ✅
│   │   ├── @drupal.coder/
│   │   ├── @react.coder/
│   │   └── @python.coder/
│   ├── @production.domain/      ⏸
│   ├── @business.domain/        ⏸
│   └── @data.domain/            ⏸
│
├── infra/                       ← СЛОЙ 4: ИНФРАСТРУКТУРА
│   ├── @executor.module/        ← модуль деплоя
│   ├── @support.module/         ← модуль поддержки
│   └── servers/                 ← конфиги серверов
│
├── system/                      ← СЛОЙ 5: ОБЩЕЕ
│   ├── library/                 ← общий код, утилиты
│   ├── data/                    ← общие данные
│   ├── @mcp.service/            ← MCP серверы для Claude
│   └── connectors/
│       ├── @ozon.connector/
│       └── @telegram.connector/
│
├── services/                    ← СЛОЙ 6: СЕРВИСЫ ОБСЛУЖИВАНИЯ
│   ├── @scheduler.service/      ← планировщик задач
│   └── @monitor.service/        ← мониторинг платформы
│
└── archive/                     ← архив устаревшего

@projector.module/     ← процессный модуль проектирования
@it.domain/            ← диспетчер IT домена
@drupal.coder/         ← стек Drupal
@ozon.connector/       ← коннектор Ozon
@scheduler.service/    ← сервис планировщика

arch/
  architect.ai.md          ← агент архитектора (уровень компонента)

project/@projector.module/
  projector.ai.md          ← агент проектора (уровень модуля)

domains/@it.domain/
  it.ai.md                 ← агент домена IT

domains/@it.domain/@drupal.coder/
  drupal.ai.md             ← агент стека Drupal

$WORKSPACE/
  CLAUDE.md    ← навигатор для Claude Code
  AI.md        ← контекст для AI агентов
  README.md    ← публичное описание для людей
  INDEX.md     ← оглавление всего workspace

$DATASPACE/
│
├── projects/                    ← Данные проектов (зеркало projects/ в $WORKSPACE)
│   ├── org/                     ← Клиентские проекты
│   └── sys/                     ← Системные данные
│
├── media/                       ← Вся графика, видео, аудио, документы
├── backup/                      ← Бэкапы БД, git, критических файлов
└── archive/                     ← Архив

QUESTIONS.fx.md   ← нельзя изменить без явного согласования
MERKABA.fx.md

✅ КОД
.py .js .ts .tsx .jsx .php .go .c .cpp .h .sh .bat .ps1

✅ ДОКУМЕНТАЦИЯ
.md .ai.md .txt .rst

✅ КОНФИГУРАЦИЯ
.yaml .yml .json .toml .ini .conf .xml .env.example

✅ WEB
.html .css .less .scss

✅ ШАБЛОНЫ
.twig .tpl .j2

✅ SQL
.sql

✅ СПЕЦИАЛЬНЫЕ
.gitignore .gitkeep .editorconfig Dockerfile Makefile LICENSE

✅ СПЕЦИАЛЬНЫЕ
.gitignore .gitkeep .editorconfig 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

❌ АРХИВЫ ДАННЫХ
.zip .tar .gz (если содержат данные, не код)

❌ CREDENTIALS
.env .key .pem (приватные)
.credentials.md

❌ ВРЕМЕННЫЕ
.pyc .log .tmp .cache

❌ ЗАВИСИМОСТИ
venv/ node_modules/ __pycache__/
.so .exe .pak

# Зависимости
venv/
node_modules/
__pycache__/

# Компиляция
*.pyc
*.pyo
*.so
*.exe

# Базы данных
*.db
*.sqlite
*.sqlite3

# Credentials
.env
*.key
*.pem
.credentials.md

# Временные
*.log
*.tmp
*.cache
.DS_Store
Thumbs.db

# Вся графика (файлы, не документы — всегда в $DATASPACE)
*.svg
*.ico
*.jpg
*.jpeg
*.png
*.gif
*.webp

# Данные
*.xlsx
*.xls
*.ods

# Медиа
*.mp4
*.avi
*.mov
*.mp3
*.wav

# Документы
*.pdf
*.docx
*.doc

# Архивы данных
*.zip
*.tar.gz

# IDE
.idea/
.vscode/
*.swp
*.swo

# Нет исключений для графики — вся графика в $DATASPACE

#!/bin/bash
# Блокировка изменений файлов *.fx.md

LOCKED=$(git diff --cached --name-only | grep "\.fx\.md$")

if [ -n "$LOCKED" ]; then
  echo "❌ ОШИБКА: Попытка изменить защищённый файл:"
  echo "$LOCKED"
  echo ""
  echo "Файлы *.fx.md заблокированы."
  echo "Требуется согласование с Архитектором."
  exit 1
fi

echo "✅ Защищённые файлы не затронуты"
exit 0

#!/bin/bash
# Блокировка запрещённых типов файлов в git

BLACKLIST=".svg .ico .jpg .jpeg .png .gif .webp .xlsx .xls .csv .pdf .docx .mp4 .mp3 .db .sqlite"

echo "Проверка запрещённых файлов..."

for ext in $BLACKLIST; do
  FILES=$(git diff --cached --name-only --diff-filter=A | grep "$ext$")

  if [ -n "$FILES" ]; then
    echo "❌ ОШИБКА: Попытка добавить $ext файл в git:"
    echo "$FILES"
    echo ""
    echo "Файлы $ext запрещены в git."
    echo "Используйте \$DATASPACE."
    exit 1
  fi
done

echo "✅ Проверка пройдена"
exit 0

chmod +x .git/hooks/pre-commit

# Найти все запрещённые файлы в git
git ls-files | grep -E '\.(svg|ico|jpg|jpeg|png|gif|webp|xlsx|xls|csv|pdf|mp4|mp3|db|sqlite)$'

# Если вывод не пустой → нарушение стандарта

# Найти всю графику в workspace (потенциальные нарушения)
find /opt/claude-workspace \( -name "*.svg" -o -name "*.ico" -o -name "*.jpg" -o -name "*.png" -o -name "*.gif" -o -name "*.webp" \) | grep -v ".git"

# Найти venv в git (должно быть пусто)
git ls-files | grep -E '(venv|node_modules|__pycache__)/'