This commit is contained in:
Lukas 2025-11-27 19:02:55 +01:00
parent ff5b364852
commit da4973829e
4 changed files with 79 additions and 83 deletions

View File

@ -17,7 +17,7 @@
"keep_days": 30
},
"other": {
"master_password_hash": "$pbkdf2-sha256$29000$AsCYU2pNCYHwHoPwnlPqXQ$uHLpvUnvj9GmNFgkAAgk3Yvvp2WzLyMNUBwKMyH79CQ",
"master_password_hash": "$pbkdf2-sha256$29000$AQAAAKAUImRsTSlFCGFMaQ$farZvo8fZCY9ZX7UiGFXTMtdduNvfSSVP8iDNwSWqfo",
"anime_directory": "/mnt/server/serien/Serien/"
},
"version": "1.0.0"

View File

@ -1,27 +1,6 @@
{
"pending": [
{
"id": "03bfbf39-60b7-4790-ae9e-a158f654dafa",
"serie_id": "a-star-brighter-than-the-sun",
"serie_folder": "Ein Stern, heller als die Sonne (2025)",
"serie_name": "A Star Brighter Than the Sun",
"episode": {
"season": 1,
"episode": 8,
"title": null
},
"status": "cancelled",
"priority": "NORMAL",
"added_at": "2025-11-22T16:36:10.705099Z",
"started_at": "2025-11-22T16:36:16.078860Z",
"completed_at": "2025-11-22T16:37:02.340465Z",
"progress": null,
"error": null,
"retry_count": 0,
"source_url": null
}
],
"pending": [],
"active": [],
"failed": [],
"timestamp": "2025-11-22T16:37:02.340599+00:00"
"timestamp": "2025-11-27T17:59:24.301867+00:00"
}

View File

@ -33,7 +33,7 @@ tests/ # Test suites
## Technology Stack
| Layer | Technology |
| ---------- | --------------------------------------------------- |
| --------- | ---------------------------------------------- |
| Backend | FastAPI, Uvicorn, SQLAlchemy, SQLite, Pydantic |
| Frontend | HTML5, CSS3, Vanilla JS, Bootstrap 5, HTMX |
| Security | JWT (python-jose), bcrypt (passlib) |
@ -51,11 +51,13 @@ All lookups, events, and API operations use `key`. The `folder` is metadata for
## API Endpoints
### Authentication (`/api/auth`)
- `POST /login` - Master password authentication (returns JWT)
- `POST /logout` - Invalidate session
- `GET /status` - Check authentication status
### Configuration (`/api/config`)
- `GET /` - Get configuration
- `PUT /` - Update configuration
- `POST /validate` - Validate without applying
@ -63,6 +65,7 @@ All lookups, events, and API operations use `key`. The `folder` is metadata for
- `POST /backups/{name}/restore` - Restore backup
### Anime (`/api/anime`)
- `GET /` - List anime with missing episodes (returns `key` as identifier)
- `GET /{anime_id}` - Get anime details (accepts `key` or `folder` for backward compatibility)
- `POST /search` - Search for anime (returns `key` as identifier)
@ -70,10 +73,12 @@ All lookups, events, and API operations use `key`. The `folder` is metadata for
- `POST /rescan` - Trigger library rescan
**Response Models:**
- `AnimeSummary`: `key` (primary identifier), `name`, `site`, `folder` (metadata), `missing_episodes`, `link`
- `AnimeDetail`: `key` (primary identifier), `title`, `folder` (metadata), `episodes`, `description`
### Download Queue (`/api/queue`)
- `GET /status` - Queue status and statistics
- `POST /add` - Add episodes to queue
- `DELETE /{item_id}` - Remove item
@ -82,6 +87,7 @@ All lookups, events, and API operations use `key`. The `folder` is metadata for
- `DELETE /completed` - Clear completed items
### WebSocket (`/ws/connect`)
Real-time updates for downloads, scans, and queue operations.
**Rooms**: `downloads`, `download_progress`, `scan_progress`
@ -102,9 +108,11 @@ Real-time updates for downloads, scans, and queue operations.
## Core Services
### SeriesApp (`src/core/SeriesApp.py`)
Main engine for anime series management with async support, progress callbacks, and cancellation.
### Callback System (`src/core/interfaces/callbacks.py`)
- `ProgressCallback`, `ErrorCallback`, `CompletionCallback`
- Context classes include `key` + optional `folder` fields
- Thread-safe `CallbackManager` for multiple callback registration
@ -112,7 +120,7 @@ Main engine for anime series management with async support, progress callbacks,
### Services (`src/server/services/`)
| Service | Purpose |
| ----------------- | ------------------------------------------- |
| ---------------- | ----------------------------------------- |
| AnimeService | Series management, scans (uses SeriesApp) |
| DownloadService | Queue management, download execution |
| ScanService | Library scan operations with callbacks |
@ -124,18 +132,24 @@ Main engine for anime series management with async support, progress callbacks,
## Frontend
### Static Files
- CSS: `styles.css` (Fluent UI design), `ux_features.css` (accessibility)
- JS: `app.js`, `queue.js`, `websocket_client.js`, accessibility modules
### WebSocket Client
Native WebSocket wrapper with Socket.IO-compatible API:
```javascript
const socket = io();
socket.join('download_progress');
socket.on('download_progress', (data) => { /* ... */ });
socket.join("download_progress");
socket.on("download_progress", (data) => {
/* ... */
});
```
### Authentication
JWT tokens stored in localStorage, included as `Authorization: Bearer <token>`.
## Testing
@ -154,11 +168,13 @@ conda run -n AniWorld python -m pytest tests/api/ -v
## Production Notes
### Current (Single-Process)
- SQLite with WAL mode
- In-memory WebSocket connections
- File-based config and queue persistence
### Multi-Process Deployment
- Switch to PostgreSQL/MySQL
- Move WebSocket registry to Redis
- Use distributed locking for queue operations

View File

@ -187,6 +187,7 @@ For each task completed:
**Completed:** November 27, 2025
Updated `src/server/api/anime.py` to standardize all endpoints to use `key` as the primary series identifier:
- Updated `AnimeSummary` model with proper documentation (key as primary identifier)
- Updated `AnimeDetail` model with `key` field (replaced `id` field)
- Updated `get_anime()` endpoint with key-first lookup and folder fallback