运行的本地官网项目。使用类似fumamxCRM 项目的技术栈,重写官网。
https://niaodaifu.cn/
你再阅读一下目录下的文件: 企业官网 CMS 系统需求规格说明书.md 这个文件是别的AI写的一个官网需求,肯定有不合理的地方,你也了解一下,作为我们的技术文档的参考。你了解了现有的代码,及这个基本的需求说明书之后,可以在项目目录下创建一个docs目录,编写你的设计文档,实现步骤和计划。
**我们先把前后端的架构先建立起来,一步步实施每一个模块。做完一个模块,测试一个模块,保证每一步的实现都能使用。**
**我们的第一步是实现首页,及对应的首页内容的后台管理功能**
**我让你开始写代码,你才开始。**
### 以下是针对你的问题的答复:
1. **后端数据**:是否需要将外部 API 数据迁移到本地 SQLite 数据库?还是继续调用外部 API?
Answer: 这个最后再做。我们一步步来。
2. **页面范围**:是否需要重写全部 22 个页面?还是优先核心页面(首页 + 产品介绍)?
Answer: 我们一步步实现。第一步,做首页。
3. **设计**:是否需要重新设计 UI,还是保持现有视觉风格?
Answer:可以使用新粗野风格。但是会使用现在的文章内容,和图片。
4. **静态资源**:图片资源(约 400+ 张)是继续使用现有路径,还是迁移到新项目?
Answer:现有的图片,需要用到的才导入。
---
设计文档已全部创建完成。让我给你总结一下:
---
## 📁 创建的设计文档
| 文档 | 说明 |
|------|------|
| `docs/ARCHITECTURE.md` | 系统架构设计、技术栈、目录结构、部署方案 |
| `docs/DATABASE.md` | 数据库表设计(admins/home_modules/nav_menus/settings) |
| `docs/API.md` | RESTful API 接口规范(认证/首页模块/导航/设置) |
| `docs/FRONTEND.md` | 前端组件设计、新粗野主义样式规范 |
| `docs/ROADMAP.md` | 分阶段实现路线图 |
---
## 🗺️ 实现路线图概览
```
第一阶段:基础架构搭建
├── 后端:FastAPI + SQLite 基础配置
└── 前端:React + Vite + TailwindCSS 项目初始化
第二阶段:数据模型与认证
├── 数据库模型创建
├── JWT 认证接口
└── 后台登录页面
第三阶段:首页模块管理 ⭐ 核心
├── 首页模块 CRUD API
├── 后台模块管理(列表/排序/编辑)
├── 前台模块组件(轮播图/优势/新闻等)
└── 首页页面组装
第四阶段:导航与布局
├── 导航菜单管理
├── Navbar 组件
└── Footer 组件
第五阶段:系统设置
├── 设置管理
└── 文件上传
```
---
## 🎨 关键设计决策
1. **模块化首页**:每个区块是一个独立的 `home_module`,支持拖拽排序、启用/禁用、自定义样式
2. **新粗野主义风格**:
- 背景:`#FEF9E7` 奶油色
- 边框:2px 纯黑硬边框
- 阴影:4px 偏移硬阴影
- 交互:点击位移 + 阴影消失
3. **数据复用**:保留原有网站的文字内容和图片,按需导入
---
**设计文档已准备就绪。请确认后,我将开始第一阶段:基础架构搭建。**
---
## 老项目分析总结
### 当前技术栈
| 层级 | 技术 |
|------|------|
| **前端** | Vue 3 + Vite 5 + Element Plus + Vant + Swiper |
| **后端** | 外部 API (`https://niao.niaodaifu.cn`) |
| **部署** | 纯静态前端 |
### 网站内容结构
**品牌**:飞点健康(尿大夫、吾大夫、吴试纸)- 手机尿检健康服务平台
**主要页面**(22个路由):
| 页面 | 说明 |
|------|------|
| `/` | 首页 - Banner轮播 + 新闻动态 |
| `/product/wudaifu` | 吾大夫产品介绍 |
| `/product/wushizhi` | 吴试纸产品介绍 |
| `/product/niaojianyun` | 尿检云产品介绍 |
| `/product/project-fourteen` | 尿14试纸 |
| `/health-information` | 健康资讯列表 |
| `/news-information` | 新闻动态列表 |
| `/about-us` | 关于我们 |
| `/join-us` | 加入我们 |
| `/business-cooperation` | 商务合作 |
| `/mobile` | 手机官网 |
| 其他 | 隐私政策、用户协议、下载页面等 |
**API 接口**(调用外部服务):
- `GET /yaoqing/site/news/menu` - 栏目列表
- `GET /yaoqing/site/news/article-list` - 资讯列表
- `GET /yaoqing/site/news/article-detail` - 资讯详情
---
## 重写方案
使用 **fumamxCRM 技术栈**:
| 层级 | 新方案 | 端口 |
|------|--------|------|
| **前端** | React 19 + Vite 8 + TailwindCSS 4 | 10002 |
| **后端** | FastAPI + Python 3.12 + SQLite | 10003 |
---
### 确认几个问题:
1. **后端数据**:是否需要将外部 API 数据迁移到本地 SQLite 数据库?还是继续调用外部 API?
2. **页面范围**:是否需要重写全部 22 个页面?还是优先核心页面(首页 + 产品介绍)?
3. **设计**:是否需要重新设计 UI,还是保持现有视觉风格?
4. **静态资源**:图片资源(约 400+ 张)是继续使用现有路径,还是迁移到新项目?
---
## 概述
实现一个有前端呈现的公司官网,后端有管理后台的内容管理CMS系统。
总体上,要求所有的页面都能动态修改。
## 信息架构
无论是呈现给外部用户的前台的界面和页面,还是后端管理界面,呈现和修改添加的内容,都是基于这样的信息架构,及模块来展开。
**后台管理界面,需要对每一个模块,有对应的管理界面,对其内容进行增删改查。**
### 首页
Index页面由一系列可重用的子页面/子模块(栏目)拼装组成:
> 每一个子页面,都要求单独编辑管理其内容
> Index页面怎么组织这些子页面?
> 子页面在Index页面出现的先后顺序?
> 子页面的样式?
#### 顶部导航
公司Logo:这个写死代码
导航菜单:菜单可以动态调整,即增加,删除,修改和隐藏菜单。只支持一级菜单即可。每个菜单链接到某个页面或者模块链接。
#### 轮播图
#### 产品优势
#### 新闻动态
#### 合作伙伴
#### 友情链接
#### 下载链接
#### 联系方式
#### 常见问题
#### 产品介绍
#### Footer
### 产品介绍
### 新闻资讯
### 行业博客
### 关于我们
### 联系我们
### 加入我们
### 商务合作
# 企业官网 CMS 系统需求规格说明书
# 企业官网CMS系统需求规格说明书
## 一、项目概述
本项目为**企业官网内容管理系统(CMS)**,分为**前台用户端**(面向访客浏览官网)、**后台管理端**(面向管理员维护内容)、**后端API服务**(数据交互核心)三部分。
系统核心能力:**可视化拼装首页、动态配置导航、全内容可后台编辑、无需代码修改即可更新官网**,满足企业日常官网内容维护、产品展示、新闻发布、客户沟通等核心需求。
技术栈严格遵循要求:
- 前端:React 19.2.4 + Vite 8.0.4 + TailwindCSS 4.2.2 + React Router 7.14.1
- 后端:Python 3.12 + FastAPI + SQLite + SQLAlchemy + JWT + Pydantic
- 部署:前端 serve 静态部署、后端 Uvicorn 运行
---
## 二、总体功能架构
```Plain
企业官网CMS
├─ 前台用户端(访客访问)
│ ├─ 首页(模块化拼装)
│ ├─ 产品介绍
│ ├─ 新闻资讯
│ ├─ 行业博客
│ ├─ 关于我们
│ ├─ 联系我们
│ ├─ 加入我们
│ └─ 商务合作
├─ 后台管理端(管理员操作)
│ ├─ 管理员认证
│ ├─ 首页模块管理(排序/样式/内容)
│ ├─ 导航菜单管理
│ ├─ 内容管理(产品/新闻/博客/单页)
│ ├─ 基础信息管理(轮播/合作伙伴/链接等)
│ └─ 系统设置
└─ 后端API服务
├─ 认证API
├─ 首页模块API
├─ 导航菜单API
├─ 内容数据API
└─ 公共资源API
```
---
## 三、前台用户端详细需求
### 3.1 通用要求
1. **响应式设计**:适配PC、平板、手机端,基于TailwindCSS实现
2. **统一布局**:所有页面包含**顶部导航栏**、**底部Footer**
3. **页面加载**:路由跳转无刷新,静态资源优化加载
4. **SEO友好**:页面标题、描述可后台配置
---
### 3.2 首页(核心模块化页面)
首页由**可独立编辑、可排序、可配置样式**的子模块拼装而成,管理员可在后台自由调整模块顺序、显示/隐藏、样式、内容。
#### 3.2.1 固定模块(不可删除,可编辑/隐藏)
1. **顶部导航**
1. 公司Logo:代码固定,后台可上传图片替换
2. 导航菜单:**一级动态菜单**,支持新增/编辑/删除/隐藏,点击跳转对应页面/模块
3. 移动端:导航自动折叠为汉堡菜单
2. **Footer(页脚)**
1. 包含版权信息、公司地址、电话、邮箱、备案号
2. 所有文字内容可后台编辑
#### 3.2.2 可拼装子模块(全部支持独立编辑、排序、样式配置)
|模块名称|功能要求|
|---|---|
|轮播图|支持多张图片轮播,后台可上传图片、配置跳转链接、轮播速度、是否显示|
|产品优势|标题+图标+描述,支持多条数据编辑,可配置展示样式(网格/横向)|
|新闻动态|展示最新N条新闻,带缩略图、标题、发布时间、查看详情按钮|
|合作伙伴|企业logo墙,后台可上传logo、配置名称、链接|
|友情链接|文字链接列表,可编辑名称、URL、排序|
|下载链接|文件下载列表,支持上传PDF/Word等文件,显示文件名、大小|
|联系方式|展示电话、邮箱、地址、地图定位,全部可后台编辑|
|常见问题(FAQ)|问答列表,支持展开/收起,后台可增删改查|
|产品介绍|展示精选产品,带图片、名称、简介、跳转详情按钮|
#### 3.2.3 首页核心规则
1. 子模块**顺序可自由拖拽调整**
2. 子模块可**单独设置显示/隐藏**
3. 子模块可**单独配置样式**:背景色、边距、文字颜色、布局方式
4. 所有子模块内容**无需修改代码,纯后台配置生效**
---
### 3.3 独立页面需求
1. **产品介绍页**
1. 列表页:展示所有产品(图片+名称+简介),支持分页
2. 详情页:产品大图、详细参数、详情描述,后台富文本编辑
2. **新闻资讯页**
1. 列表页:按时间倒序展示新闻,支持分页
2. 详情页:标题、发布时间、作者、富文本内容、封面图
3. **行业博客页**
1. 同新闻结构,区分新闻与博客分类,独立管理
4. **关于我们 / 联系我们 / 加入我们 / 商务合作**
1. 均为**单页富文本页面**,后台可直接编辑全部内容
2. 联系我们额外支持表单提交(姓名、电话、留言,提交后后台可查看)
---
## 四、后台管理端详细需求
### 4.1 管理员认证
1. **登录功能**:账号+密码登录,JWT令牌认证
2. **权限控制**:仅管理员可访问后台,token过期自动跳转登录
3. **密码修改**:支持管理员修改登录密码
---
### 4.2 核心功能模块
#### 4.2.1 首页模块管理(核心)
1. 展示所有首页子模块列表
2. 支持**拖拽排序**修改模块在首页的展示顺序
3. 支持模块**启用/禁用**(隐藏不显示)
4. 支持**编辑模块内容**:文字、图片、列表数据
5. 支持**配置模块样式**:背景色、内边距、布局、显示数量
6. 实时预览修改效果
#### 4.2.2 导航菜单管理
1. 展示一级菜单列表
2. 支持:新增、编辑、删除、隐藏菜单
3. 菜单配置项:菜单名称、跳转目标(页面/外部链接)、排序
4. 修改后前台导航实时生效
#### 4.2.3 内容管理
1. **产品管理**
1. 增删改查产品
2. 字段:产品名称、封面图、详情图、简介、详情富文本、排序、是否显示
2. **新闻管理**
1. 增删改查新闻
2. 字段:标题、封面图、作者、发布时间、富文本内容、是否置顶
3. **博客管理**
1. 同新闻管理,独立数据分类
4. **单页管理**
1. 编辑关于我们、联系我们、加入我们、商务合作
2. 富文本编辑器,支持图片上传、文字排版
#### 4.2.4 公共资源管理
1. 轮播图管理:增删改查、排序、上传图片、配置链接
2. 合作伙伴管理:上传logo、填写名称、链接
3. 友情链接管理:增删改查
4. 下载链接管理:上传文件、填写名称、排序
5. FAQ管理:增删改查问题与答案
#### 4.2.5 留言管理(联系我们表单)
1. 查看用户提交的留言列表
2. 展示:姓名、电话、留言内容、提交时间
3. 支持标记已读/删除
#### 4.2.6 系统设置
1. 公司基础信息:名称、logo、地址、电话、邮箱、版权信息
2. 备案号、SEO标题、首页描述配置
---
## 五、后端API服务需求
### 5.1 通用规范
1. 接口风格:RESTful API
2. 数据格式:JSON
3. 认证方式:请求头携带 `Authorization: Bearer {token}`
4. 异常处理:统一错误码、错误信息返回
5. 文档:自动生成 Swagger UI 接口文档
### 5.2 核心API分类
#### 5.2.1 认证接口
- `POST /api/login` 管理员登录
- `POST /api/change-password` 修改密码
- `GET /api/admin/info` 获取管理员信息
#### 5.2.2 首页模块接口
- `GET /api/home/modules` 获取前台首页所有启用模块(排序后)
- `GET /api/admin/home/modules` 获取后台所有模块列表
- `PUT /api/admin/home/modules/sort` 修改模块排序
- `PUT /api/admin/home/modules/:id` 编辑模块内容/样式/状态
- `GET /api/admin/home/modules/:id` 获取单模块详情
#### 5.2.3 导航菜单接口
- `GET /api/nav` 获取前台启用菜单
- `GET /api/admin/nav` 后台菜单列表
- `POST /api/admin/nav` 新增菜单
- `PUT /api/admin/nav/:id` 编辑菜单
- `DELETE /api/admin/nav/:id` 删除菜单
#### 5.2.4 内容管理接口
统一标准CRUD接口:
- 产品:`/api/products` `/api/admin/products`
- 新闻:`/api/news` `/api/admin/news`
- 博客:`/api/blogs` `/api/admin/blogs`
- 单页:`/api/pages` `/api/admin/pages`
#### 5.2.5 公共资源接口
- 轮播图 `/api/banners`
- 合作伙伴 `/api/partners`
- 友情链接 `/api/links`
- 下载资源 `/api/downloads`
- FAQ `/api/faq`
#### 5.2.6 留言与上传接口
- `POST /api/message` 提交留言
- `GET /api/admin/messages` 查看留言
- `POST /api/upload` 图片/文件上传(本地存储)
### 5.3 数据库设计(核心表)
1. `admins` 管理员表(id、用户名、密码哈希)
2. `home_modules` 首页模块表(名称、标识、排序、启用状态、样式配置、内容数据)
3. `nav_menus` 导航菜单表(名称、链接、排序、启用状态)
4. `products` 产品表
5. `news` 新闻表
6. `blogs` 博客表
7. `pages` 单页表(关于我们等)
8. `banners/partners/links/downloads/faq` 公共表
9. `messages` 留言表
10. `settings` 系统设置表
---
## 六、非功能需求
### 6.1 性能
- 接口响应时间 < 300ms
- 首页加载时间 < 2s
- 支持图片压缩、懒加载
### 6.2 安全性
- 密码加密存储(bcrypt)
- JWT令牌时效控制
- 接口权限校验
- 文件上传类型/大小限制
### 6.3 可维护性
- 代码结构清晰,注释完整
- 后端模块化拆分(路由、模型、服务、工具)
- 前端组件化复用
### 6.4 兼容性
- 前端兼容主流浏览器(Chrome、Edge、Firefox、Safari)
- 支持移动端全尺寸适配
---
## 七、交付物清单
1. 前端前台代码(React)
2. 前端后台管理代码(React)
3. 后端API服务代码(FastAPI)
4. SQLite数据库初始化脚本
5. 项目启动说明文档
6. 接口说明文档(Swagger)
7. 管理员使用手册
---
## 八、开发与运行要求
### 8.1 前端运行
```Bash
# 安装依赖
npm install
# 开发模式
npm run dev
# 生产构建
npm run build
# 生产部署
serve -s dist
```
### 8.2 后端运行
```Bash
# 安装依赖
pip install -r requirements.txt
# 开发模式
uvicorn main:app --reload
# 生产运行
uvicorn main:app --host 0.0.0.0 --port 8000
```
---
### 总结
这份需求说明书完整覆盖**企业官网CMS**的全场景需求:
1. **前台**:模块化拼装首页 + 7个标准企业页面,响应式适配全设备
2. **后台**:管理员认证 + 首页模块可视化配置 + 全内容编辑 + 资源管理
3. **后端**:标准化RESTful API + 完整数据库设计 + 安全认证 + 文件上传
4. 严格匹配你指定的技术栈,开箱可用,无需代码修改即可完成官网日常维护
---
https://niaodaifu.cn/是正式环境部署的网站,对应的代码就是 /home/ubuntu/nanocode/website
可以看到首页的大致内容,从上到下:
- header导航区(logo + 菜单)
- 轮播图
- 产品优势
-
- 新闻动态
- 合作伙伴
- 友情链接
- footer
我们先从后台轮播图子模块开始设计,你可以看看现有官网轮播图的效果,我们可以实现类似效果。轮播图需要关联链接,点击可以跳转。
你实现的时候,可以从老代码里到导入轮播图的图片,插入到你后台的轮播图子模块设计板块。
当然,我后续可以在这个轮播图子模块设计板块,替换图片,添加图片等。
你如果设计好了,我们就可以通过前端看效果。
你可以看到你之前的设计思想,我们逐步验证合理性!( 首页每个子模块排序,启用状态,样式配置,内容数据等怎么实现,你需要一点点实现和修改!!!!以下是你的设计,之前你跟我说的)
2. `home_modules` 首页模块表(名称、标识、排序、启用状态、样式配置、内容数据)
3. `nav_menus` 导航菜单表(名称、链接、排序、启用状态)
我们先做轮播图
---
前端首页采用 **配置驱动渲染** 模式拼装模块,核心机制如下:
## 1. 模块注册表(第275-281行)
```javascript
const moduleComponents = {
banner: BannerModule, // 轮播图
features: FeaturesModule, // 产品优势
news: NewsModule, // 新闻动态
partners: PartnersModule, // 合作伙伴
contact: ContactModule, // 联系我们
};
```
每个 `type` 对应一个组件,类似路由表。
## 2. 数据获取(第292-305行)
```javascript
const [modules, settings] = await Promise.all([
modulesApi.getPublic(), // GET /api/home/modules
settingsApi.getPublic(), // GET /api/settings
]);
```
一次性获取所有启用的模块,按 `sort_order` 排序。
## 3. 动态渲染(第317-329行)
```javascript
{modules.map((module) => {
const Component = moduleComponents[module.type];
if (!Component) return null;
return (
);
})}
```
**关键逻辑**:
- 遍历后端返回的模块数组
- 根据 `type` 查找对应组件
- 统一传递 `title/subtitle/content` 三个属性
## 4. 各模块自治
每个模块组件独立解析自己的 `content` 结构:
| 模块 | content 结构 | 数据来源 |
|-----|-------------|---------|
| Banner | `slides: [{image, title, subtitle, link}]` | 后台配置 |
| Features | `items: [{icon, title, description}]` | 后台配置 |
| News | `count: number` | 静态占位 |
| Partners | `logos: [{url, name}]` | 后台配置 |
| Contact | `phone, email, address` | 后台配置 |
## 优势
1. **可配置** - 后台启用/禁用模块,前台自动显示/隐藏
2. **可排序** - 调整 `sort_order` 改变模块顺序
3. **可扩展** - 新增模块只需:加组件 + 注册到 `moduleComponents`
4. **解耦** - 各模块内部逻辑独立,互不影响
目前只有 **Banner 模块** 接入了真实数据(4张轮播图),其他模块显示的是静态占位数据。需要我继续对接其他模块的后台数据吗?
---
看到了,现在的 features 模块很简单,只有 icon + 标题 + 描述。我来设计一个完整的**特性展示卡片系统**方案:
---
## 方案建议
### 1. 卡片数据结构
```json
{
"items": [
{
"id": 1,
"title": "智能检测",
"subtitle": "AI 驱动的健康分析",
"description": "通过手机拍照即可检测尿常规指标...",
"media_type": "image", // image | video | icon | none
"media_url": "/assets/feature-1.jpg",
"icon": "🔬", // media_type=icon 时显示
"link": "/product",
"accent_color": "#4ADE80" // 卡片主题色
}
],
"layout": "grid", // grid | horizontal | vertical
"columns": 3, // 2-4列
"hover_effect": "lift" // lift | scale | glow | border
}
```
### 2. 视觉风格(新粗野主义)
| 元素 | 设计 |
|:---|:---|
| **卡片** | 白底 + 2px黑边框 + 4px硬阴影 |
| **悬停** | 阴影消失 + 卡片位移(2px,2px) + 边框加粗 |
| **媒体区** | 顶部图片/视频,圆角0px,保持直角风格 |
| **图标** | 大图标(48px) + 彩色背景圆形/方形 |
### 3. 支持的媒体类型
| 类型 | 说明 |
|:---|:---|
| **Icon** | emoji 或 SVG 图标,简单轻量 |
| **Image** | 产品截图、示意图,建议 400x300 |
| **Video** | 短视频/GIF,自动静音播放,悬停时播放 |
| **None** | 纯文字卡片,突出标题和描述 |
### 4. 悬停动效选项
| 效果 | 描述 |
|:---|:---|
| **Lift** | 卡片上移4px + 阴影加深,经典感 |
| **Scale** | 微微放大1.02倍 + 边框变色 |
| **Glow** | 边框发光(适合深色卡片)|
| **Border** | 边框从2px→4px,强调轮廓 |
---
## 我的建议
**先简单一点**(你的风格):
1. **卡片结构**:图片(上) + 标题 + 描述 + 链接按钮
2. **数量**:默认3个,可添加至5个
3. **动效**:Lift(上移+阴影变化),最符合新粗野主义
4. **后台管理**:类似 BannerManage,可拖拽排序卡片
**后台界面示意:**
```
┌─────────────────────────────┐
│ 特性展示管理 [+添加卡片] │
├─────────────────────────────┤
│ 布局: [3列 ▼] 悬停效果: [Lift ▼] │
├─────────────────────────────┤
│ ┌─────┐ ┌─────┐ ┌─────┐ │
│ │ 🖼️ │ │ 🖼️ │ │ 🖼️ │ ← 卡片预览 │
│ │标题1│ │标题2│ │标题3│ │
│ │ ↑↓ │ │ ↑↓ │ │ ↑↓ │ ← 排序按钮 │
│ │编辑 │ │编辑 │ │编辑 │ │
│ └─────┘ └─────┘ └─────┘ │
└─────────────────────────────┘
```
---
**确认后我开始写代码**:
1. 改 PublicHome.jsx 的 FeaturesModule(支持图片/视频 + 悬停动效)
2. 创建 FeaturesManage.jsx 后台管理页面(卡片CRUD + 排序)
3. 确认数据结构和字段
**你的选择是?**(可以逐项确认)
- A. 卡片结构(图片+标题+描述+链接)
- B. 数量限制(3-5个,默认3)
- C. 悬停效果(Lift/Scale/Glow/Border)
- D. 是否支持视频(先只做图片,还是图片+视频)
---
**你的选择是?**(可以逐项确认)
- A. 卡片结构(图片+标题+描述+链接)
Answer: 图片+标题+描述+链接 可以都有,也可以缺少某1,2项。
- B. 数量限制(3-5个,默认3)
Answer: 默认3项,但是可以删除或者添加1个?也就是动态的,不超过个5个不少于2个。
卡片越少,卡片越大,两个最大,5个最小。
- C. 悬停效果(Lift/Scale/Glow/Border)
Answer:悬停效果,你先做一个,我看效果。
- D. 是否支持视频(先只做图片,还是图片+视频)
Answer:我觉得支持视频和图片,视频和图片的效果应该是不一样的?
鼠标移到上去,视频播放?鼠标移开,视频停止?这个你觉得可否?你的建议?
支持视频是想测试一下视频效果,如果效果好,其他的模块也可以考虑视频。
我在website-new目录下,放了720p.mp4视频文件,你可以复制或移动到合适的地方,做测试
---
对,**目前只能修改代码**。
当前架构下,样式和动效是硬编码在 React 组件里的(`FeatureCard` 组件)。用户通过 CMS 只能改内容(标题、描述、图片),不能改:
- 悬停效果(现在是 Lift 上移+阴影)
- 卡片圆角、边框样式
- 动画类型和速度
- 文字位置、遮罩样式
---
## 如果要实现样式定制,有几个方案:
### 方案1:Content 里加 style 配置(推荐)
在 `content` 里增加 `style` 字段,存储样式参数:
```json
{
"items": [...],
"style": {
"cardEffect": "lift", // lift | scale | glow | none
"borderRadius": 0, // 0-20px
"hoverShadow": true,
"titlePosition": "bottom", // bottom | overlay | top
"overlayGradient": "dark" // dark | light | none
}
}
```
**优点**:用户可配,不需要改代码
**缺点**:需要写很多条件渲染代码,容易出 bug
---
### 方案2:预定义主题模板
提供 3-5 套预设样式(卡片 A/B/C 版),用户选一套:
```json
{
"items": [...],
"theme": "minimal" // minimal | elevated | glass | neon
}
```
每套主题对应写好的 CSS class,切换即可。
---
### 方案3:CSS 变量覆盖(最简单)
在 CMS 里加一个"自定义 CSS"文本框,用户写:
```css
.feature-card:hover {
transform: scale(1.02);
box-shadow: 0 0 20px rgba(102, 126, 234, 0.3);
}
```
保存后注入到页面 `