OpenClaw Bot
59 lines
1.6 KiB
Markdown
59 lines
1.6 KiB
Markdown
# Rank
|
|
|
|
Interactive feature prioritization tool for `rank.friborg.uk`.
|
|
|
|
## Product definition
|
|
|
|
Rank is a fast intake and prioritization board for product ideas from Jimmi and agents.
|
|
|
|
Core loop:
|
|
|
|
`Capture idea → score impact/effort/confidence/urgency → drag into milestone → revisit top-ranked work`
|
|
|
|
Chosen subdomain: `rank.friborg.uk` — short, memorable, and honest about the job.
|
|
|
|
## UX principles
|
|
|
|
- One-screen capture, no modal ceremony.
|
|
- Keyboard-first: `/` focuses capture, Enter saves.
|
|
- Plain sharp visual system: zero rounded corners, dark space/glass, high contrast.
|
|
- Milestones are customizable lanes, not a rigid roadmap prison.
|
|
- Agents can post ideas through the same API endpoint as the UI.
|
|
|
|
## Architecture
|
|
|
|
- Node/Express app on port `3045`
|
|
- Static SPA in `public/`
|
|
- Appwrite TablesDB persistence
|
|
- Docker deploy on Unraid
|
|
- Gitea remote repo
|
|
- Nginx Proxy Manager routes `rank.friborg.uk` → `192.168.30.100:3045`
|
|
|
|
## Appwrite schema
|
|
|
|
Database: `priority_rank`
|
|
|
|
Tables:
|
|
|
|
- `ideas` — title, description, source, sourceName, milestoneId, impact, effort, confidence, urgency, score, rank, labels, notes, archived
|
|
- `milestones` — name, description, horizon, color, position, active
|
|
- `activity` — small append-only UX feed
|
|
|
|
## Commands
|
|
|
|
```bash
|
|
npm run setup:appwrite
|
|
npm run check
|
|
PORT=3045 node server.js
|
|
npm run smoke
|
|
```
|
|
|
|
Agent idea post:
|
|
|
|
```bash
|
|
curl -X POST https://rank.friborg.uk/api/ideas \
|
|
-H 'Content-Type: application/json' \
|
|
-H "Authorization: Bearer $RANK_AGENT_TOKEN" \
|
|
-d '{"title":"Add public roadmap export","source":"agent","sourceName":"Rook","impact":8,"effort":3,"confidence":7,"urgency":5}'
|
|
```
|