Add identifier normalization contract
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
93
rules/patterns/identifier-normalization/contract.md
Normal file
93
rules/patterns/identifier-normalization/contract.md
Normal file
@@ -0,0 +1,93 @@
|
||||
# Contract: Identifier Normalization
|
||||
|
||||
Version: 1.0
|
||||
|
||||
## Purpose
|
||||
|
||||
Правила хранения и сравнения идентификаторов оборудования:
|
||||
серийные номера, вендоры, версии прошивок, партномера, артикулы.
|
||||
|
||||
---
|
||||
|
||||
## Правило
|
||||
|
||||
Оригинальное значение **сохраняется как пришло** — регистр не меняется.
|
||||
Все сравнения, поиск и дедупликация выполняются **без учёта регистра**.
|
||||
|
||||
```
|
||||
Пришло: "SN-001-ABC" → хранится: "SN-001-ABC"
|
||||
Пришло: "sn-001-abc" → это тот же объект, не дубликат
|
||||
Пришло: "Sn-001-Abc" → то же самое
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Применяется к полям
|
||||
|
||||
- Серийный номер (`serial_number`, `serial`)
|
||||
- Вендор / производитель (`vendor`, `manufacturer`)
|
||||
- Версия прошивки (`firmware_version`, `fw_version`)
|
||||
- Партномер (`part_number`, `part_no`)
|
||||
- Артикул (`article`, `sku`)
|
||||
|
||||
---
|
||||
|
||||
## Реализация
|
||||
|
||||
### Go — сравнение
|
||||
|
||||
```go
|
||||
import "strings"
|
||||
|
||||
func SameIdentifier(a, b string) bool {
|
||||
return strings.EqualFold(a, b)
|
||||
}
|
||||
```
|
||||
|
||||
### Go — дедупликация
|
||||
|
||||
```go
|
||||
func deduplicateBySerial(items []Device) []Device {
|
||||
seen := make(map[string]struct{})
|
||||
result := items[:0]
|
||||
for _, item := range items {
|
||||
key := strings.ToLower(item.SerialNumber)
|
||||
if _, exists := seen[key]; !exists {
|
||||
seen[key] = struct{}{}
|
||||
result = append(result, item)
|
||||
}
|
||||
}
|
||||
return result
|
||||
}
|
||||
```
|
||||
|
||||
Ключ в map — всегда `strings.ToLower(value)`. Сам объект сохраняется с оригинальным значением.
|
||||
|
||||
### SQL — поиск и уникальность
|
||||
|
||||
Поиск:
|
||||
```sql
|
||||
SELECT * FROM devices WHERE LOWER(serial_number) = LOWER(?);
|
||||
```
|
||||
|
||||
Уникальный индекс (MySQL / MariaDB):
|
||||
```sql
|
||||
-- Collation ci обеспечивает case-insensitive уникальность
|
||||
ALTER TABLE devices MODIFY serial_number VARCHAR(255)
|
||||
CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
|
||||
|
||||
ALTER TABLE devices ADD UNIQUE INDEX uniq_serial (serial_number);
|
||||
```
|
||||
|
||||
SQLite:
|
||||
```sql
|
||||
CREATE UNIQUE INDEX uniq_serial ON devices (LOWER(serial_number));
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Что не делать
|
||||
|
||||
- Не приводить значение к нижнему или верхнему регистру перед сохранением.
|
||||
- Не считать `"SN-001"` и `"sn-001"` разными объектами.
|
||||
- Не использовать `==` для сравнения идентификаторов в Go — только `strings.EqualFold`.
|
||||
Reference in New Issue
Block a user