Имена таблиц и полей
Из имени поля должно быть понятно, какую связь оно хранит.
Проверено Изменено
Плохо
CREATE TABLE sessions (
id uuid, ref uuid
);
Хорошо
CREATE TABLE sessions (
session_id uuid PRIMARY KEY,
user_id uuid REFERENCES users(user_id)
);
Почему это важно
Явные имена помогают читать запросы с несколькими таблицами.
Когда применять
snake_case и entity_id — соглашение этого справочника. Название id допустимо в другом последовательном соглашении; массовое переименование существующей БД не требуется.
Кто что делает
Человек
Согласует термины предметной области и существующие соглашения проекта.
AI-агент
Готовит схему или миграцию, проверяет граничные значения и совместимость с текущими запросами.
Контроль результата:
- Можно ли без комментария понять назначение ref?
Как проверить у себя
- Можно ли без комментария понять назначение ref?
Первоисточники
История изменений на GitHubДата проверки отражает содержательную сверку. Синхронизация сайта не обновляет её автоматически.