9.0 KiB

Raw Blame History

AutoRpa

洁达 RPA。当前主线是订单中心入站（rpa_oms）和选品班次（rpa_selection/）：收件落 Oracle，请求里不跑选品；选品作业另起进程捞 deal_flag=0。合同页面在 rpa_contract/；加购 rpa_cart/、返利 rpa_rebate/ 仍是占位。根上不再有 选品流程/、state_center/、rpa_yisaiqi/。

智力用在定落点、想清楚对错；速度和 token 靠下面这张地图定点打开，禁止用扫仓代替思考。改对应了，反工和消耗都会少。

怎么干活

先定落点（不开文件）：哪个函数、成功长什么样（哪条 ACCEPT / 哪个点名用例）、这次不碰什么。方向说不清就先问，不要靠翻目录找感觉。
只在落点上想透：规则、边界、会不会拿错号/写错状态。打开文件是为了验证落点，不是再想要不要改别处。
薄验收就停：控制台 ACCEPT SUMMARY 或一条点名用例。过了收工。

问「法子 / 怎么优化」先答方案；用户说「改 / 重构 / 收口」再动代码。一件事一个会话，换任务 /new。

项目地图

按问题打开一行，不要 list_dir 根目录。

问题	打开	验收
接口1 收件契约	`rpa_oms/app/inbound/sales_goods.py`、`envelope.py`	`rpa_oms/tests/test_sales_goods_receive.py::点名`
接口1 Oracle 落表	`rpa_oms/app/inbound/oracle_repo.py`	`rpa_oms/tests/test_oracle_repo.py::点名`
接口1 入口 / 鉴权	`rpa_oms/app/main.py`、`auth.py`	同上；真库见 `rpa_oms/README.md` Windows 段
选品规则 / 拆量	`rpa_selection/rules.py`、`pipeline.py`	`rpa_selection/tests/test_pipeline.py::test_split_across_malls_is_success`
选品班次落表	`rpa_selection/job.py`、`persist.py`、`repo.py`	`rpa_selection/tests/test_job.py::test_job_searches_barcode_not_approval_no`
合同页面步骤	`rpa_contract/contract_flow_steps.py` 里对应函数	`ACCEPT SUMMARY` 或 `rpa_contract/screenshots/` 下 `ACCEPT.txt`
合同入参 / 客商草稿	`rpa_contract/contract_draft.py`	`rpa_contract` 点名用例
节点入口	`rpa_contract/contract_create_node.py`、`main.py`	读到正式合同号
浏览器适配	`rpa_contract/apa_browser_adapter.py`	`rpa_contract/tests/test_apa_browser_adapter.py::点名`
文字验收 / 截图策略	`rpa_contract/accept.py`	只读 `ACCEPT.txt`，禁止读 png
加购 / 支付回传	`rpa_cart/README.md`	加购未做；1 号药城支付按 Excel 落表，不对加购行
返利班	`rpa_rebate/README.md`	占位，未实现
四个口地图	`rpa_oms/README.md`、根 `README.md`	—
节点业务规则（点名一节）	`docs/RPA订单中心接口开发口径_20260930.md`	禁止通读 `docs/`

禁止打开：node_modules/、chrome-profile/、任何 png。Chrome 用户目录只在仓库外 D:\work\rpa-chrome-profile。Oracle 密码放本机 rpa_oms/.env（选品空缺时复用）；商城账号放 rpa_selection/.env。都已 gitignore，不要写进仓库、README、示例 JSON，不要 git add / commit / push。

接口1 落点（订单中心）

订单中心四接口，本期只开放接口 1：销售商品对码数据接收。POST /api/oms/v1/sales-goods，鉴权 header X-Oms-Token（OMS_INBOUND_TOKEN）。落表 rpa_sales_goods_mapping_data，deal_flag=0，等选品作业捞；请求里不跑选品。

运行时只落 Oracle。单测用内存替身，不连库。服务端口 8001。

步	函数	要点
信封	`parse_envelope`	缺 `data` / 空数组 / 超过 100 条：整包 422，一条都不落
逐条校验	`receive_sales_goods`	入参 camelCase，落表 snake_case；长度跟 VARCHAR2
鉴权	`token_ok`	未配 token 一律失败
落表	`OracleSalesGoodsRepo.insert`	`fid` 由序列触发器生成，INSERT 不绑这一列
幂等	同 `omsId`	已存在 → `DUPLICATE`，不更新、不重跑
同批冲突	同一 POST 里 `omsId` 再现	后一条 `CONFLICT`，只落第一条
字段不过	`_parse_row`	`REJECTED`，不入库
混批	`post_sales_goods`	逐条有成功/重复/拒绝时 HTTP 仍 200，看 `results[].resultCode`

omsId / saleQty / planPurchaseQty 必须是 JSON 整数，不把 "10" 当 10。Windows 连真库测；Instant Client 位数与 Python 一致。

