Roadmap — CodeHub

📚

Phase 1: Static foundation

target: 2026-07-08 · status: released

DONE

โครงสร้าง 16TB + seed demo projects
static HTML generator (Python)
Journey-page per project (like 62.84.178.0:3001)
Aggregated /ai-instructions.md for AI consumption
nginx + Let's Encrypt SSL at codehub.sj88ai.com

⚙️

Phase 2: FastAPI backend

target: 2026-07-08 · status: released

DONE

Scan /mnt/16tb/codehub/ → REST API
11 endpoints in 4 OpenAPI tags (meta/projects/code/ai)
/docs Swagger + /openapi.json + /redoc
systemd codehub-api.service with 2 uvicorn workers

📤

Phase 3: Admin upload UI

target: 2026-07-08 · status: released

DONE

/admin HTML form + POST /api/admin/upload multipart
Auto-create new project OR new version in existing
Screenshot upload + code as JSON OR zip
Auto-trigger static-site rebuild after upload

📂

Phase 4: Recent activity

target: 2026-07-08 · status: released

DONE

/api/recent-activity — cross-project feed sorted by date

🏷️

Phase 5: Tags & categories filter

target: 2026-07-08 · status: released

DONE

/api/tags — all tags with counts
/api/projects?category= filtering
Homepage category buttons + project tag chips

🔍

Phase 6: Full-text search

target: 2026-07-08 · status: released

DONE

SQLite FTS5 index across meta + ai-instructions.md + code
/api/search?q= with snippets + BM25 highlights
/search page with auto-run for ?q=URL params

🔀

Phase 7: Diff viewer

target: 2026-07-08 · status: released

DONE

/api/diff/{slug}/{from}/{to} with file diffs via difflib
metadata diff + added/removed/changed/unchanged code files
/diff page with auto-populate from URL + syntax highlight

📊

Phase 8: Stats dashboard

target: 2026-07-08 · status: released

DONE

/api/stats/timeline — by-date event array for charts
/stats page with SVG cumulative-line + per-project bars
/api/categories — buckets with totals

💾

Phase 9: Backup automation

target: 2026-07-08 · status: released

DONE

scripts/backup.py — tar.gz projects/ to backups/
/etc/cron.d/codehub-backup — daily at 03:00, keep 7 snapshots
/api/admin/backups + /run + /restore — list/run/restore
Path-traversal-protected restore

🔐

Phase 10: Session-cookie auth

target: 2026-07-08 · status: released

DONE

POST /api/login — exchange token for HttpOnly 7-day cookie
GET /api/me — check auth status
POST /api/logout — revoke session
Back-compat: X-Admin-Token header still works for scripts
Admin page now uses cookie flow + logout button

10-Phase Plan — DONE

Phase 1: Static foundation

Phase 2: FastAPI backend

Phase 3: Admin upload UI

Phase 4: Recent activity

Phase 5: Tags & categories filter

Phase 6: Full-text search

Phase 7: Diff viewer

Phase 8: Stats dashboard

Phase 9: Backup automation

Phase 10: Session-cookie auth