mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-18 17:21:23 +02:00
4d390be5af
- Move from apps-archived/ to apps/ - Delete NestJS API, Docker files, old docs, browser extension - Create Hono/Bun server with content extraction (Mozilla Readability) and AI feed API reading from mana-sync's sync_changes - Create local-first store (articles, categories) with guest seed data - Rewrite web app: Feed page, Saved articles with URL extraction, auth pages using shared-auth-ui, AuthGate with guest mode - Add news to shared-branding (app icon, mana-apps registry) - Add CLAUDE.md, dev scripts, root CLAUDE.md entry - 0 type errors on both server and web Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
67 lines
2 KiB
Markdown
67 lines
2 KiB
Markdown
# News Hub — AI News Reader & Personal Library
|
|
|
|
## Architecture
|
|
|
|
Local-first for saved articles, Hono/Bun server for content extraction and AI feed.
|
|
|
|
```
|
|
Browser → IndexedDB (Saved Articles, Categories)
|
|
↕ sync
|
|
mana-sync → PostgreSQL
|
|
|
|
Browser → Hono Server → Content Extraction (Mozilla Readability)
|
|
→ AI Feed (from sync_changes)
|
|
```
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
apps/news/
|
|
├── apps/
|
|
│ ├── web/ # SvelteKit web app (local-first)
|
|
│ ├── server/ # Hono/Bun (extraction, feed API)
|
|
│ └── landing/ # Astro marketing page
|
|
└── package.json
|
|
```
|
|
|
|
## Tech Stack
|
|
|
|
| Layer | Technology |
|
|
|-------|-----------|
|
|
| **Web** | SvelteKit 2, Svelte 5 (runes), Tailwind CSS 4 |
|
|
| **Server** | Hono + Bun, Mozilla Readability, JSDOM |
|
|
| **Data** | Local-first (Dexie.js + mana-sync) |
|
|
| **Auth** | mana-core-auth (Better Auth + EdDSA JWT) |
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
pnpm dev:news:web # SvelteKit dev server
|
|
pnpm dev:news:server # Hono/Bun server (port 3071)
|
|
pnpm dev:news:local # Web + Sync + Server (no auth)
|
|
pnpm dev:news:full # Everything incl. auth
|
|
```
|
|
|
|
## Hono Server Routes
|
|
|
|
| Route | Auth | Description |
|
|
|-------|------|-------------|
|
|
| `GET /health` | No | Health check |
|
|
| `GET /api/v1/feed` | No | AI article feed (type, categoryId, limit, offset) |
|
|
| `GET /api/v1/feed/:id` | No | Single article |
|
|
| `POST /api/v1/extract/preview` | No | Preview URL content extraction |
|
|
| `POST /api/v1/extract/save` | JWT | Extract + return article data |
|
|
|
|
## Local-First Collections
|
|
|
|
| Collection | Purpose |
|
|
|-----------|---------|
|
|
| `articles` | Saved articles (user_saved) + AI feed cache |
|
|
| `categories` | Article categories |
|
|
|
|
## Key Patterns
|
|
|
|
- **Content Extraction**: Mozilla Readability + JSDOM for robust HTML parsing
|
|
- **Saved Articles**: Local-first via IndexedDB, sync to server
|
|
- **AI Feed**: Loaded from Hono server, not local-first (server-generated)
|
|
- **Auth**: Guest mode allowed, sync starts on login
|