# 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