Ripple Pool

一个以前端视觉体验为重点的本地演示应用：紫色像素水波登录页会响应鼠标、点击和触摸；登录后可浏览水彩与水墨两种动态主题。后端仅负责本地账号验证与会话。

环境要求

• Node.js 20+
• Python 3.11+

启动后端

cd backend
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -e ".[dev]"
python scripts/seed_demo_account.py
uvicorn app.main:app --reload --port 8000

种子脚本会创建本地演示账号。密码通过脚本参数或交互输入提供，仓库不会保存明文密码。

当前本地演示账号：

• 用户名：demo
• 密码：secret

附加本地账号：

• 用户名：123
• 密码：123

启动前端

另开终端：

cd frontend
npm install
npm run dev

打开 http://localhost:3000。前端会将 /api/* 代理到 http://127.0.0.1:8000。

验证

cd backend
pytest

cd frontend
npm run lint
npm run typecheck
npx playwright test

完整人工验收步骤见 specs/001-interactive-ripple-login/quickstart.md。

安全说明

• 密码只以 bcrypt 哈希保存在 backend/data/accounts.json。
• 会话 ID 通过 HttpOnly、SameSite Cookie 传递。
• backend/data/sessions.json 是运行时文件，不应提交。
• 生产环境应启用 HTTPS，并将 Cookie 的 Secure 选项设为开启。