Стандарт типов файлов и размещения

export WORKSPACE=/opt/claude-workspace    # КОД (git)
export DATASPACE=/mnt/beget-s3            # ДАННЫЕ (S3)
export MEDIASPACE=$DATASPACE/media        # МЕДИА (S3)

$MEDIASPACE/
├── images/              ← изображения
│   ├── products/        ← товары
│   ├── categories/      ← категории
│   ├── logos/           ← логотипы
│   └── temp/            ← временные (auto-cleanup 30d)
├── video/               ← видео
├── audio/               ← аудио
└── documents/           ← PDF, DOCX

.jpg → ТОЛЬКО $MEDIASPACE (NO EXCEPTIONS)
.png → $WORKSPACE если < 50KB, иначе $MEDIASPACE
.svg → ТОЛЬКО $WORKSPACE (векторная графика)

✅ КОД
.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 .svg .woff2 .ttf

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

✅ SQL
.sql

✅ МЕЛКАЯ ГРАФИКА
.svg (любой размер)
.png (< 50KB)
.ico (< 20KB)

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

❌ ИЗОБРАЖЕНИЯ (массовые)
.jpg .jpeg .gif .webp
.png (> 50KB)

❌ МЕДИА
.mp4 .avi .mov .mp3 .wav

❌ ДОКУМЕНТЫ
.pdf .docx .doc .rtf

❌ ДАННЫЕ
.xlsx .xls .ods
.csv (> 100KB)

❌ БАЗЫ ДАННЫХ
.db .sqlite

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

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

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

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

✅ .svg (векторная графика, любой размер)
✅ .png < 50KB (иконки, favicon)
✅ .ico < 20KB (favicon)

❌ .jpg (любой размер) → MEDIASPACE
❌ .png > 50KB → MEDIASPACE
❌ .gif → MEDIASPACE
❌ .webp → MEDIASPACE

✅ .jpg, .jpeg
✅ .png > 50KB
✅ .gif
✅ .webp

$MEDIASPACE/                    = /mnt/beget-s3/media/
├── images/
│   ├── products/               ← изображения товаров
│   │   ├── 001234.jpg
│   │   └── 001235.jpg
│   ├── categories/             ← изображения категорий
│   ├── logos/                  ← логотипы
│   ├── banners/                ← баннеры
│   └── temp/                   ← временные (auto-cleanup)
│
├── video/                      ← видео
│   ├── products/
│   └── demo/
│
├── audio/                      ← аудио
│
└── documents/                  ← PDF, DOCX
    ├── certificates/
    ├── manuals/
    └── contracts/

https://files.0kt.ru/images/products/001234.jpg
→ nginx proxy
→ /mnt/beget-s3/media/images/products/001234.jpg

README.md
CLAUDE.md
PROJECT.md
LICENSE

{name}.ai.md
architect.ai.md
pim.ai.md

.credentials.md
.env

schedule.yaml
config.json
settings.toml

backup.sh
sessions.py
__init__.py
client.py

addon.xml
init.php
func.php

# ❌ В git
cp product.jpg /opt/claude-workspace/projects/pirotehnika/images/
git add images/product.jpg

# ✅ В MEDIASPACE
cp product.jpg $MEDIASPACE/images/products/12345.jpg
# Доступ: https://files.0kt.ru/images/products/12345.jpg

# ❌ В git
cp price.xlsx /opt/claude-workspace/projects/pirotehnika/data/

# ✅ В DATASPACE
cp price.xlsx $DATASPACE/projects/pirotehnika/inbox/price_2026-02-19.xlsx

# ✅ В git (если < 50KB)
cp favicon.png /opt/claude-workspace/infra/web/assets/
git add infra/web/assets/favicon.png

# ✅ В git
vim /opt/claude-workspace/system/config/new-service.yaml
git add system/config/new-service.yaml

/opt/claude-workspace/projects/org/pirotehnika/
├── app/*/images/*.jpg
└── data/images/*.jpg

# 1. Найти все .jpg
find /opt/claude-workspace/projects/org/pirotehnika -name "*.jpg" -type f

# 2. Переместить в MEDIASPACE
mkdir -p $MEDIASPACE/images/products
mv найденные.jpg $MEDIASPACE/images/products/

# 3. Обновить пути в коде (если есть хардкод)
# Заменить: /opt/claude-workspace/projects/org/pirotehnika/images/
# На: $MEDIASPACE/images/products/
# Или URL: https://files.0kt.ru/images/products/

# 4. Удалить из git
git rm --cached app/*/images/*.jpg data/images/*.jpg

# 5. Добавить в .gitignore
echo "*.jpg" >> .gitignore

# 6. Коммит
git commit -m "chore: Move .jpg to MEDIASPACE"

/opt/claude-workspace/projects/org/pirotehnika/data/*.xlsx

# 1. Найти все .xlsx
find /opt/claude-workspace/projects/org/pirotehnika -name "*.xlsx" -type f

# 2. Переместить в DATASPACE
mkdir -p $DATASPACE/projects/pirotehnika/inbox
mv найденные.xlsx $DATASPACE/projects/pirotehnika/inbox/

# 3. Обновить пути в скриптах
# Заменить: /opt/claude-workspace/.../data/file.xlsx
# На: $DATASPACE/projects/pirotehnika/inbox/file.xlsx

# 4. Удалить из git
git rm --cached data/*.xlsx

# 5. Добавить в .gitignore
echo "*.xlsx" >> .gitignore
echo "*.xls" >> .gitignore

# 6. Коммит
git commit -m "chore: Move .xlsx to DATASPACE"

/opt/claude-workspace/projects/org/pirotehnika/app/*/venv/

