# 18-美食分享系统 - 功能说明
# 项目概述
当前目录为美食分享系统的开发基础版本。主 SQL 已设计美食、分类、评论、点赞、收藏、关注、评分、举报和消息等业务表，但当前前端路由和后端控制器主要提供管理员、用户及通用账号功能。本文将已实现基础能力与数据库规划明确区分。
# 项目概览
# 创新点
- 业务表结构准备：SQL 已定义美食内容与社交互动相关表，可作为后续开发的数据基础。
- 账号基础复用：具备角色登录、用户管理及个人资料维护代码。
- 业务边界清楚：当前可核实的是基础模板能力，业务表不等同于完整功能已经可用。
# 项目亮点
- 角色分工：提供管理员、用户等业务入口。
- 业务数据组织：主初始化脚本包含 13 张表；具体业务完成程度以各功能章节及当前实现说明为准。
- 前后端分离：前端负责页面交互，后端通过控制器、服务与数据映射层提供接口。
- 操作体验：提供列表查询、表单编辑、状态展示及个人资料维护入口。
# 管理员
# 账号管理
通过后台维护管理员和用户资料。
# 个人资料
修改当前账号信息与密码。
# 用户
# 账号服务
注册、登录及维护个人资料和密码。
# 余额入口
使用保留的通用余额页面与充值接口。
# 基础页面
访问首页和个人中心等现有通用页面。
# 功能权限对照表
下表说明当前菜单与业务入口分工。“—”表示未列为该角色的常规入口；不代表已对每个接口完成权限安全审计。
| 功能模块 | 管理员 | 用户 |
|---|---|---|
| 管理员账号 | 管理 | — |
| 用户账号 | 管理 | 个人资料 |
| 注册登录 | 登录 | 注册登录 |
| 通用余额 | 用户数据维护 | 余额入口 |
| 美食与互动业务 | 仅有数据表设计 | 尚无完整业务入口 |
# 业务状态说明
- 账号状态：基础账号服务使用启用状态，并由账号管理页面维护。
- 美食发布审核及举报处理：虽有相关数据字段，但当前缺少对应业务控制器和页面流程，不将其列为可用状态流转。
# 默认账号
以下为主初始化 SQL 中能够核实的示例账号；需先导入对应脚本。这里不把脚本初始值视为当前运行数据库的实际账号或余额。
| 登录角色 | 角色标识 | 用户名 | 初始密码 |
|---|---|---|---|
| 管理员 | ADMIN | admin | 123456 |
| 用户 | USER | user | 123456 |
# 核心业务流程
# 用户账号
- 注册用户。
- 选择用户身份登录。
- 进入前台基础页面。
- 修改个人资料或密码。
# 后台账号
- 管理员登录。
- 进入用户管理。
- 查询、新增或修改用户资料。
- 保存。
# 技术说明
# 系统架构
| 项目 | 当前源码配置 |
|---|---|
| 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 中的声明范围记录，不将依赖范围等同于已安装的精确版本。
# 访问地址
- 后端接口：http://localhost:1000 (opens new window)，对应服务端端口配置。
- 前端开发页面：http://localhost:5173 (opens new window)，项目未显式覆盖 Vite 默认端口，实际以启动日志为准。
- 登录入口：前端
/login；管理端基础路由/admin。
# 数据库
- 配置数据库名：
springboot3_vue3_template_1_balance。 - 主初始化脚本：
sql/sql.sql。 - 主脚本建表数量：13 张，仅统计当前主脚本的 CREATE TABLE，不包含临时 SQL、迁移脚本或运行时改动。
- 字符集：主脚本采用 utf8mb4。
- 数据表清单：
admin、user、category、food、comment、praise、collection、follow、rating、report、message、notice、banner。
# 文件上传
- 上传接口：
POST /file/upload。 - 文件访问：
GET /file/{fileName}。 - 配置限制：单文件 100MB，单次请求 1000MB。
- 使用范围：根据业务页面上传图片或附件；具体允许类型以对应上传组件配置为准。
# 系统特色
# 业务表结构准备
SQL 已定义美食内容与社交互动相关表，可作为后续开发的数据基础。
# 账号基础复用
具备角色登录、用户管理及个人资料维护代码。
# 业务边界清楚
当前可核实的是基础模板能力，业务表不等同于完整功能已经可用。
# 当前实现说明
- 当前未发现美食发布、浏览详情、点赞收藏、关注、评分、举报和消息等对应业务控制器与前端业务路由，不能据 SQL 表名宣称这些功能已完成。
- 应用仍连接模板数据库 springboot3_vue3_template_1_balance，部署前需明确目标库与美食业务 SQL 的对应关系。
- 首页、个人中心和余额等为通用模板入口，不能描述为已建成的美食分享社区。
本次按本地源码进行静态核对，未启动前后端或连接数据库执行端到端验证；上述说明反映当前代码与页面定义。