ARR 自动取数交付与生产启用说明

交付日期：2026-09-18。状态：开发收尾完成，生产配置和真实数据验收待完成。 用户已确认日期选择交互可用，并说明当前测试环境没有可用于验收的数据。

完成的产品流程

选择一天 → 从 OHIP 获取到店预订和关联资料 → 按既有规则筛选、去重、定价 → 生成日报 → 入库后自动更新月报 → 下载处理后的报表。

自动入口覆盖15个业务字段、8个查询接口；Trace按约定不获取。
直接处理接口数据，不生成中间XML；原人工XML上传入口保留。
日期选择、运行中预选、任务状态、重复提交保护和原任务恢复已实现。
缺少定价资料进入原有价格复核；影响处理的必需字段缺失或存在无法确定的候选时提示异常。
本机模拟已覆盖日报、复核、入库、月报、报表下载及断线恢复；用户确认日期交互验收通过。

字段：对接表。产品使用：直接数据入口。

正式启用必须完成的配置

项目	当前边界及启用要求
酒店与平台	当前本机是OHIPSB02沙箱。生产须由平台完成正式Oracle环境/酒店的路由和授权；本地hotel-id仅校验返回酒店，不能把沙箱接口切成生产接口。
应用身份	当前客户端固定平台`https://ohip.nianxx.cn`及应用`caller_zloxalzsQ9pYsztt`。如生产改用其他平台或新应用，需适配并验证固定身份配置；替换一份不同身份的密钥文件会被拒绝。
读取权限	现沙箱所需权限已补齐。生产应用须覆盖预订、档案、团队、房间历史及套餐8个操作；现有配置需求包含reservations.read、profiles.read、blocks.read、configuration.read。保留平台已授其他权限，不盲目覆盖权限集。
数据库	在已具备018的目标库上应用019；既有迁移及运行配置要求隔离库名`booking_test`。若正式环境使用其他库名，先适配和验证数据库边界，不能直接删除保护或假设已有兼容。
自动取数入口	标准启动器支持三个OHIP参数，现有基础Compose尚未传入，部署时须明确加入。仅按基础Compose启动会保留原处理入口而不启用自动取数。
凭据和持久数据	挂载正式凭据目录，并为任务/原始数据配置仓库外的持久目录。目录0700、凭据文件0600，属主为实际运行用户；容器须按容器UID准备属主。凭据只读挂载，任务目录可写，不能放临时目录或镜像内。
月报与报表存储	复用正确配置的数据库和OSS，独立月报worker须由进程管理器持续运行。网页可访问、Web健康检查成功不等于月报worker已启动。

当前固定平台/应用身份和数据库名称均保留原有边界，本次收尾没有放宽它们。正式环境参数尚未提供，本次没有部署、修改平台路由、数据库迁移、重启或新增取数。

启动对照

沿用部署说明的登录、数据库、OSS和HTTPS配置，为Web添加以下三个参数：

--ohip-hotel-id <平台实际返回的正式酒店ID>
--ohip-credential-file <容器或主机内的正式凭据文件绝对路径>
--ohip-state-root <仓库外的私有持久目录绝对路径>

三个参数必须一起提供，并保留--enable-processing。Compose部署需同时更新Web的command与凭据/状态目录挂载；仅在环境文件填写变量不会被当前启动器自动读取。新正式环境使用新任务目录，不能复制沙箱队列、原数据或未完成任务；目录绑定酒店、平台、应用及处理规则。

月报另按部署说明运行python -m monthly_reports.worker --output-root /app/outputs/monthly_reports并配置持续监管。 --enable-monthly-generation是另一个手动生成入口，不替代自动月报worker。

数据库019的升级/回退文件位于database/019_ohip_data_source.sql和对应.down.sql。先检查现有版本、备份和副本验证，再在正式启用窗口升级；已经有JSON来源记录时回退会被保护机制拒绝。

有真实数据后的首日验收

这一步待数据可用并明确开始验收后执行，本次不发起查询：

选一个有到店记录的日期，确认来自正确酒店、范围完整，15字段的空值/缺失/候选状态符合实际。
完成原有处理；若缺价则完成复核，再核对日报记录、金额和原有业务规则。
确认月报自动更新，页面能够下载日报及月报，文件内容和汇总一致。
确认刷新/断线后能恢复原任务，重复继续不会重复入库。

完成这些检查后，才可把状态更新为“生产验收通过”。真实字段缺失、名称多候选、历史换房或生产取数规模可能需要依据实际返回继续适配。

收尾检查与已知验证范围

先前直接处理验收：220项相关检查及5项JS检查，包含独立本机PostgreSQL和模拟页面全流程，详见记录。
最新日期修复：9项JS与27项Python检查、用户原页面实点和用户确认，详见记录。
本次收尾：2项部署入口检查通过，标准启动帮助确认三个OHIP参数可用。
处理器.zip及.skill各8个关键文件与源码逐字节一致，两包SHA-256均为feea915e7db49365f9139af8e236440038fe1d5099faf9c096e9bb3fa0f62436。
本机没有Docker命令，本次未构建或启动生产镜像；正式主机部署验证待执行。
.zip/.skill是处理器包，完整Web交付还包含项目源码、数据库019及运行配置，不能只上传处理器包来启用自动下载。

5.8 KiB Raw Permalink Blame History Unescape Escape