📖 Глоссарий

Краткий справочник всех терминов. Для полного глоссария см. E:\Clients\Claude\CLAUDE-ABBREVIATIONS.md (1600+ строк).

A C D E F G H J L M N O P R S T V W

ADR CC

Architecture Decision Record — документ с обоснованием архитектурного решения.

Хранится в docs/adr/. Фиксирует почему выбран один подход, а не другой.

Alembic Python

Инструмент миграций БД для SQLAlchemy. Аналог Laravel Migrations для Python.

alembic revision --autogenerate && alembic upgrade head

Artisan Laravel

CLI Laravel. Запускает команды: миграции, генерацию кода, очереди.

php artisan migrate, php artisan make:controller

auto-format hook CC

Hook который автоматически форматирует файл после каждого изменения.

PHP→Pint, Python→Ruff, TS/Vue→ESLint. PostToolUse событие.

Caddy Docker

Reverse proxy сервер. Принимает все входящие запросы и перенаправляет в нужные контейнеры.

Управляется через proxy.cmd. Папка E:\Clients\Windows\proxy

claude_readonly БД

Специальная роль PostgreSQL для Claude — только чтение. Не может изменять данные.

CREATE ROLE claude_readonly WITH LOGIN; GRANT SELECT ON ALL TABLES TO claude_readonly;

CLAUDE.md CC

Файл инструкций для Claude в корне проекта. Читается автоматически.

Должен быть <150 строк. Содержит стэк, правила, критические ограничения.

Composition API Vue

Современный способ писать Vue компоненты. Используется вместо Options API.

<script setup lang="ts"> — обязателен в проектах.

Context Rot CC

Деградация качества ответов Claude к концу длинной сессии.

Решение: /clear или /compact. Установить CLAUDE_CODE_AUTO_COMPACT_WINDOW=400000

Context Window CC

Максимальный объём информации который Claude держит в "памяти" за раз.

~200K токенов для Claude Sonnet. При заполнении — компактация.

DDL БД

Data Definition Language — SQL команды для изменения структуры БД: CREATE, ALTER, DROP.

Заблокированы для claude_readonly роли. Только через миграции вручную.

DI (Dependency Injection) Laravel

Паттерн передачи зависимостей через конструктор. Делает код тестируемым.

public function __construct(private readonly PaymentService $service) {}

Docker Compose Docker

Инструмент запуска нескольких Docker контейнеров как единого стека.

Управляется через mcp__docker__docker_compose_* инструменты.

Eloquent Laravel

ORM Laravel. Позволяет работать с БД через PHP объекты, а не сырой SQL.

Использовать только в Service/Repository, не в Controller!

ESLint Flat Config Vue

Новый (v9+) формат конфигурации ESLint. Файл eslint.config.js вместо .eslintrc.

Используется в Vue/Nuxt проектах. Запуск через pnpm lint:fix.

FastAPI Python

Быстрый Python фреймворк для создания API. Автоматическая документация (OpenAPI).

Используется с SQLAlchemy 2 + Pydantic v2 + Alembic.

FormRequest Laravel

Класс Laravel для валидации запросов. Отделяет логику валидации от Controller.

$request->validated() — единственный безопасный способ получить данные.

Git Worktree Git

Инструмент Git для работы с несколькими ветками одновременно в разных папках.

git worktree add E:/Clients/wt/feature feat/feature main

Haiku CC

Самая дешёвая модель Claude ($0.8/$4 per 1M). Для простых задач.

Использовать для rename, format, простой regex. /model haiku

Hook CC

Скрипт который запускается автоматически до/после действий Claude.

PreToolUse, PostToolUse, Stop. Пишутся на Node.js (CJS).

Horizon Laravel

Dashboard для мониторинга Laravel очередей. Показывает джобы, статистику.

Мониторинг через boost_artisan({ command: "horizon:status" })

JsonResource Laravel

Класс Laravel для сериализации Eloquent модели в JSON. Контроль формата ответа API.

return new PaymentResource($payment); — обязательно в Controller.

laravel-boost MCP

MCP сервер для Laravel. Даёт Claude прямой доступ к роутам, моделям, Artisan.

Запускается внутри Laravel контейнера: php artisan boost:mcp

LSP (Language Server Protocol) MCP

Протокол для IDE-функций: goto definition, find references, rename. Использует Serena MCP.

Serena реализует LSP для PHP/Python/TypeScript.

Mass Assignment Безопасность

Уязвимость: передача всех полей из запроса в модель без фильтрации.

Защита: только $request->validated() или явный $fillable.

MCP (Model Context Protocol) MCP

Протокол расширений Claude. Позволяет подключать внешние инструменты (БД, Docker, IDE).

