feat: scaffold newsfeed — user-controlled news feed
Some checks failed
deploy / build (push) Failing after 7s
deploy / deploy-api (push) Has been skipped
deploy / deploy-web (push) Has been skipped

A self-hosted feed where the user owns the ranking: per-source and signed
per-interest weights, decayed by recency, via a transparent deterministic
scorer. Content is sourced algorithmically (worker RSS/Atom polling) and
agentically (per-user API tokens POSTing candidates to the ingest endpoint).
Single-user today, multi-user by construction (every row keyed on user_id).

Rust cargo workspace + Vite/React/SWC/TS SPA:
- newsfeed-entities: DTOs (ts-rs bindings -> web/src/api/bindings)
- newsfeed-core: ranking, auth primitives, ingest, data-access ports
- newsfeed-data: SQLite adapters (sqlx, runtime queries)
- newsfeed-api: axum REST/JSON daemon
- newsfeed-worker: RSS polling + rescoring loop
- web: responsive, mobile-first SPA (React Query, generated types)

Deploy (Gitea Actions, build static musl + SPA, rsync as gitea_ci):
api+worker -> slartibartfast, SPA -> oolon (nginx serves + proxies /v1).

Deliberate deviations from house conventions (documented in CLAUDE.md/readme):
- SQLite instead of Postgres; api+worker co-locate sharing one DB file.
- Runtime sqlx queries instead of query! macros (SQLite dynamic typing;
  keeps CI database-free).

Verified end-to-end: auth, token ingest, interest-weighted ranking, signals,
pagination (curl + browser); cargo fmt/clippy -D/test and pnpm build/lint pass.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016fKZzDpvjiJ9eYbPGgJvUP
This commit is contained in:
2026-07-08 11:36:57 +03:00
commit 5ce52fff4d
104 changed files with 10963 additions and 0 deletions

View File

@@ -0,0 +1,45 @@
# Public (WAN) vhost for newsfeed, fronted by the oolon edge proxy.
#
# Provision the Let's Encrypt cert for rob.fyi (architecture external-tls.md — certbot,
# Cloudflare DNS-01, ECDSA) BEFORE enabling this vhost: `nginx -t` fails on a missing
# ssl_certificate, so only symlink this into sites-enabled once the cert exists
# (reverse-proxies.md §4).
#
# Mesh clients cannot use this name (the public-name hairpin gotcha, reverse-proxies.md
# §2) — they use newsfeed.internal instead. Both vhosts share the /var/www/newsfeed
# webroot and the newsfeed_api upstream defined in newsfeed.internal.conf.
server {
listen 443 ssl;
listen [::]:443 ssl;
http2 on;
server_name rob.fyi;
ssl_certificate /etc/letsencrypt/live/rob.fyi/fullchain.pem;
ssl_certificate_key /etc/letsencrypt/live/rob.fyi/privkey.pem;
# Classical curves for WAN clients that don't speak post-quantum yet (generic.md §11).
ssl_protocols TLSv1.2 TLSv1.3;
root /var/www/newsfeed;
index index.html;
location /v1/ {
proxy_pass http://newsfeed_api;
proxy_http_version 1.1;
proxy_set_header Host $host;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
}
location = /health {
proxy_pass http://newsfeed_api;
}
location / {
try_files $uri $uri/ /index.html;
}
location /assets/ {
expires 1y;
add_header Cache-Control "public, immutable";
try_files $uri =404;
}
}