功能文档汇总

# 20-乡村助农系统 - 功能说明

# 项目概述

当前乡村助农系统目录保留的是前后端分离基础模板。已核实功能为管理员与用户账号管理、登录注册、个人资料及通用余额业务，主 SQL 仅包含管理员和用户两张表，尚未形成可核实的助农业务模块。

# 项目概览

# 创新点

  1. 基础工程：已具备 Vue 前端与 Spring Boot 后端项目结构。
  2. 身份与账号：提供管理员、用户两种登录身份及账号维护功能。
  3. 扩展起点：现有模板可作为后续助农业务开发起点，当前不将规划描述为完成项。

# 项目亮点

  • 角色分工：提供管理员、用户等业务入口。
  • 业务数据组织：主初始化脚本包含 2 张表；具体业务完成程度以各功能章节及当前实现说明为准。
  • 前后端分离：前端负责页面交互，后端通过控制器、服务与数据映射层提供接口。
  • 操作体验：提供列表查询、表单编辑、状态展示及个人资料维护入口。

# 管理员

# 账号管理

维护管理员和用户账号资料。

# 个人设置

修改个人信息及密码。

# 用户

# 账号服务

注册与登录，修改个人资料和密码。

# 基础页面

访问首页、个人中心及通用余额入口。

# 余额管理

使用基础充值接口维护系统账户余额。

# 功能权限对照表

下表说明当前菜单与业务入口分工。“—”表示未列为该角色的常规入口；不代表已对每个接口完成权限安全审计。

功能模块 管理员 用户
管理员账号 管理 —
用户账号 管理 个人资料
注册登录 登录 注册登录
通用余额 用户数据维护 余额入口
助农业务 未实现独立模块 未实现独立模块

# 业务状态说明

  • 账号状态：账号服务注册时设置启用，后台账号页面可维护状态。
  • 助农业务状态：未发现农产品订单、农户认证、供求审核或物流状态对应的业务实现。

# 默认账号

以下为主初始化 SQL 中能够核实的示例账号；需先导入对应脚本。这里不把脚本初始值视为当前运行数据库的实际账号或余额。

登录角色 角色标识 用户名 初始密码
管理员 ADMIN admin 123456
用户 USER user 123456

# 核心业务流程

# 账号使用

  1. 用户注册。
  2. 选择用户身份登录。
  3. 进入基础页面。
  4. 维护个人资料。

# 账号维护

  1. 管理员登录。
  2. 进入用户管理。
  3. 查询或维护账号。
  4. 保存信息。

# 技术说明

# 系统架构

项目 当前源码配置
Vue ^3.4.29
Element Plus ^2.8.4
Pinia ^2.2.2
Axios ^1.7.5
Vite ^5.3.1
Spring Boot 3.2.10
Java 17
MyBatis 集成组件 3.0.4
数据库 MySQL；具体运行版本以实际部署为准
身份认证 JWT；通过登录接口生成令牌

前端版本按 package.json 中的声明范围记录，不将依赖范围等同于已安装的精确版本。

# 访问地址

# 数据库

  • 配置数据库名：springboot3_vue3_template_1_balance。
  • 主初始化脚本：sql/sql.sql。
  • 主脚本建表数量：2 张，仅统计当前主脚本的 CREATE TABLE，不包含临时 SQL、迁移脚本或运行时改动。
  • 字符集：主脚本采用 utf8mb4。
  • 数据表清单：admin、user。

# 文件上传

  • 上传接口：POST /file/upload。
  • 文件访问：GET /file/{fileName}。
  • 配置限制：单文件 100MB，单次请求 1000MB。
  • 使用范围：根据业务页面上传图片或附件；具体允许类型以对应上传组件配置为准。

# 系统特色

# 基础工程

已具备 Vue 前端与 Spring Boot 后端项目结构。

# 身份与账号

提供管理员、用户两种登录身份及账号维护功能。

# 扩展起点

现有模板可作为后续助农业务开发起点，当前不将规划描述为完成项。

# 当前实现说明

  1. 主 SQL 只有 admin、user 两张表，尚未发现农户、农产品、助农订单、供求信息、农业资讯等业务表及页面、接口。
  2. 数据库配置仍为 springboot3_vue3_template_1_balance；目录名称不能作为助农功能已经实现的依据。
  3. 已有余额入口属于通用模板能力，没有核实第三方支付和实际助农交易流程。

本次按本地源码进行静态核对，未启动前后端或连接数据库执行端到端验证；上述说明反映当前代码与页面定义。

←

Java导航网   |