weicw1996
2cd60270b9
hjc 包的进展（按 AGENTS.md 约定，改动集中在 hjc 包内）：
- HjcWechatController 新增三接口：
- GET /api/hjc/wechat/readiness 管理员自检，逐项报告小程序/公众号/支付/serverUrl
是否配好、支付 appId 与小程序 appId 是否一致；?probe=true 实调微信验证 appSecret
（失败只记日志、不抛异常）。appId 与商户号在 detail 里打码，appSecret 永不输出。
- GET /api/hjc/wechat/mp-appid 只回 appId，供 H5 渲染开放标签（不含密钥）。
- POST /api/hjc/wechat/mp-login uni.login 的 code 换小程序 openid/unionid；匿名放行，
租户取 HjcAuthProperties 的配置值而非可伪造的请求头。
配套 HjcWechatReadinessUtil（含单测）与 HjcWechatController 的两套配置读取：
公众号 cache{t}:setting:wx-official、小程序 mp-weixin:{t} → setting:mp-weixin:{t} →
跨库回源 gxwebsoft_core.sys_setting。
- HjcBannerController / Service / ServiceImpl / Mapper(+XML) / HjcBannerVo：只读
GET /api/hjc/banner/list，按租户 + position + 启用状态 + 生效时间窗口过滤 CMS
轮播组并扁平化；租户隔离交给 MyBatis-Plus 租户拦截器，不改 cms 及其他项目代码。
配套 HjcBannerApiTest（最小上下文 MockMvc，含不串租户与位置过滤）。
- 一站式出向推送：CreatePurchaseDetails 补退款字段，HjcOrder 补 refund_time /
refund_reason（配套 hjc_order_add_refund.sql 与 hjc_init.sql），HjcBizServiceImpl
在 REFUNDED 时把退款时间与原因一并推送；配套推送报文单测。
- 共享文件 SecurityConfig.java 仅追加一行：匿名放行 /api/hjc/wechat/mp-login
（注册页证件上传与 OCR 早先已放行）。这是本包唯一改到 common 的地方。
- 文档：CONTEXT.md、docs/一站式平台对接-接口文档.md。
**不含** scripts/hjc_test_push_out.py：该联调探针脚本内含与 HjcOneStopAuthUtil.java
相同的 APP_KEY / PASSWORD 明文，按此前排查记录「不得提交」处理，保留在工作区未跟踪。
44 lines
2.1 KiB
Markdown
44 lines
2.1 KiB
Markdown
# 汇吉采标书购买平台
|
|
|
|
汇吉采标书购买平台是一站式代理平台的交易出口：企业账号在此注册、通过资质审核后购买标书，平台内完成订单与支付，并把购买记录推送回一站式平台。
|
|
|
|
## 核心实体
|
|
|
|
**标书项目 (Bid Project)**:
|
|
一条采购项目，同时也是可购买下载的标书，二者是**同一实体**（甲方确认：一个项目即一本标书）。携带项目编号、名称/分类、招标人、中标公司、中标金额与中标公告信息，以及标书价格（信息服务费）、标书附件、开售/停售时间与售卖方式。
|
|
_Avoid_: 项目(单用), 标书(单用), tender
|
|
|
|
**企业账号 (Enterprise Account)**:
|
|
买家账号，用企业名称+密码登录，须通过资质审核才能购买标书。
|
|
_Avoid_: 用户, 会员, buyer, hjc_user
|
|
|
|
**资质认证 (Qualification)**:
|
|
企业注册后提交、由平台审核的资质材料，状态为 待审核/已通过/已驳回（含驳回原因）。未通过不可下单。
|
|
_Avoid_: 认证
|
|
|
|
**订单 (Order)**:
|
|
企业购买标书的记录，含标书信息/数量/金额/购买企业，需支付后完成。
|
|
_Avoid_: 交易, purchase
|
|
|
|
**信息服务费 (Service Fee)**:
|
|
购买标书支付的金额，即「标书价格」。平台对每一本标书设定。
|
|
_Avoid_: 标书价格, 标书费
|
|
|
|
## 与一站式平台的关系
|
|
|
|
**一站式代理平台 (One-stop Platform)**:
|
|
上游系统，向本平台推送中标公告数据，并接收本平台推送的购买记录/订单落盘。
|
|
_Avoid_: 甲方, 上游
|
|
|
|
**中标公告 (Award Announcement)**:
|
|
项目流程走到「发布中标公告」时由一站式平台推送的公告数据，含招标人/中标公司/中标金额/公告正文/公告附件。
|
|
_Avoid_: 公告, bulletin
|
|
|
|
**售卖方式 (Selling Method)**:
|
|
标书的售卖渠道标识：1 公司财务 / 2 公众号 / 3 交易中心 / 4 政采云。
|
|
_Avoid_: 渠道
|
|
|
|
**推送 (Push)**:
|
|
本平台与一站式平台之间交换数据的动作：接收中标公告（入），并在订单支付成功后推送购买记录（出）。
|
|
_Avoid_: 同步, 对接
|