排版语言 - 引入独立视觉系统 .vitepress/theme/styles/portal.css: 中性底色 + 单一强调色(#4f46e5),正文靠留白与层级取胜, 不使用大面积彩色底、渐变铺满或装饰性图形 - CSS 变量定义在 :root(原先挂在 .portal 下,导致内容页拿不到值) - 完整支持暗色模式,变量在 html.dark 下整体替换 首页(pages/index.md → HomePage.vue) - hero:居中大标题(强调色渐变仅作用于一个词组)、双按钮、四格数据条 - 项目区:三栏卡片,标题 + 状态徽标 + 定位 + 说明 + 技术栈标签 - 通用能力:六格编号卡片 - 组合方式:三栏场景步骤卡,每张带一条可复制命令 - 底部 CTA 区块 - 页面改用 layout: page,通过 Layout 包装层去掉默认窄栏 项目详情页 - iotLCM / DTU:能力矩阵改为标签切换(CapabilityTabs), 每个业务域一屏,点击切换,替代原先的大宽表 - XiuAdmin:22 项内置功能按用途归为四组标签墙(FeatureGrid) - 内容页二级标题加短强调线,表格首列不换行,属性表不再竖排 数据 - 新增 data/content.ts 承载首页文案、能力分组、长期事实统计, 与 projects.ts 并列;文案口径取自各项目 README/详情页,无凭空数字 - 修正 scripts/check-registry.mjs:原先扫描 data/ 下所有 .ts 的 id, 新增 content.ts 后把业务分组 id 误判为项目;改为只读 projects.ts 验证 - 构建通过,12 个页面,193 条引用 0 失效 - HTTP 实测 12 个路径全 200,不存在路径 404 - 暗色模式与移动端(390px)已截图核对,无横向溢出
This commit is contained in:
+172
@@ -0,0 +1,172 @@
|
||||
/**
|
||||
* 门户首页的内容数据 —— 与 data/projects.ts 并列,只放首页排版需要的文案。
|
||||
*
|
||||
* 口径约束:这里的每一条都取自各项目的 README / 详情页,不写没有依据的数字。
|
||||
* 需要新增能力时,先在对应项目仓核实,再补到这里。
|
||||
*/
|
||||
|
||||
export interface Stat {
|
||||
num: string
|
||||
unit?: string
|
||||
label: string
|
||||
}
|
||||
|
||||
/** 首页数据条。只列可从仓库直接核对的事实。 */
|
||||
export const stats: Stat[] = [
|
||||
{ num: '3', label: '开源项目' },
|
||||
{ num: '3', label: '运营商协议直连' },
|
||||
{ num: '22', unit: '+', label: 'XiuAdmin 内置模块' },
|
||||
{ num: '100', unit: '%', label: 'Apache-2.0 许可' },
|
||||
]
|
||||
|
||||
export interface Capability {
|
||||
title: string
|
||||
text: string
|
||||
}
|
||||
|
||||
/** 通用能力底座 —— 三个项目共享的工程特征 */
|
||||
export const foundations: Capability[] = [
|
||||
{
|
||||
title: '单仓多服务',
|
||||
text: '后端服务、前端应用、文档站与部署编排收在同一个仓库,一次 clone 拿到全部内容。',
|
||||
},
|
||||
{
|
||||
title: '一条命令起',
|
||||
text: 'Docker Compose 编排齐备,首次启动自动建库建表与种子数据,不需要本地编译。',
|
||||
},
|
||||
{
|
||||
title: '接口开放',
|
||||
text: '对外接口有独立的版本化合同与鉴权方式,可被自有系统或三方平台直接调用。',
|
||||
},
|
||||
{
|
||||
title: '权限与审计',
|
||||
text: '多租户、角色、菜单按钮权限与数据范围划分,关键操作留痕可追溯。',
|
||||
},
|
||||
{
|
||||
title: '离线可部署',
|
||||
text: '镜像可导出为归档文件带入内网,无外网环境同样可以完成安装与升级。',
|
||||
},
|
||||
{
|
||||
title: '文档随仓发布',
|
||||
text: '使用手册、部署手册与接口合同与代码同仓维护,版本不会脱节。',
|
||||
},
|
||||
]
|
||||
|
||||
/** iotLCM 的能力分组,按业务域拆 */
|
||||
export interface CapGroup {
|
||||
id: string
|
||||
name: string
|
||||
intro: string
|
||||
items: Capability[]
|
||||
}
|
||||
|
||||
export const iotlcmGroups: CapGroup[] = [
|
||||
{
|
||||
id: 'card',
|
||||
name: '卡与库存',
|
||||
intro: '从运营商渠道入库开始,一路管到销户,卡片状态与位置始终可查。',
|
||||
items: [
|
||||
{ title: '卡信息管理', text: '单卡详情、按三码检索、状态与用量快照,支持批量导入建立卡档案。' },
|
||||
{ title: '三级库存流转', text: '入库、在库、出库全程留痕,按批次追溯每一张卡的来源与去向。' },
|
||||
{ title: '批量开停复机', text: '按批次下发至运营商,执行结果自动回写,失败项可单独重试。' },
|
||||
{ title: '续费与变更套餐', text: '单卡与批量受理并行,支持指定生效时间与到期处理策略。' },
|
||||
{ title: '达量断网', text: '按用量阈值自动停机,阈值可批量设置,避免超量产生额外费用。' },
|
||||
{ title: '智能诊断', text: '结合卡状态、通道与用量给出诊断结论与处置建议,缩短排障时间。' },
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'channel',
|
||||
name: '通道与上游',
|
||||
intro: '把不同运营商的接口差异收敛到一层,上层业务不用关心底层协议。',
|
||||
items: [
|
||||
{ title: '三大运营商直连', text: '中国移动 OneLink、中国电信 5G CMP、中国联通 10646 协议适配内置。' },
|
||||
{ title: '通道与接入模板', text: '按运营商维护通道,接入参数模板化,新增通道不改业务代码。' },
|
||||
{ title: '共享 Token 接入', text: '三方渠道商以共享 Token 模式接入,配合白名单转发控制调用范围。' },
|
||||
{ title: '通道缓存转发', text: '独立转发层隔离上游抖动,上游异常不影响管理端可用性。' },
|
||||
{ title: '凭据与配额管理', text: '上游凭据集中维护,调用量与配额可观测,异常调用及时告警。' },
|
||||
{ title: '执行日志', text: '每次上游调用的请求与响应留存,问题定位有据可依。' },
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'billing',
|
||||
name: '资费与计费',
|
||||
intro: '套餐、流量池与定价分离建模,同一张卡可以按不同口径结算。',
|
||||
items: [
|
||||
{ title: '套餐配置', text: '套餐与流量池定义,支持多层套餐结构与绑定关系。' },
|
||||
{ title: '定价规则', text: '面向代理商与终端客户的定价分开维护,支持差异化报价。' },
|
||||
{ title: '生效与到期', text: '套餐生效、到期、续期的处理策略可配置,避免人工干预。' },
|
||||
{ title: '用量查询', text: '实时用量与月累计分开统计,支持历史账期回溯。' },
|
||||
{ title: '时序数据留存', text: '流量与状态按账期落入时序库,长期趋势分析不失真。' },
|
||||
{ title: '分佣与结算', text: '代理商分佣规则配置,划拨与回收动作与结算口径对齐。' },
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'org',
|
||||
name: '组织与账号',
|
||||
intro: '多租户下的企业、账号与权限治理,对外凭证与对内角色分开管理。',
|
||||
items: [
|
||||
{ title: '企业与用户', text: '多级组织结构,企业下挂用户,数据按组织隔离。' },
|
||||
{ title: '角色与权限', text: '按角色分配菜单与操作权限,按钮级权限可粒度控制。' },
|
||||
{ title: '代理商体系', text: '代理商分级管理,设备与卡片划拨、回收动作全程留痕。' },
|
||||
{ title: 'API 凭证', text: '对外调用凭证的签发、吊销与使用记录,异常调用可即时阻断。' },
|
||||
{ title: '操作审计', text: '关键操作留痕,可按时段、操作人、对象多维检索。' },
|
||||
{ title: '工单流转', text: '内部与客户侧工单流转,处理时效与责任人可追踪。' },
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'delivery',
|
||||
name: '对外交付',
|
||||
intro: '把平台能力以接口形式交付出去,自有系统与三方平台都能接。',
|
||||
items: [
|
||||
{ title: 'V3 版本化接口', text: '接口按版本演进,升级不破坏既有调用方。' },
|
||||
{ title: '旧版兼容接口', text: '历史接口保持兼容,存量系统无需改造即可迁移。' },
|
||||
{ title: '运营商能力代理', text: '白名单转发与共享 Token 两种模式,按需开放上游能力。' },
|
||||
{ title: 'Web 管理端', text: '完整的后台界面,覆盖卡管理、资费、组织、运维全场景。' },
|
||||
{ title: '小程序 / H5', text: '面向终端用户的移动端,支持查卡、办理与自助服务。' },
|
||||
{ title: '接口文档', text: '接口合同与示例随文档站发布,接入方可以自助完成联调。' },
|
||||
],
|
||||
},
|
||||
]
|
||||
|
||||
/** XiuAdmin 内置模块(取自项目详情页的 22 项,归并为可读分组) */
|
||||
export interface AdminGroup {
|
||||
name: string
|
||||
items: string[]
|
||||
}
|
||||
|
||||
export const adminGroups: AdminGroup[] = [
|
||||
{ name: '租户与组织', items: ['租户管理', '租户套餐', '客户端管理', '部门管理', '岗位管理'] },
|
||||
{ name: '账号与权限', items: ['用户管理', '角色管理', '菜单管理', '在线用户'] },
|
||||
{ name: '开发效率', items: ['代码生成', '定时任务', '消息队列', '字典管理'] },
|
||||
{ name: '配置与运维', items: ['配置管理', '服务监控', '缓存监控', '操作日志', '登录日志', '服务日志'] },
|
||||
]
|
||||
|
||||
/** DTU 的能力分组 */
|
||||
export const dtuGroups: CapGroup[] = [
|
||||
{
|
||||
id: 'produce',
|
||||
name: '生产与研发',
|
||||
intro: '从产品定义到固件版本,设备出厂前的每个环节都在系统里。',
|
||||
items: [
|
||||
{ title: '产品与型号', text: '产品定义、硬件型号与工厂信息维护,生产批次可追溯。' },
|
||||
{ title: '设备生产', text: '批量生产导入导出,设备序列号与产品型号绑定。' },
|
||||
{ title: '固件管理', text: '固件版本登记与发布,支持按型号推送不同版本。' },
|
||||
{ title: 'OTA 升级', text: '升级任务分批下发,进度与结果可查,失败设备可重试。' },
|
||||
{ title: '配置中心', text: '产品通用模型、配置分组与版本,下发状态逐台可见。' },
|
||||
{ title: '指令下发', text: 'HTTP / TCP 双通道接入,指令下发与回执确认。' },
|
||||
],
|
||||
},
|
||||
{
|
||||
id: 'channel',
|
||||
name: '代理与客户',
|
||||
intro: '设备划拨链路透明,代理商与终端客户的归属关系清晰。',
|
||||
items: [
|
||||
{ title: '代理商管理', text: '多级代理结构,下级代理与设备列表分开维护。' },
|
||||
{ title: '设备划拨', text: '划拨与回收动作留痕,历史记录可回溯到具体批次。' },
|
||||
{ title: '终端绑定', text: '终端客户扫码绑定设备,一机一码防止串货。' },
|
||||
{ title: '我的订单', text: '代理商自助查看订单与设备状态,减少人工对接。' },
|
||||
{ title: '运行监控', text: '设备在线状态、信号与事件上报集中呈现。' },
|
||||
{ title: '联调工具', text: '仓库自带设备联调与压测脚本,新设备接入可先本地验证。' },
|
||||
],
|
||||
},
|
||||
]
|
||||
Reference in New Issue
Block a user