weicw1996
5b6e1b67bc
- BuyDocument：支付步骤原先把后端 Native 下单返回的 codeUrl（weixin://wxpay/...）当明文 链接渲染成一个 <a target="_blank">，而 weixin:// 在浏览器里点击没有任何有效行为——标题写 着「请使用微信扫码支付」，页面上却没有二维码，PC 端 Native 支付实质不可用。改为渲染真正 的二维码，并删掉那个链接。 - HjcPayQrcode（新）：uqr 站内生成，renderSVG() → data:image/svg+xml → <img :src>。不用 v-html（避开 vue/no-v-html），不用第三方外链（hjc-h5 用的 api.qrserver.com 在境内不可靠， 且等于把支付凭据交给第三方），也不改后端契约。 - useHjcPayStatus（新）：支付结果一律以**微信侧**为准——轮询 pay-status（3s，页面隐藏暂停， 2 小时上限），手动「我已完成支付」按钮也走同一条查单通道。原先只有 mark-paid 一条路，而它 不向微信查单（HjcOrderController 的 javadoc 自陈「订单置为已支付只有 /mark-paid 一条路」）， 用户一分钱不付、点一下就能把订单置为已支付并触发一站式推送。故 hjc-web 弃用它，并删除 server/api/tender/mark-paid.put.ts，不留这个入口给下一个人误用。 - 查单的另一好处：微信已支付而本地仍未支付时它会就地补写状态（幂等）。于是「付了钱但页面被 关掉/断网」这类漏单能被认出来——进入支付步骤即开始轮询，正是为了认出这种订单。 - 拿不到二维码时（例如租户支付配置错误）不再显示空白卡片，而是失败原因 +「重新获取二维码」。 微信 Native 码默认 2 小时且服务端不下发 expireTime，故按发起支付时刻本地计时，过期把二维码 置灰并提示重新获取；「重新获取二维码」重调 /api/tender/pay（同 out_trade_no 的 Native→ Native 重下微信允许）。 - 由此 hjc-web 与 hjc-h5/小程序端的支付确认语义**有意不一致**（那两端仍在用 mark-paid，改动 它们等于同时动三端线上支付路径）。理由与边界记在 ADR 0009。 - 依赖：新增 uqr；两份锁文件同步更新（pnpm 装，package-lock.json 同步）。 - 删除 BUY_TENDER_MAP_REPORT.md：530 行历史快照，结论与现状全面矛盾（称购买流程是桩函数、 /buy 不可用、没有登录流程、pay 代理路径写错），已实际误导过一次调研；历史价值留在 git 里。
通用企业官网程序
基于 Nuxt 4 + Vue 3 + TypeScript 的企业官网纯前端展示系统。
项目定位
- 本项目仅包含官网前台展示代码
- 不含后端管理端，所有数据通过调用 SaaS 后端 API 获取
- 支持多模板切换、多租户、独立域名绑定、订阅过期校验
目录结构
website/
├── app/ # 应用代码
│ ├── components/ # 公共组件
│ ├── composables/ # 组合式函数
│ ├── layouts/ # 布局
│ ├── pages/ # 页面路由
│ ├── templates/ # 模板集合
│ ├── types/ # TS 类型
│ ├── utils/ # 工具函数
│ └── assets/ # 样式资源
├── server/ # Nuxt Server
│ ├── api/ # API 代理
│ ├── middleware/ # 中间件
│ └── utils/ # 服务端工具
├── scripts/ # 脚本
└── templates/cloud-website # 模板预览图
安装依赖
npm install
本地开发
npm run dev
模板系统
模板存放在 app/templates/ 目录下，每个模板独立目录，包含：
config.ts：模板配置components/：模板私有组件（Header、Footer 等）pages/：模板页面组件theme.css：模板主题变量
当前已实现：
template-01：科技蓝企业模板（完整）template-02~template-04：占位模板，后续根据设计稿实现
环境变量
复制 .env.example 为 .env，按需修改：
NUXT_PUBLIC_TENANT_ID=10398
NUXT_PUBLIC_APP_ID=website
NUXT_PUBLIC_TEMPLATE_ID=template-01
NUXT_PUBLIC_SERVER_API_BASE=https://server.websoft.top/api
NUXT_PUBLIC_MODULES_API_BASE=https://cms-api.websoft.top/api
NUXT_PUBLIC_APP_API_BASE=https://cms-api.websoft.top
NUXT_PUBLIC_BASE_DOMAIN=shoplnk.cn
接口说明
本项目通过 server/api/ 代理转发 SaaS 后端接口，前端不直接调用后端地址。
核心接口：
GET /api/site/info：站点信息GET /api/page/all：页面列表GET /api/page/detail?slug=xxx：页面详情GET /api/article/list：文章列表GET /api/product/list：产品列表GET /api/case/list：案例列表GET /api/subscription/status：订阅状态GET /api/sitemap.xml：动态站点地图GET /api/robots.txt：robots 文件POST /api/form/submit：表单提交
部署
npm run build
npm run preview
生产环境建议使用 Nginx 反向代理，配置泛域名 *.shoplnk.cn 指向 Nuxt 服务。
注意事项
- 模板组件为动态导入，新增模板后需在
app/templates/index.ts注册 - 域名绑定查询接口
/cms/cms-website/resolveDomain需 SaaS 后端实现 - 订阅状态接口
/api/app/subscription/check需 SaaS 后端实现