环境
production
运维总览
Haima Node API
商品下单自动化后端，提供队列处理、运行时观测与可直接部署的运维能力。
需要重点关注
接口签名 已开启
浏览器 已就绪
依赖健康
运行面板
这个首页应该优先回答三件事：服务是否在线、依赖是否可用、操作入口在哪里。真正的业务接口和监控入口都从这里能快速找到。
数据库
外部 MySQL 可连接
主数据库连接健康，能够响应就绪检查。
Redis / 队列
Redis 不可用
Redis ping failed: Command timed out
浏览器运行时
浏览器自动化池已就绪
Playwright 浏览器已初始化，可接收自动化任务。
运行说明
值班提示
浏览器池已就绪，可执行 Apple 自动化任务。
- 请求时间：2026-05-09T04:41:29.127Z
- 调试端口：9222-9230
- 请求 ID：
1222cbad-7a4a-4e91-b6fe-bb183aa724b4
运维快捷入口
运维快捷入口
值班时最常点开的入口集中在这里，避免在文档和代码之间来回找路径。
状态
健康总览
给人和仪表盘查看的详细运维健康视图。
/health
探针
存活探针
用于容器和反向代理心跳的快速进程级检查。
/health/live
探针
就绪探针
流量准入检查，会验证数据库、Redis 和浏览器运行时是否就绪。
/health/ready
运行时
浏览器就绪
确认 Playwright 已就绪，再放行 Phase1 和 Phase2 流量。
/api/apple/ready
订单
订单列表
排障时使用的生产对齐订单列表入口。
/api/apple/orders
运维
日志中心
查看每日日志流数量和审计状态的运维摘要页。
/logs
监控
指标接口
Prometheus 文本指标入口，供监控系统拉取。
/metrics
告警
告警摘要
当前进程视角的活跃告警摘要与阈值结果。
/api/ops/alerts
日志
活动日志接口
按订单查看结构化活动时间线，方便定位失败步骤。
/api/apple/orders/{id}/activities
探针语义
探针说明
- `/health/live` 只回答进程是否还活着，适合容器自检和最基础存活探针。
- `/health/ready` 会检查数据库、Redis 和浏览器运行时，只有真正能接业务流量时才返回 200。
- `/health` 保留详细运维视图，适合值班同学和仪表盘直接查看依赖状态。
主要接口
服务入口
| GET | / |
通过 nginx 暴露的面向人工查看的运维首页。 |
| GET | /health/live |
用于容器心跳和基础反向代理检查的存活探针。 |
| GET | /health/ready |
用于数据库、Redis 和浏览器运行时准入的就绪探针。 |
| GET | /health |
供运维和值班面板查看的详细结构化健康文档。 |
| GET | /api/apple/ready |
用于下单自动化的 Playwright 浏览器就绪检查。 |
| GET | /api/apple/orders |
与生产订单中心字段对齐的订单列表接口。 |
| GET | /api/apple/orders/:id/activities |
客服排查和失败复盘用的按订单结构化时间线。 |
| GET | /api/apple/orders/:id/audit |
供签名运维访问的完整敏感审计日志接口。 |
| GET | /logs |
面向人工查看的日志中心页面，展示日志流数量和审计说明。 |
| GET | /api/ops/logs/summary |
供仪表盘和 runbook 使用的机器可读日志摘要接口。 |
| GET | /metrics |
Prometheus 指标文本接口，默认受运维鉴权保护。 |
| GET | /api/ops/alerts |
当前进程维度的告警摘要接口，适合仪表盘与值班脚本调用。 |
| POST | /api/apple/checkout-sessions |
Phase1 预备单创建入口。 |
| POST | /api/apple/payment |
Phase2 礼品卡支付执行入口。 |
生产守则
生产要求
- 写接口已开启签名校验。
- 公网接口已启用统一限流。
- 每个请求都会附带 x-request-id，便于在 nginx 与 NestJS 日志中追踪整条链路。