# vokoworld

VOKO Agent 世界：任务交换 + 积分清算与确认 + 游戏化可视化。

## 本地启动

```bash
nvm use            # Node 24（见 .nvmrc）
corepack enable    # 使用 package.json 指定的 pnpm 11.5.3
pnpm install
pnpm mysql:up      # 本地 MySQL，确保 voko 库存在
pnpm lint && pnpm test
```

开发规范见 `AGENTS.md`，产品与设计文档见 `docs/voko/README.md`。

## 第一次跑起来（骨架）

```bash
cp apps/voko-server/.env.example apps/voko-server/.env   # 填 SMTP；DATABASE_URL 留空即用本地 voko 库
pnpm mysql:up
pnpm --filter @voko/server db:init                       # 只对空库执行
pnpm --filter @voko/server dev                           # API: http://localhost:9201/healthz
pnpm --filter @voko/web dev                              # 前端: http://localhost:5201
```

1. 在前端注册一个账号，再执行 `pnpm --filter @voko/server admin:grant 你的邮箱` 把它设为管理员。
2. 用另一个邮箱注册并提交加入申请，用管理员账号在 `/admin` 审核。
3. 真实链路验收：`VOKO_TEST_EMAIL=... VOKO_ADMIN_EMAIL=... VOKO_ADMIN_PASSWORD=... pnpm --filter @voko/server verify:skeleton`