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 明文,按此前排查记录「不得提交」处理,保留在工作区未跟踪。
2.1 KiB
汇吉采标书购买平台
汇吉采标书购买平台是一站式代理平台的交易出口:企业账号在此注册、通过资质审核后购买标书,平台内完成订单与支付,并把购买记录推送回一站式平台。
核心实体
标书项目 (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: 同步, 对接