feat: add voice transcription feedback workflow

README.md

@@ -11,6 +11,8 @@ cli open --project /Users/zhangheng/project/ai/miniprogram/teaching-feedback-ass
 
 3. 在微信开发者工具内编译、预览和调试。
 
+反馈生成页使用小程序原生录音能力。短录音会直接追加到反馈内容，长录音每 8 分钟自动切片，多节录音可以汇总为一次反馈。真机首次使用时需要允许麦克风权限；中文转录默认使用项目自带的本地 FunASR 服务，不要求腾讯云密钥。
+
 小程序默认连接 `http://127.0.0.1:8080`。在开发者工具模拟器中，可进入“我的”页面保存其他 API 地址并检测服务状态。
 
 ## 验证
@@ -33,6 +35,15 @@ cargo run --bin migrate
 cargo run
 ```
 
+另开一个终端启动中文转录服务。首次启动会下载 Paraformer、VAD 和标点模型，下载完成后健康检查才会显示语音服务可用：
+
+```bash
+docker compose -f compose.asr.yml up --build -d
+curl http://127.0.0.1:10095/health
+```
+
+没有 Docker 时可按 [asr-service/README.md](./asr-service/README.md) 使用 Python 3.10 启动。Rust API 默认连接 `http://127.0.0.1:10095`；模型未就绪时已上传录音会保留在队列中，不会阻塞小程序上传。
+
 未设置 `DATABASE_URL` 时，仅健康检查可用，数据接口会返回 `503`。数据库配置和迁移说明参见 [server/API.md](./server/API.md)。
 
 服务启动后可打开 `http://127.0.0.1:8080/scalar` 查看并直接调用 Scalar 交互文档，原始规范位于 `http://127.0.0.1:8080/openapi.json`。完整测试顺序参见 [server/API_GUIDE.md](./server/API_GUIDE.md)。
@@ -40,6 +51,7 @@ cargo run
 ## 小程序与后端
 
 - 学生档案、档案预设和反馈记录均通过 `utils/api.ts` 访问 Rust API。
+- 反馈页只暴露一个语音入口；反馈批次、课节、录音片段和转录状态由后端自动维护。
 - 开发者工具模拟器使用默认地址 `http://127.0.0.1:8080`。
 - 真机和正式版本不能把 `127.0.0.1` 当作电脑地址；应部署可公网访问的 HTTPS API，并在微信公众平台配置 request 合法域名，然后到小程序“我的”页面修改服务地址。
 - 微信登录尚未接入。业务请求暂时使用固定开发用户 UUID；生产发布前必须改为由后端根据微信登录凭据解析用户身份。