验收（内存、不连库）：cd rpa_oms → uv run pytest tests/test_sales_goods_receive.py::点名 -q。真库：GET /health 后把 examples/sales_goods_batch.json POST 两次（第一次两条 ACCEPTED，第二次两条 DUPLICATE）。

修接口1不要顺手改 rpa_selection/、rpa_cart/、rpa_contract/、rpa_rebate/。接口 2–4 未开放，不要先写。

选品落点

班次作业在 rpa_selection/，不在接口 1 请求里跑。从表 1 领 deal_flag=0，按条形码搜 1 号药城 / 药帮忙，两平台合并后按四级仓序贪心拆量，写入表 2。凑齐才落成功行；凑不齐不落部分成功。

口径：docs/superpowers/specs/2026-10-02-selection-split-allocation-design.md。

步	函数	要点
领取	`claim_pending`	`deal_flag` 0→3；中途崩溃停在 3，改回 0 再跑
规则	`allocate` / `run_selection`	自营仓全称匹配、毛利 ≥ 4%、效期 ≥ 12 月；同仓只留低价；按仓序拆量
落表	`build_result` + `save_result`	成功每仓一行 `status=1`，合计=计划量；`push_status=0`
库存不足	`KIND_BUSINESS_FAIL`	两边都搜到但合计不够：`deal_flag=2`，该 `omsId` 不重跑
对端故障	`KIND_SYSTEM_FAIL`	一边故障且剩下的凑不齐：可把 `deal_flag` 改回 0；禁止写成库存不足

湖南壹号、甘肃壹号云不在自营集合。不加购，不推接口 2。

验收：cd rpa_selection → uv run pytest tests/test_pipeline.py::test_split_across_malls_is_success -q（杭州 3 + 广东 7 = 计划 10）。

CONTRACT_CREATE 落点

页面脚本在 rpa_contract/。run_contract_create_flow 串起来；修一步只打开对应函数。从表 3 合单、写表 4 尚未接。

步	函数	要点
S02 打开	`open_contract_system`	`http://contract-test.gzmpc.com:8080/`
S03 登录	`login_contract_system`	`test002` / `1`
S04–S05 起草	`enter_contract_create`、`select_contract_template`	直达 `FORM_PAGE_URL`，不要点 SPA 菜单
S06 签约方	`fill_contract_signatory_info`	客商 `DW0100046361` / `重庆亿昊药业有限公司`
S07 基础	`fill_contract_basic_info`	标题 `_expected_title`
S08 金额日期	`fill_contract_amount_and_dates`	签约日=订单日
S09 货品	`fill_contract_goods_lines`	弹窗按操作码搜
S10 付款	`fill_contract_payment_info`
S11 PDF	`upload_contract_document_if_needed`	仅 YYC 传合并 PDF
S12 提交	`submit_contract_for_approval`	成功后不要等详情页
S13 合同号	`read_contract_number`	回「我的合同」，`fdId` > 标题+客户编码；禁止盲取最新一条

成功路径默认不截图（RPA_SCREENSHOT=always 才全截）。页面等待用 wait_for_text / wait_for_element，不要固定长睡。

返利中心及之后

rpa_rebate/ 仍是占位。合同审批通过后才进这一段。三把钥匙：contractSystemNo → rebateOrderNo → receiptNoticeNo。开做时按合同同款：一个节点一份 *_flow_steps.py，验收只看 ACCEPT / 点名用例。

节点	谁做	要回传	页面要做什么（尚未拆函数）
`REBATE_HEADER`	RPA	`rebateOrderNo`	登录返利中心 → 按合同编号查总单 → 填必填 → 保存拿总单号
`REBATE_IMPORT`	RPA	成功/失败行	下模板 → 按字段填 Excel → 上传 → 读导入结果
`REBATE_SUBMIT`	RPA	`submitted`	点提交送审
`M5_CREATE_ORDER`	RPA 桌面端	`m5OrderNo`	录单后停、不保存。`M5_QC_MISSING` 必须识别准（直接转人工、不重试）
`M5_MANUAL_CONFIRM`	采购	—	人在 M5 里保存签订
`M5_RECEIPT_NOTICE`	采购	`receiptNoticeNo`	人填收货通知单号，全链终点钥匙

不要连续轮询审批；返利段开始前大约 30 分钟查一次。

验收

接口1：点名 rpa_oms/tests/test_sales_goods_receive.py 或 test_oracle_repo.py；禁止为「显得全面」跑整包再去连真库。
选品：点名 rpa_selection/tests/test_pipeline.py::test_split_across_malls_is_success 或 test_rules.py::test_margin_exactly_4_percent_passes。
合同页：只读控制台 ACCEPT 或 rpa_contract/screenshots/ 下 ACCEPT.txt。
单测只跑点名用例。禁止跑整份带页面等待的套件当回归。

不要

不要扫根目录，不要通读 docs/。需要背景就点名打开一节。
不要把 Oracle 密码写进仓库、README、示例 JSON。
不要在接口1 请求路径里跑选品。
不要为「显得全面」多开文件、重跑、看图。落点外的改动会制造反工。

9.0 KiB Raw Blame History Unescape Escape