docs: update documentation to OKF v0.1 format

2026-07-23 12:10:36 +00:00
parent 6bac67fad7
commit 785d56c02d
8 changed files with 618 additions and 2 deletions
@@ -42,6 +42,7 @@ re-asserts the unique indexes on `system_key` and `abbreviation`.
 | `solve`           | User-solved challenges (scoring ledger).                    |
 | `refresh_token`   | Rotating refresh tokens (hash + revocation).                |
 | `blog_post`       | Markdown blog posts in draft/published states.              |
+| `admin_operation_token` | Single-use confirmation tokens for destructive System operations. |

 # Relationships

@@ -68,6 +69,7 @@ user ───< refresh_token
 | `solve`          | `uq_solve_challenge_user` (unique), `idx_solve_user`, `idx_solve_challenge` |
 | `refresh_token`  | `idx_refresh_token_user`, unique on `token_hash`  |
 | `blog_post`      | `idx_blog_status_published` (`status`, `published_at`) |
+| `admin_operation_token` | `uq_admin_op_token_hash` (unique on `token_hash`), `idx_admin_op_token_user_op` (`user_id`, `operation`), `idx_admin_op_token_expiry` (`expires_at`) |

 # PRAGMAs

@@ -91,3 +93,4 @@ On every process start, `DatabaseInitService.init()`:
 - [Challenge Tables](/database/challenges.md)
 - [Auth and Settings Tables](/database/auth-settings.md)
 - [Blog Post Table](/database/blog-posts.md)
+- [Admin Operation Tokens Table](/database/admin-operation-tokens.md)