# 教学反馈助手小程序

## 本地开发

1. 确认微信开发者工具登录账号拥有 AppID `wx3fe11e262a4b4885` 对应小程序的开发权限。
2. 使用微信开发者工具命令行打开项目：

```bash
cli open --project /Users/zhangheng/project/ai/miniprogram/teaching-feedback-assistant --lang zh
```

3. 在微信开发者工具内编译、预览和调试。

小程序默认连接 `http://127.0.0.1:8080`。在开发者工具模拟器中，可进入“我的”页面保存其他 API 地址并检测服务状态。

## 验证

```bash
npm run typecheck
```

项目 AppID 已配置在 `project.config.json` 中。

## Rust 后端

Rust API 位于 [`server/`](./server)。它使用 Axum 和 PostgreSQL 驱动，但不会安装、启动或自动创建本地 PostgreSQL。

```bash
cd server
cp .env.example .env
# 在 .env 中填写 DATABASE_URL
cargo run --bin migrate
cargo run
```

未设置 `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)。

## 小程序与后端

- 学生档案、档案预设和反馈记录均通过 `utils/api.ts` 访问 Rust API。
- 开发者工具模拟器使用默认地址 `http://127.0.0.1:8080`。
- 真机和正式版本不能把 `127.0.0.1` 当作电脑地址；应部署可公网访问的 HTTPS API，并在微信公众平台配置 request 合法域名，然后到小程序“我的”页面修改服务地址。
- 微信登录尚未接入。业务请求暂时使用固定开发用户 UUID；生产发布前必须改为由后端根据微信登录凭据解析用户身份。