Michael Chus
0005f3e41a
The always-on set is paid by every session, so it gets the tightest form: git-sync-check shrinks to its procedural core, testing-policy moves the table-test example to README.md and folds the agent instructions into the rules, go-code-style inlines the error-wrapping example. Per-session read cost drops from 403 to 336 lines. Also restore the pagination response fields in table-management: the previous dedup replaced them with a reference to go-api, which the table router line does not load. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
3.5 KiB
3.5 KiB
Contract: Testing Policy
Version: 1.2
Purpose
Определяет когда писать тесты, когда не писать, и как их поддерживать.
Применяется ко всем проектам на Go. Агенты следуют этим правилам самостоятельно,
без запроса подтверждения. See README.md for a reference table test.
Когда тест обязателен
Тест пишется всегда, когда код делает нетривиальное преобразование данных или реализует бизнес-логику:
- Парсеры — любой код, читающий внешний формат (XML, JSON, CSV, бинарный)
- Трансформации — конвертация единиц, нормализация, маппинг полей
- Бизнес-правила — расчёты, фильтрация, агрегация, приоритизация
- Граничные случаи — пустой ввод, нулевые значения, переполнение, отсутствующие поля
- Degraded / legacy states — legacy schema, interrupted migrations, duplicates, invalid persisted rows, partially migrated tables
- Регрессии — если баг был найден, тест фиксирует его до исправления
Тест пишется в том же коммите, что и функциональность. Функциональность без теста (там где он обязателен) — неполный коммит.
Для local-first desktop приложений правила деградированных состояний и recovery-тестов определяются также local-first-recovery contract.
Когда тест не нужен
Тест не пишется на код, где он не даёт ценности. Не писать его и не упоминать его отсутствие:
- Геттеры и сеттеры:
func (s *Server) Port() int { return s.port } - Конфиг-структуры и константы
- Тривиальный клей: передача параметров, инициализация, dependency wiring
- Логирование и форматирование вывода
- HTTP-хендлеры без бизнес-логики (только роутинг и вызов сервиса)
Структура теста
- Стандартный Go
testing. Табличные тесты ([]struct{ ... }) — когда случаев больше двух. - Фикстуры (XML, JSON, бинарные данные) — инлайн-константы или файлы в
testdata/. - Не использовать реальные сетевые вызовы и реальную БД в юнит-тестах.
Мейнтейнс
- Сломанный тест — чинится или удаляется в том же коммите где сломался.
- Закомментированный тест — не допускается. Если тест неактуален — удалить.
- Тест, проверяющий удалённую функциональность — удалить вместе с функциональностью.
- При удалении функциональности — удалить соответствующие тесты в том же коммите.