Настраивается в .mcp.json или settings.json.

MCP_TOOL_SEARCH CC

Переменная окружения для ленивой загрузки схем MCP. Экономит 47-95% токенов.

Установить: "env": {"MCP_TOOL_SEARCH": "1"} в settings.json

mypy Python

Статическая проверка типов Python. Находит ошибки типов до запуска кода.

[tool.mypy] strict = true в pyproject.toml

Nuxt 3 Vue

SSR фреймворк на Vue 3. Рендеринг на сервере для SEO и производительности.

Правило: все composables работают и server-side. import.meta.client для browser API.

OOM (Out of Memory) Docker

Ситуация когда контейнер использует больше RAM чем доступно. Убивается ОС.

Симптом: Exit code 137. Решение: shared_buffers=4GB, work_mem=64MB в PG.

OWASP TOP-10 Безопасность

10 самых распространённых веб-уязвимостей: SQL Injection, XSS, CSRF и др.

Claude автоматически избегает этих уязвимостей при написании кода.

Pest Laravel

Современный PHP фреймворк тестирования. Чище чем PHPUnit, поддерживает TDD.

./vendor/bin/pest --parallel для быстрого запуска всех тестов.

Pinia Vue

State management для Vue 3. Замена Vuex. Composition API синтаксис.

defineStore('name', () => { ... }) — только Composition API!

Pint Laravel

PHP форматтер от Laravel. Применяет PSR-12 стиль автоматически.

./vendor/bin/pint. Автоматически через auto-format hook.

postgres-mcp MCP

MCP сервер для PostgreSQL. С флагом --access-mode=restricted — только чтение.

Используется с ролью claude_readonly для двойной защиты.

PSR-12 Laravel

Стандарт форматирования PHP кода. Обязателен в Laravel проектах.

Автоматически применяется Pint. Настраивается в pint.json.

Pydantic v2 Python

Валидация данных Python через type hints. Замена dict в FastAPI.

class PaymentCreate(BaseModel): amount: Decimal. model_config для v2.

Read-only роль БД

Роль БД с правами только на чтение. Используется для безопасного доступа Claude.

claude_readonly — только SELECT. Без INSERT/UPDATE/DELETE/DDL.

Ruff Python

Быстрый Python линтер и форматтер. Заменяет flake8 + black + isort.

ruff check --fix && ruff format. Автоматически через auto-format hook.

Sanctum Laravel

Laravel пакет для API аутентификации через токены и SPA сессии.

Использовать Bearer token для API. Настроить SANCTUM_STATEFUL_DOMAINS.

Serena MCP

LSP-powered MCP сервер. Понимает код как IDE: goto definition, find usages.

Запускается через uvx. Нужен для PHP/Python/TypeScript навигации.

Skill (Superpowers) CC

Предустановленная workflow-инструкция для Claude. Активируется slash-командой.

/brainstorm, /write-plan, /tdd, /debugging, /verification

SQLAlchemy 2 Python

ORM для Python. Версия 2 — async-first, улучшенная типизация.

Использовать AsyncSession для async FastAPI handlers.

SSR (Server-Side Rendering) Vue

Рендеринг HTML на сервере, а не в браузере. Улучшает SEO и первую загрузку.

Nuxt 3 реализует SSR. Нельзя использовать localStorage без import.meta.client.

TDD (Test-Driven Development) CC

Методология: сначала тест, потом код. RED → GREEN → REFACTOR.

Обязателен для фич >5 файлов. Skill /tdd помогает следовать методологии.

Telescope Laravel

Инструмент отладки Laravel. Записывает запросы, очереди, исключения, SQL.

Данные в таблице telescope_entries. Доступны через postgres-mcp для анализа.

Token CC

Единица текста для ИИ. ~0.75 слова. Стоимость Claude = количество токенов × цена.

Sonnet: $3/$15 per 1M. Opus: $15/$75. Haiku: $0.8/$4 per 1M.

Token Inflation CC

Чрезмерно многословные ответы Claude. Увеличивают стоимость, засоряют контекст.

Решение: CLAUDE.md правило "отвечай кратко". MCP_TOOL_SEARCH=1.

Vitest Vue

Фреймворк тестирования для Vue/Nuxt. Быстрый, совместим с Jest API.

Для unit/component тестов. Playwright — только для e2e.

Worktree Git

Отдельная рабочая папка для другой ветки Git. Позволяет параллельную работу.

E:\Clients\wt\feature-name. Удалить после merge: git worktree remove.

WSL2 Docker

Windows Subsystem for Linux 2. Запускает Docker на Windows. Настроен на 38GB RAM.

C:\Users\..\.wslconfig: memory=38GB, swap=2GB. Применить: wsl --shutdown.