время: приём чужого офсета и регистрация исключений линтера
- arch R13: валидное по RFC 3339 значение с чужим офсетом нормализуется при разборе; канонический вид — обязательство писателя, не контракт с партнёром - go R13: исключение регистрируется директивой //nolint на месте вызова, а не exclude-записью в конфиге, которая адресует путём и отвязывается
This commit is contained in:
@@ -53,6 +53,22 @@ layout — а расхождение проявится не на записи,
|
||||
«починены» тем, кто увидит в них дефект, и конвенция начнёт противоречить
|
||||
сама себе.
|
||||
|
||||
### R13. Исключение регистрируется директивой на месте вызова, а не в конфиге линтера
|
||||
|
||||
**ДОЛЖЕН.** Исключение из R3 оформляется как `//nolint:forbidigo // <причина>`
|
||||
на строке вызова; exclude-записи в конфигурации линтера для него не
|
||||
заводятся.
|
||||
|
||||
**Почему.** Запись в конфиге — второй реестр тех же двух мест: она адресует
|
||||
исключение путём к файлу, отвязывается при переносе кода и продолжает
|
||||
разрешать `time.Now()` там, где исключения уже нет, — молча. Директива
|
||||
переезжает вместе с кодом, и grep по `nolint:forbidigo` даёт весь список —
|
||||
та исчерпываемость, которой требует R3, проверяется одной командой. Голый
|
||||
`//nolint` без имени правила глушит на строке все проверки сразу, а без
|
||||
причины неотличим от заглушенного дефекта; обе деградации штатно ловит
|
||||
`nolintlint` (`require-specific`, `require-explanation`) — стандартный
|
||||
способ дисциплинировать директивы в golangci-lint.
|
||||
|
||||
### R4. В БД время хранится с секундной точностью, ширина 20 символов
|
||||
|
||||
**ДОЛЖЕН.** Каноническое значение в колонке — `2026-06-28T11:23:45Z`.
|
||||
@@ -86,7 +102,9 @@ layout — а расхождение проявится не на записи,
|
||||
офсеты, отличные от `Z`, — разбор шире вывода. Канонический вид гарантирует
|
||||
**писатель**, а не читатель; пока писатель один, этого достаточно, но
|
||||
значение из чужой системы, положенное в базу как пришло, нарушает R4 и
|
||||
обнаруживается не на записи, а на первой сортировке.
|
||||
обнаруживается не на записи, а на первой сортировке. Само решение
|
||||
«нормализовать, а не отклонять» — базовое (`arch/time.md` R13); здесь —
|
||||
Go-механика, из-за которой его легко нарушить незаметно.
|
||||
|
||||
### R7. В драйвер передаётся строка, а не `time.Time`
|
||||
|
||||
@@ -166,6 +184,6 @@ func utcTime(_ []string, a slog.Attr) slog.Attr {
|
||||
|
||||
## Связано
|
||||
|
||||
- `arch/time.md` — базовая конвенция: UTC как формат хранения, явная зона в
|
||||
календарных вычислениях.
|
||||
- `arch/time.md` — базовая конвенция: UTC как формат хранения, нормализация
|
||||
чужого входа, явная зона в календарных вычислениях.
|
||||
- `lang/go/config.md` — валидация зоны отображения загрузчиком конфига.
|
||||
|
||||
Reference in New Issue
Block a user