External/SnapOtter
1
0
Fork 0
mirror of https://github.com/snapotter-hq/SnapOtter.git synced 2026-08-03 07:46:42 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: add teams + user_files tables, fix jobs.progress type (real 0-1)

Browse Source
This commit is contained in:
ashim-hq
2026-04-16 16:26:58 +08:00
parent a2d41575a2
commit 697b13de7a
1 changed files with 32 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
apps/docs/guide/database.md
+32 -1
View File
@@ -31,6 +31,17 @@ Active login sessions. Each row ties a session token to a user.
| `expiresAt` | text | ISO timestamp |
| `createdAt` | text | ISO timestamp |
### teams
Groups for organizing users. Admins can assign users to teams.
| Column | Type | Description |
|--------|------|-------------|
| `id` | text UUID | Primary key |
| `name` | text (unique, max 50 chars) | Team name |
| `createdAt` | integer | Unix timestamp |
| `updatedAt` | integer | Unix timestamp |
### api_keys
API keys for programmatic access. The raw key is shown once on creation; only the hash is stored.
@@ -58,6 +69,26 @@ Saved tool chains that users create in the UI.
| `steps` | text | JSON array of `{ toolId, settings }` objects |
| `createdAt` | text | ISO timestamp |
### user_files
Persistent file library with version chain tracking. Each processing step that saves a result creates a new row linked to its parent via `parentId`, forming a version tree.
| Column | Type | Description |
|--------|------|-------------|
| `id` | text UUID | Primary key |
| `userId` | text UUID | FK → users (CASCADE DELETE) |
| `originalName` | text | Original upload filename |
| `storedName` | text | Filename on disk |
| `mimeType` | text | MIME type |
| `size` | integer | File size in bytes |
| `width` | integer | Image width in px |
| `height` | integer | Image height in px |
| `version` | integer | Version number (1 = original) |
| `parentId` | text UUID \| null | FK → user_files (parent version) |
| `toolChain` | text (JSON array) | Tool IDs applied in order to produce this version |
| `createdAt` | integer | Unix timestamp |
| `updatedAt` | integer | Unix timestamp |
### jobs
Tracks processing jobs for progress reporting and cleanup.
@@ -67,7 +98,7 @@ Tracks processing jobs for progress reporting and cleanup.
| `id` | text | Primary key (UUID) |
| `type` | text | Tool or pipeline identifier |
| `status` | text | `queued`, `processing`, `completed`, or `failed` |
| `progress` | integer | 0-100 percentage |
| `progress` | real | 0.0–1.0 fraction |
| `inputFiles` | text | JSON array of input file paths |
| `outputPath` | text | Path to the result file |
| `settings` | text | JSON of the tool settings used |