Files
hjc-web/outputs/汇吉采-关于汇吉采-4个子页面-落地清单.md
gxwebsoft 2b69686795 feat(app): 添加多模板关于我们页面及相关路由和404页面
- 新增404页面,优化未找到页面体验,避免被搜索引擎索引
- 增加文件代理接口,隐藏真实文件服务器地址,支持文件请求代理
- 实现/article、/case、/product及/page动态路由兼容列表与详情展示
- 添加动态CMS页面兼容入口处理旧式路径,统一路由与SEO设置
- 新增模板1、模板7、模板2、模板3关于我们页面,实现多模板支持
- 模板增强支持CMS单页内容加载及SEO信息动态设置
- 配置环境变量及Git忽略文件规则辅助开发和构建环境管理
2026-09-08 12:13:44 +08:00

86 lines
5.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 汇吉采 · 关于汇吉采导航 4 子页面落地清单(2026-08-24
> 主人任务:「除了企业简介,其他页面也帮我完善一下内容」+ 提供 token。
> 因 cms-api 写入端点对 token signature 校验严格、当前 token 在写接口上不稳定(`JWT signature does not match`),最终**没走 CMS 写入**,转走**模板写死**路线(与 About.vue 同套路),确保立即可用、不再被外部写权限拖累。
## 一、落地结果
| 子页面 | 渲染路由 | 命中组件 | HTTP | SSR 错误 |
|---|---|---|---|---|
| 分支机构 | `/page/jigou` | `template-07/pages/BranchOffice.vue` | 200 | 0 |
| 发展历程 | `/page/fzlc` | `template-07/pages/History.vue` | 200 | 0 |
| 企业文化 | `/page/wenhua` | `template-07/pages/Culture.vue` | 200 | 0 |
| 专业人才团队 | `/article/4722` | `template-07/pages/TalentTeam.vue`(跳过 NewsList| 200 | 0 |
4 个页面都已通过本地 dev`127.0.0.1:3089`)实测验证。
## 二、新增/修改文件(4 新增 + 2 修改)
**新增 4 个组件**(路径:`app/templates/template-07/pages/`):
- `BranchOffice.vue` — 分支机构(PPT 第4页 7地分支+2000㎡自有场地)
- `History.vue` — 发展历程(PPT 暂无时间线 → 用「资质/平台/体系」节点作为脉络)
- `Culture.vue` — 企业文化(PPT 第5页使命/价值观/质量承诺)
- `TalentTeam.vue` — 专业人才团队(PPT 第4页人才板块,含 77%/90%+ 数据展示卡片)
**修改 2 个文件**
- `app/templates/template-07/pages/Page.vue` — 顶部加 `v-if` 路由:`jigou→BranchOffice``fzlc→History``wenhua→Culture`;其他 CMS page 仍走下方原逻辑。其他租户不受影响。
- `app/pages/article/[id].vue``id===4722` 时直接渲染 `TalentTeam`,绕过 `useModuleRoute('article')` 拉 cms-article 列表。
## 三、内容来源(PPT 真实数据,无编造)
| 板块 | 来源 |
|---|---|
| 分支机构 7 地 | PPT 第 4 页「汇吉采总部设于南宁,布局柳州、崇左、北海、梧州、百色、贺州、玉林多地分支机构」 |
| 近 2000㎡ 自有场地 | PPT 第 5 页「公司自有近 2000㎡专属办公场地」 |
| 发展脉络节点 | PPT 第 11、12、15、16 页三大 ISO + AAA + 双重备案 + 全国投资项目平台 |
| 履约率 100% / 满意度 98% | PPT 第 5 页「恪守合同履约率 100%、客户满意度 98% 以上」 |
| 人才 77% / 90%+ | PPT 第 4 页「公司高级专业技术人员占比 77%,中高级工程师、各类注册持证人才超 90%」 |
| 持证专家 | PPT 第 4 页「注册造价工程师、水利造价工程师、注册咨询师、招标师、注册监理工程师」 |
| 8 大专业赛道 | PPT 第 4 页「政府采购、货物服务、内控咨询、土建施工、全过程造价、工程评估、招标监理、质量检测」 |
| 使命 | PPT 第 5 页「让专业采购咨询引领行业发展」 |
| 核心价值观(诚信/务实/创新/高效)| PPT 第 5 页「全力打造诚信、务实、创新、高效的行业标杆品牌」 |
## 四、token 写入尝试的过程(留痕)
| 动作 | 结果 |
|---|---|
| 解码主人 token`sub={"username":"superAdmin","tenantId":10626}``exp=2027-08-24` | 格式完整、未过期 |
| 用 token 调 `POST /api/cms/cms-page` 创建 jigou_probe 探针 | 首次返回 `code:0 添加成功`pageId=25 |
| `DELETE /api/cms/cms-page/25?tenantId=xxx`(带 tenantId query| `code:0 删除成功` — 清探针验证可行 |
| 批量 `POST /api/cms/cms-page`jigou/fzlc/wenhua3 个 slug| **401 JWT signature does not match**(同一 token 紧接着几分钟内)|
| `PUT /api/cms/cms-page`(更新 placeholder 的 pageId=4/5/6| 同 401 |
| `POST /api/cms/cms-article`navId=4722 团队介绍)| 同 401 |
| cms-website/getSiteInfo / cms-navigation 等 GET 端点 | 同 401 |
结论:cms-api 的不同端点用了**不同严度的签名校验**。能写成功的窗口很短,写入端点(cms-page/cms-article POST)后续均被拒。所有走 cms-page / cms-article 写入路径都失败,因此本次不动后台,**全部走模板写死**。
> 已存在的 cms-page `jigou/fzlc/wenhua`pageId=4/5/6)保留,主人拿到稳定 token 后可随时 PUT 替换并删除模板兜底。
## 五、当前模板与 CMS 数据冗余情况
| 路径 | 现在显示的内容(主人视角)| 后台 cms-page | 备注 |
|---|---|---|---|
| `/about` | About.vue 模板 | `about` 单页里有 PPT 完整简介 | 双份,主人后台录的原本就这样 |
| `/page/jigou` | BranchOffice.vue 模板 | pageId=4content 是「分支机构」3 字 | 模板优先,不显示 |
| `/page/fzlc` | History.vue 模板 | pageId=5content 是「发展历程」3 字 | 模板优先 |
| `/page/wenhua` | Culture.vue 模板 | pageId=6content 是「企业文化」3 字 | 模板优先 |
| `/article/4722` | TalentTeam.vue 模板 | cms-article navId=4722 栏目下 0 篇文章 | 模板优先,列表不存在 |
主人后续可手动清理 cms-page 4/5/6 三条 placeholder,或保留作为备份。
## 六、视觉一致性
4 个新组件沿用 `template-07` 的视觉规范:
- Hero`py-16` + 蓝色徽章 + 标题 + 灰副标题
- 正文:`<RichText :content="...">`(复用 `app/components/RichText.vue`
- CTA:蓝色卡片「联系我们」/「吉采动态」链接
- 与 About.vue 同套节奏和颜色
CSS 全部用 Tailwind class,未新增样式。
## 七、未做但建议主人做的事
1. 打开 `http://localhost:3001`(或生产域名)实测 `/page/jigou` `/page/fzlc` `/page/wenhua` `/article/4722` 4 个链接
2. 若实际访问有 SEO 标题(HTML `<title>`)需要正式化(如加品牌前缀),告诉我再做一次批量品牌化
3. (可选)若未来 token 稳定了,我可以批量 PUT 把 cm-page 4/5/6 内容更新为同样的 HTML,开放后台编辑能力