docs: document DEVPLACE_DISABLE_SERVICES env var, news router, modal class toggle, and news service behavior

This commit is contained in:
2026-05-12 10:45:52 +00:00
parent 331e19b14e
commit 388d4e3af8
36 changed files with 1232 additions and 301 deletions
+7 -5
View File
@@ -52,7 +52,8 @@ devplacepy/
| Prefix | Purpose |
|--------|---------|
| `/auth` | Signup, login, logout, forgot/reset password |
| `/feed` | Post feed with topic/tab filtering |
| `/feed` | Post feed with topic/tab filtering (public) |
| `/news` | Developer news listing, detail page with comments |
| `/posts` | Post detail, creation |
| `/comments` | Comment creation, deletion |
| `/projects` | Project listing, creation |
@@ -64,8 +65,7 @@ devplacepy/
| `/avatar` | Multiavatar proxy with in-memory cache |
| `/bugs` | Bug reports listing, creation |
| `/services` | Background service monitoring (status, logs) |
| `/follow` | Follow/unfollow users |
| `/admin` | Admin panel (user management, settings) |
| `/admin` | Admin panel (user management, news curation, settings) |
| `(none)` | `/robots.txt`, `/sitemap.xml` (SEO) |
## Configuration
@@ -95,17 +95,19 @@ The service appears at `/services` with live status and log tail.
### News service
Fetches news from a configurable API, grades each article via AI, stores those exceeding the grade threshold. Articles are never processed twice — tracked in `news_sync` table by `guid`.
Fetches news from a configurable API, grades each article via AI, stores ALL articles in the `news` table (nothing is silently skipped). Articles with grade >= the configurable threshold are auto-published; the rest go to draft. Admin can manually publish/draft, toggle for landing page appearance, and delete. Images are extracted from article URLs.
Configuration via admin site settings:
| Setting key | Default | Purpose |
|-------------|---------|---------|
| `news_grade_threshold` | `7` | Minimum AI grade to store |
| `news_grade_threshold` | `7` | Minimum AI grade for auto-publish |
| `news_api_url` | `https://news.app.molodetz.nl/api` | News source |
| `news_ai_url` | `https://openai.app.molodetz.nl/v1/chat/completions` | AI grading endpoint |
| `news_ai_model` | `molodetz` | AI model |
News articles have detail pages at `/news/{slug}` with full comment support (same component as posts/projects). The landing page can display curated articles toggled from admin.
CLI: `devplace news clear` — delete all news from local database.
## Database