cd /opt/claude-workspace/projects/org/pirotehnika

# 1. Создать requirements.txt
pip freeze > requirements.txt

# 2. Добавить в .gitignore
echo "venv/" >> .gitignore
echo "**/__pycache__/" >> .gitignore
echo "*.pyc" >> .gitignore

# 3. Удалить из git (НЕ удаляет локально)
git rm -r --cached app/*/venv/

# 4. Коммит
git commit -m "chore: Remove venv from git

- Use requirements.txt instead
- Add proper .gitignore rules
"

# 5. Пересоздать venv (на других машинах)
python3 -m venv venv
source venv/bin/activate
pip install -r requirements.txt

# /etc/nginx/sites-enabled/files.0kt.ru
location /images/ {
    alias /mnt/beget-s3/projects/pirotehnika/images/;  # ← НЕПРАВИЛЬНО
}

# 1. Исправить nginx конфиг
sudo vim /etc/nginx/sites-enabled/files.0kt.ru

# Заменить:
# alias /mnt/beget-s3/projects/pirotehnika/images/;
# На:
# alias /mnt/beget-s3/media/images/;

# 2. Проверить синтаксис
sudo nginx -t

# 3. Перезагрузить
sudo systemctl reload nginx

# 4. Проверить
curl -I https://files.0kt.ru/images/

location /images/ {
    alias /mnt/beget-s3/media/images/;
    autoindex on;
    charset utf-8;

    # CORS для OZON
    add_header Access-Control-Allow-Origin *;
    add_header Access-Control-Allow-Methods "GET, OPTIONS";

    # Cache
    expires 30d;
    add_header Cache-Control "public, immutable";
}

#!/bin/bash

# Список запрещенных расширений
BLACKLIST=".jpg .jpeg .xlsx .pdf .mp4 .db .sqlite"

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

# Проверка staged файлов
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 или \$MEDIASPACE."
    exit 1
  fi
done

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

chmod +x .git/hooks/pre-commit

#!/bin/bash

MAX_SIZE=1048576  # 1MB в байтах

echo "Проверка размера файлов..."

# Проверка staged файлов
git diff --cached --name-only --diff-filter=A | while read file; do
  if [ -f "$file" ]; then
    size=$(stat -f%z "$file" 2>/dev/null || stat -c%s "$file" 2>/dev/null)

    if [ $size -gt $MAX_SIZE ]; then
      echo "❌ ОШИБКА: Файл $file превышает 1MB ($size байт)"
      echo "Переместите в \$DATASPACE или \$MEDIASPACE"
      exit 1
    fi
  fi
done

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

#!/bin/bash

MAX_PNG_SIZE=51200  # 50KB

echo "Проверка размера .png..."

git diff --cached --name-only --diff-filter=A | grep "\.png$" | while read file; do
  if [ -f "$file" ]; then
    size=$(stat -f%z "$file" 2>/dev/null || stat -c%s "$file" 2>/dev/null)

    if [ $size -gt $MAX_PNG_SIZE ]; then
      echo "❌ ОШИБКА: .png файл $file превышает 50KB ($size байт)"
      echo "Переместите в \$MEDIASPACE/images/"
      exit 1
    fi
  fi
done

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

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

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

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

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

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

# Изображения (массовые)
*.jpg
*.jpeg
*.gif
*.webp

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

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

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

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

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

# Исключения (разрешены маленькие PNG и SVG)
!*.svg
!favicon.png
!logo.png

# Найти все запрещенные файлы в git
git ls-files | grep -E '\.(jpg|jpeg|xlsx|mp4|db)$'

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

# Найти файлы > 1MB в git
git ls-files | while read file; do
  size=$(git cat-file -s $(git ls-tree HEAD "$file" | awk '{print $3}') 2>/dev/null)
  if [ $size -gt 1048576 ]; then
    echo "$file: $size bytes"
  fi
done