From 0aed7d129574f5d4498be2be70f2ddc2796395a8 Mon Sep 17 00:00:00 2001
From: lizhengwei <lizhengwei@dcrays.cn>
Date: Fri, 6 Mar 2026 18:06:26 +0800
Subject: [PATCH] =?UTF-8?q?=E9=9C=80=E6=B1=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 ruoyi-site/ruoyi-h5/doc/需求.md | 50 +++++++++++++++++++++++++++++++--
 1 file changed, 47 insertions(+), 3 deletions(-)

diff --git a/ruoyi-site/ruoyi-h5/doc/需求.md b/ruoyi-site/ruoyi-h5/doc/需求.md
index b7c272b60..5b764555e 100644
--- a/ruoyi-site/ruoyi-h5/doc/需求.md
+++ b/ruoyi-site/ruoyi-h5/doc/需求.md
@@ -115,6 +115,50 @@ map: { "uuid": "0.548034526304074540", "type": "map", "title": "", "category": "
 
 
 
-## 2026-0315新需求
-不能动代码，写需求md，我们来理一下需求计划，准备设计开发h5组件库，组件包含如下类型：文字、图片、表单、定位、微信头像等等；
-前端效果是：点击组件，就会往页面添加一个内容，如点击图片模板，就会添加一个图片到画布中
\ No newline at end of file
+## 2026-0315 新需求 - H5 组件库
+
+### 需求概述
+构建一个可复用的 H5 组件库系统，支持组件分类管理、标签检索、快速应用等功能。用户点击组件即可自动添加到 H5 编辑画布中，提高页面制作效率。
+
+### 核心功能
+
+**1. 组件管理**
+- 组件类型：文字、图片、扩展(表单、定位、微信头像)、背景、音乐
+- 每个组件包含完整的样式配置和内容数据（JSON 格式）
+- 提供组件缩略图预览和使用统计
+
+**2. 分类管理**
+- 两级分类结构：
+    - 一级分类：文字、图片、扩展、背景、音乐（固定 5 大类）
+    - 二级分类：用户可自定义添加（如标题文字、产品图片等）
+- 只允许两层，不支持多级嵌套
+
+**3. 标签系统**
+- 每个组件可关联多个关键词标签
+- 支持通过标签搜索相似组件
+- 统计热门标签并推荐
+
+**4. 前端交互**
+- 点击组件卡片 → 自动添加到画布中心位置
+- 支持拖拽组件到画布指定位置
+- 智能吸附参考线
+
+### 数据库设计
+
+**需要 5 张表：**
+1. 组件表：存储组件基本信息和配置数据
+2. 分类表：存储两级分类结构
+3. 组件分类关联表：组件与分类的多对多关系
+4. 标签表：存储标签信息
+5. 组件标签关联表：组件与标签的多对多关系
+
+### 技术要点
+
+- 时间字段统一使用 Unix 时间戳（秒级）
+- 组件内容使用 JSON 格式存储
+- 使用 MyBatis-Plus 作为 ORM 框架
+- 标准分层架构（Entity/DAO/Service/Controller/VO）
+
+### 开发计划
+
+分 4 个阶段：基础 CRUD 功能 → 核心业务逻辑 → 性能优化 → 扩展功能，预计 10 天完成。
\ No newline at end of file