frontend/README.md

# CHB Frontend (Multinodular SuperAgent UI)

A production-ready React + Vite app that implements the complete CHB UI:
- Auth (Signup/Login) with **Admin Key** gate (validated by backend against **Hugging Face Space Secrets**).
- Siri-like **global voice** (STT/TTS), **Orbit** state indicator, **revolving brain**.
- **User dashboards**: Chat, History, API Keys (with rate bar), HowTo, About, Settings.
- **Admin dashboards**: Monitor (WebSocket), Knowledge, Skills, VFS, Verify, Logs, Users, Connections.
- **Notifications bell**, rate limits (user), unlimited admin.

## Quick Start
```bash
cp .env.example .env
# update .env to point to your backend
npm i
npm run dev
```

## Expected Backend Endpoints
- `POST /auth/signup` → { token, role, name, nickname }
- `POST /auth/login` → { token, role, name, nickname }
- `POST /v1/chat` → { reply }
- `POST /v1/facts/search` → { items: [{q,a,t}] }
- `GET /v1/apikey/usage` → { used, limit, period, key }
- `POST /v1/apikey/create` → { key }
- `POST /v1/apikey/revoke` → {}
- Admin endpoints under `/admin/*` (see src/services/api.js)

> The real Admin Key must be stored in HF Space Secrets and validated **only on the backend**.

## Notes
- Uses Web Speech API (Chrome recommended) for voice.
- Uses Socket.IO for Monitor page; set `VITE_WS_URL` in `.env`.
- This UI never stores the Admin Key locally.