运行的本地官网项目。使用类似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); } ``` 保存后注入到页面 `