veilix.app/docs/decisions/D-008-uuid.md

D-008. UUID и случайные публичные коды

Статус: принято, 20.10.2026.

Решение

1. idType: 'uuid' в адаптере Postgres Payload: все id в базе, REST и URL админки — UUID. Автоинкремента нет.
2. Номера для людей — короткие случайные коды: заказы VX-7K3M9Q, ключи K-…, платежи, реферальные коды.

Рассмотренные варианты

Автоинкремент плюс отдельное поле UUID для внешнего мира — нужно следить, чтобы внутренний id нигде не утёк. Штатная настройка Payload решает задачу без кастома.

Последствия

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