Kit.Db/docs/projects/kit-auth-token-db.md

100 lines
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Kit.Auth.Token.Db — Описание БД
## Общее описание
База данных для управления токенами авторизации. Хранит владельцев токенов, типы токенов и сами токены с возможностью валидации, отзыва и удаления.
- **Движок:** PostgreSQL
- **Схема:** `token`
---
## Структура проекта (по шаблону)
```
projects/pg/kit_auth_token_pg/
readme.md
settings/
connection.json
token/
tables/
owner.psql
token_type.psql
token.psql
functions/
owner/
owner_insert.psql
owner_select.psql
token/
token_consume.psql
token_delete.psql
token_insert.psql
token_revoke_by_owner.psql
token_revoke.psql
token_select.psql
token_update.psql
token_validate.psql
token_type/
token_type_select.psql
scripts/
init/
deploy/
token.psql # Точка входа модуля
token.post-deploy.psql # Post-deploy скрипты
_docs/
diagrams/
openapi.yaml
architecture.md
```
---
## Таблицы
### owner
Владельцы токенов (пользователи/системы).
### token_type
Справочник типов токенов (access, refresh и т.д.).
### token
Токены авторизации с привязкой к владельцу и типу.
---
## Функции
### owner/
| Функция | Назначение |
|---------|-----------|
| `owner_insert` | Создание владельца |
| owner_select` | Получение владельца |
### token/
| Функция | Назначение |
|---------|-----------|
| `token_insert` | Создание токена |
| `token_select` | Получение токена |
| `token_update` | Обновление токена |
| `token_delete` | Удаление токена |
| `token_consume` | Использование токена |
| `token_validate` | Валидация токена |
| `token_revoke` | Отзыв токена |
| `token_revoke_by_owner` | Отзыв всех токенов владельца |
### token_type/
| Функция | Назначение |
|---------|-----------|
| `token_type_select` | Получение типа токена |
---
## Миграции
- `2026-07-23` — Полная схема (create_full)
---
## Связи с другими БД
- Связана с `Kit.Auth.Db` (модуль `auth`) — владельцы токенов могут быть пользователями из auth.users