farm_service/docs/validation.md

# 初始化验证记录

日期：2026-10-21。验证环境：Windows，rustc/cargo 1.98.0。

## 已完成

- 从用户指定的空仓库克隆至 `D:\Work\farm_service`。
- 初始化 Rust 2024 二进制应用和中文 README；协议初始为 MIT，后于
  2026-10-21 按用户选择切换为 AGPL v3（AGPL-3.0-only）。
- 用户资料使用单条 SQLite UPSERT 原子写入，按平台和用户 ID 去重。
- 首次正常编译完成，生成 `Cargo.lock`。
- `cargo test --all-targets`：6 项集成测试通过，无失败。
- `cargo fmt --check`：通过。
- `cargo clippy --locked --all-targets -- -D warnings`：通过，无警告。
- 真实本机 HTTP：健康检查、资料写入、资料读取、无令牌 401 均通过。
- 指定 info 日志级别，确认启动及资料写入事件写入每日 JSON 文件；
  日志只记录事件和平台，不包含测试用户 ID、昵称或令牌。
- Git 忽略规则实际检查：target、数据库、日志、.env、.env.local 被忽略；
  Cargo.lock、.env.example 可纳入版本控制。

## 验证边界

- 测试使用临时数据库与合成资料；没有采集真实 QQ 用户信息。
- 测试 HTTP 进程已停止；没有部署常驻服务。
- 未接入农场插件自动上报，未验证真实 QQ 群、官方 QQ 或公网代理。
- 本轮未实现活动管理、中心账本、多租户鉴权、用户删除及数据自动清理。
- 未执行 Linux 运行验证、依赖漏洞专项扫描或生产负载测试。
- 未提交、推送或创建 PR。新文件保留在本地仓库，供后续检查。

## 后续接入顺序

1. 在农场接入层取得可信的 QQ 号码与昵称，确认信息用途及保留政策。
2. 将平台命名空间明确为普通 qq，不能将官方 QQ OpenID 填成 QQ 号码。
3. 用仅保存在服务端和机器人配置中的令牌调用资料接口。
4. 为上报配置短超时；资料服务故障不能回滚已完成的基础农场操作。
5. 生产部署前落实 HTTPS、限流、访问日志脱敏、资料删除与备份政策。