Files
website/pages/projects/xiu-admin/index.md
T
Dai0814 ac1354da9e
mirror-to-gitee / mirror (push) Successful in 5s
style(portal): 重做整站排版,改为落地页式布局
排版语言
- 引入独立视觉系统 .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)已截图核对,无横向溢出
2026-11-04 14:13:50 +08:00

48 lines
1.5 KiB
Markdown

---
title: XiuAdmin
description: 基于 GoFrame2 + Vue3 的全栖中后台框架
outline: deep
---
# XiuAdmin
基于全新 GoFrame2 + Vue3 + VueVbenAdmin 开发的全栖框架,适合大型中后台完整应用开发。
| 项 | 值 |
| --- | --- |
| 代码仓 | <https://gitee.com/snowgoat/xiu-admin> |
| 许可证 | Apache-2.0 |
| 状态 | 已发布 |
| 技术栈 | GoFrame v2、Vue 3、Vue Vben Admin、Ant Design Vue、asynq |
## 框架特征
- 高生产率:极强的可扩展性,应用化、模块化、插件化机制敏捷开发,几分钟即可搭建一个应用开发框架
- 快速生成代码:无需编写代码,只需创建表进行简单配置就能生成完善的 CURD、树表等常用开发代码,所需表单控件也是勾选即可直接生成
- 认证机制:采用 JWT 的用户状态认证
- 路由模式:得益于 GoFrame 提供了规范化的路由注册方式,无需注解自动生成 api 文档
- 模块化设计,面向接口开发
## 内置功能
22 项功能开箱可用,按用途归为四组。每项都不需要自己实现,装上就能用。
<FeatureGrid />
## 目录结构
```text
xiu-admin/
├── server/ # GoFrame 后端服务
├── vue/ # 前端 pnpm monorepo
├── docs/ # 文档与演示图例
├── build/ # 构建脚本
└── deploy/ # 部署配置
```
## 参与贡献
1. Fork 代码仓并创建特性分支
2. 提交前确保 `go build ./...` 与 `pnpm build` 通过
3. 提交 Pull Request 并说明变更动机