Claude Management

Persistent command center untuk arsip penuh ekosistem Claude: projects, conversations, insights, search, analytics, maintenance, import/export, dan asset ingestion pipeline.

Stack

• Next.js 14 App Router
• Tailwind CSS
• GitHub API sebagai canonical data store (repo private)
• Vercel KV (queue mutasi untuk batch sync)
• GitHub Actions + Git LFS worker untuk ingestion asset

Core Architecture

1. Write endpoints (POST/PUT/DELETE) tidak langsung menulis data final.
2. Mutation event masuk ke queue KV.
3. Cron /api/internal/sync (setiap 5 menit) replay queue lalu commit batch ke repo data GitHub.
4. Read endpoints (GET) membaca canonical data + pending queue overlay.

API Surface

• GET/POST/PUT/DELETE /api/projects
• GET/POST/PUT/DELETE /api/conversations
• GET/POST/PUT/DELETE /api/insights
• GET /api/search
• GET /api/dashboard
• GET /api/analytics
• GET /api/recommendations
• GET /api/knowledge-map
• GET /api/maintenance
• POST /api/import
• GET /api/export
• POST /api/assets/upload
• POST /api/assets/ingest
• POST /api/internal/sync

Security Contract

• Read endpoint: publik
• Write endpoint: wajib header x-api-key: <WRITE_API_KEY>

Setup

npm install
cp .env.example .env.local
npm run dev

Required Environment Variables

Lihat .env.example.

LFS Worker

Template worker tersedia di docs/lfs-worker-template.yml. Panduan setup: docs/LFS-WORKER.md.