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

2.6 KiB
Raw Blame History

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