docs: 部署手册补充时序库已内置

部署编排已加入 TDengine（tdengine 3.3.6.13）与 tdengine-init 建库建表服务，
文档同步：
- prerequisites：外部依赖章节把 TDengine 从「可选/需自行部署」改为「已内置」，
  列出两个库的分片/保留/超级表，并说明与生产的版本差异
- troubleshooting：历史流量无数据一节改为常见原因表（init 未成功、库表缺失、地址错误），
  给出对应的排查命令与处理方式

docs/deploy/prerequisites.md

@@ -114,22 +114,21 @@ firewall-cmd --reload
 
 ## 外部依赖（可选）
 
+以下能力需要外部账号或服务，**不影响平台主流程**：
+
 | 服务 | 用途 | 不配置的影响 |
 | --- | --- | --- |
-| TDengine 3.x | 存流量历史数据 | 历史流量查询不可用，主流程正常 |
 | 短信服务商 | 发送验证码 | 无法发送短信 |
 | 微信支付 | 在线支付 | 支付功能不可用 |
 | 飞书 | 运维通知 | 不启动 bot 即可 |
 
-TDengine 需开启 WebSocket 接口（默认 6041），在 `docker-compose.yml` 中配置：
+::: tip 时序库已内置
+流量历史使用的 TDengine **已包含在编排里**，由 `tdengine-init` 服务在首次启动时自动建库建表，无需额外申请或配置：
 
-```bash
+| 库 | 分片 | 保留 | 超级表 |
-TDENGINE_HOST=tdengine.example.com
+| --- | --- | --- | --- |
-TDENGINE_PORT=6041
+| `iotlcm_daily` | 7 天 | 3 年 | `t_sim_card_usage_daily` |
-TDENGINE_USER=root
+| `iotlcm_monthly` | 30 天 | 3 年 | `t_sim_card_usage_monthly` |
-TDENGINE_PASSWORD=
-TDENGINE_DAILY_DB=iotlcm_daily
-TDENGINE_MONTHLY_DB=iotlcm_monthly
-```
 
-不使用时全部留空。
+编排使用的版本是 `3.3.6.13`（公开镜像可得），生产为 `3.4.0.9`。如需与生产完全一致，可自行构建镜像并替换 `docker-compose.yml` 中的 tag。
+:::

docs/deploy/troubleshooting.md

@@ -143,13 +143,23 @@ docker compose logs upstream-chan --tail=50
 
 ### 历史流量查询无数据
 
-**原因**：TDengine 未配置或不可达。
+**原因**：TDengine 未启动、未完成建表，或配置里的地址不对。
 
 ```bash
 docker compose logs worker-svr | grep -i 'tdengine\|taos' | tail -20
+docker compose logs tdengine-init | tail -20     # 建库建表是否成功
+docker compose exec tdengine taos -s "show databases;"
 ```
 
-确认 `docker-compose.yml` 的 `TDENGINE_*` 已填，且 WebSocket 端口（默认 6041）可达。不用该功能留空即可。
+常见原因与处理：
+
+| 现象 | 原因 | 处理 |
+| --- | --- | --- |
+| `tdengine-init` 报 MISS | 建表失败 | 看该容器日志里的 `DB error`；改 `tdengine-init/init.sql` 后重跑 `docker compose up -d tdengine-init` |
+| worker 日志报库表不存在 | 未执行建表 | 同上，确保 init 容器退出码为 0 |
+| 连接超时 | 地址/端口不对 | 配置里应为 `ws(tdengine:6041)`，容器内用服务名而非 IP |
+
+建表脚本全部带 `IF NOT EXISTS`，可重复执行。
 
 ### 短信发不出去