refactor(go): make history totals opt in

docs/architecture/storage-minimal-contract.md

@@ -49,14 +49,19 @@
 4. `vehicle_locations` 不再接收临时身份兜底字段。
    - 原因：位置历史是正式车辆时间序列，只按 `protocol + vin` 分表和查询。
    - 无 VIN 的位置帧仍保留在 `raw_frames.parsed_json`，待 identity/binding 修复后可从 raw 重放补写。
+   - 查询：`/api/history/locations` 默认不执行大表 `COUNT(*)`，`total` 表示本页返回条数；只有需要精确总数时传 `includeTotal=true`。
    - 生产：ECS TDengine `vehicle_locations` 已在上线前重建为 `protocol`、`vin` 两个 tag。
 
-5. MySQL realtime 当前态表不保留代理主键和创建时间。
+5. 历史 raw 查询默认不做精确总数。
+   - 原因：`raw_frames` 是最高写入量证据层，分页/排查通常只需要最新一页数据。
+   - 查询：`/api/history/raw-frames` 默认 `total` 为本页返回条数；只有导出前预估、后台管理需要总页数时才传 `includeTotal=true`。
+
+6. MySQL realtime 当前态表不保留代理主键和创建时间。
    - 原因：`vehicle_realtime_snapshot`、`vehicle_realtime_location` 都是每协议每 VIN 一行的当前态投影，业务主键就是 `(protocol, vin)`。
    - 状态：schema 使用 `PRIMARY KEY (protocol, vin)`，不保留自增 `id` 和 `created_at`，对外只暴露最新 `updated_at`。
    - 生产：项目上线前可直接重建这两张 MySQL 表，实时数据会从 Kafka 新消息继续投影。
 
-6. identity 层只保留两张表。
+7. identity 层只保留两张表。
    - `vehicle_identity_binding`：VIN 与 plate/phone/device_id 的映射，供 808 等协议反查 VIN。
    - `jt808_registration`：808 注册、鉴权、最新活跃和 VIN 匹配状态。
    - 状态：`vehicle_identity_binding` 使用 VIN 主键；`jt808_registration` 使用 phone 主键；两张表都不保留代理自增主键和 `created_at`。