# 小正方助手 · 答卷 `answer` 字段的数据结构

> 配套文档：《表单题目数据结构.md》（题目维度 `subjectArray`）

---

## 1. 对象结构

```ts
{
  [subjectId: string]: AnswerValue,   // 题目 _id → 该题的作答值
  spendTime?: number,                 // 填写耗时（秒），非题目
  "A004_other"?: string               // 多选题「其他」的自填内容，非独立题目
}
```

| key | 规则 |
|---|---|
| 题目 id | 4 位字母数字（`A001` / `R01` / `C01`），与 `forms.subjectArray[]._id` 一一对应 |
| `spendTime` | 固定特殊 key，number，填写耗时（秒） |
| `{题目_id}_other` | 多选题选「其他」时旁挂的自填内容，后缀约定，不占独立题目 id |
| `startAnswerTime` / `cacheAnswerTime` | 仅本地草稿阶段存在，**提交时会被删除**，正式数据里不应出现 |

> 也就是说：`Object.keys(answer)` ≠ 题目列表，取答案要按 `subjectArray` 的 `_id` 白名单取。

---

## 2. `AnswerValue` 的六种形态

```ts
type AnswerValue =
  | string                                  // 文本、单选、下拉、日期、时间、扫码、车牌
  | string[]                                // 多选、多级联动、省市区、排序
  | { other: { value: string } }            // 单选/下拉选「其他」
  | { url: string, name?: string }          // 附件、手写签名
  | { latitude: number, longitude: number } // 地图选点、距离打卡
  | number;                                 // 打分 / NPS
```

| 形态 | 示例 |
|---|---|
| string | `"张三"` / `"2026-11-08"` / `"09:30"` |
| string[] | `["篮球", "羽毛球"]` / `["江苏省", "南京市", "栖霞区"]` |
| object（其他） | `{ "other": { "value": "考研复习" } }` |
| object（文件） | `{ "url": "https://cdn.example.com/sign/abc.png" }` |
| object（坐标） | `{ "name": "XX大厦", "address": "...", "latitude": 32.06, "longitude": 118.79 }` |
| number | `8` |

---

## 3. 题型 → value 结构对照

| 题型（type） | value 结构 | 示例 |
|---|---|---|
| `singleLineText` 单行文本 | string | `"张三"` |
| `multiLineText` 多行文本 | string | `"希望安排在上午"` |
| `radio` 单选 | string（选项名） | `"个人自习"` |
| `radio` 选「其他」 | `{ other: { value } }` | `{ "other": { "value": "自定义内容" } }` |
| `select` 下拉 | string；选其他同上 | `"本科"` | 同 radio |
| `checkbox` 多选 | string[] | `["篮球", "羽毛球"]` |
| `checkbox` 选「其他」 | string[] + 旁挂 `_other` | `"A004": ["篮球","其他"]`，`"A004_other": "自填内容"` |
| `multiSelect` 多级联动 | string[]（层级路径） | `["华北", "北京"]` |
| `region` 省市区 | string[] | `["江苏省", "南京市", "栖霞区"]` |
| `date` 日期 | string `YYYY-MM-DD` | `"2026-11-08"` |
| `time` 时间 | string `HH:mm` | `"09:30"` |
| `datetime` 日期时间 | string | `"2026-11-08 09:30"` |
| `mapLocation` 地图选点 | object（含经纬度） | `{ "name":"XX大厦","latitude":32.06,"longitude":118.79 }` |
| `distance` 距离打卡 | object / number | `{ "distance": 120, "latitude": ..., "longitude": ... }` |
| `scanCode` 扫码 | string | `"https://u.wechat.com/xxx"` |
| `licensePlate` 车牌 | string | `"苏A12345"` |
| `fujian` 文件上传 | object / object[] | `{ "url": "https://...", "name": "证明.pdf" }` |
| `sign` 手写签名 | object | `{ "url": "https://.../sign.png" }` |
| `reorder` 排序 | string[]（顺序即答案） | `["选项C", "选项A", "选项B"]` |
| `grade` 打分 / NPS | number | `8` |
| `maxdiff` | object / array | 见组件实现 |

---

## 4. 样例（解析后的对象）

```json
{
  "A001": "张三",
  "A002": "13800000000",
  "A003": "个人自习",
  "A004": ["篮球", "羽毛球"],
  "A005": { "other": { "value": "考研复习" } },
  "A006": ["江苏省", "南京市", "栖霞区"],
  "A007": "2026-11-08",
  "A008": { "url": "https://cdn.example.com/sign/abc.png" },
  "A009_other": "自带器材",
  "spendTime": 93
}
```