中药香囊B/S最小可运行版交付指南

Vibe Coding 使用 AI 回答

代码问题:

B/S架构最低要求:

  1. 后端和数据库;
  2. 前端:浏览器版前端,微信小程序前端。 (实验项目为中药香囊) 提交内容:
  3. 项目文件夹打包。
  4. 软件说明文档,包含截图,PDF格式。
代码解决方案:

中药香囊实验项目 – B/S 架构最小可运行版本
交付清单与打包指南

一、项目文件夹结构(根目录名:HerbalSachet-Min)
├── backend/ # 后端(Spring Boot 3 + MySQL 8)
│ ├── src/main/java/… # Java 源码
│ ├── src/main/resources/… # application.yml、MyBatis-XML、静态图片
│ ├── target/ # Maven 打包后生成的 herbal-sachet-0.0.1.jar
│ └── pom.xml
├── db/ # 数据库脚本
│ ├── schema.sql # 建库建表
│ └── init-data.sql # 2 条香囊示例数据
├── web/ # 浏览器前端(Vue3 + Vite,纯静态)
│ ├── dist/ # 已打包:index.html + /assets/**
│ ├── src/… # 源码(可选,方便二次开发)
│ └── package.json
├── weapp/ # 微信小程序前端
│ ├── miniprogram/ # 所有 .js .json .wxml .wxss
│ └── project.config.json # 小程序项目配置
└── docs/
├── user-manual.md # Markdown 源文件
└── user-manual.pdf # 导出的软件说明文档(含截图)

二、运行环境最低要求

  1. 后端
    • JDK 17
    • MySQL 8.0(端口 3306,账号 root / 123456)
    • 默认端口 8080,无其他外部依赖

  2. 浏览器前端
    • 任意现代浏览器即可;把 dist 目录丢进 Nginx/Apache 或直接双击 index.html 亦可运行(已配置跨域代理到 http://localhost:8080)。

  3. 微信小程序
    • 微信开发者工具 ≥1.06.2401020
    • 合法 AppID 或测试号
    • 本地需能访问后端 http://localhost:8080;若使用手机预览,请确保电脑与手机在同一局域网并在微信开发者工具中把 request 合法域名设为 http://<本机IP>:8080。

三、一键启动脚本(Windows / macOS / Linux 通用)

# 1. 数据库
mysql -uroot -p123456 < db/schema.sql
mysql -uroot -p123456 < db/init-data.sql

# 2. 后端
cd backend
java -jar target/herbal-sachet-0.0.1.jar

# 3. 浏览器前端(任选其一)
# 3.a 静态文件
start http://localhost:8080          # 后端已内置 /web/** 资源
# 3.b 独立 Nginx
# 把 web/dist 复制到 /usr/share/nginx/html,访问 http://localhost

# 4. 微信小程序
微信开发者工具 -> 导入 weapp 目录 -> 编译 -> 预览

四、软件说明文档(user-manual.pdf)大纲

  1. 项目简介
    • 实验目的:通过香囊配方体验中药方剂配伍
    • 技术选型:Spring Boot + MyBatis + Vue3 + 微信小程序
  2. 功能速览(截图)
    • 浏览器端:登录 / 注册、香囊列表、配方详情、评价
    • 小程序端:首页轮播、香囊卡片、下单页、个人中心
  3. 部署步骤(图文)
  4. 接口清单(Swagger 截图,仅保留 5 个核心接口)
  5. 常见问题 FAQ
  6. 开源协议:MIT

五、打包与提交检查表

  • 根目录命名:HerbalSachet-Min.zip
  • 无 node_modules、.idea、target/classes 等冗余文件
  • user-manual.pdf 已嵌入全部截图,页数 ≤ 12
  • README.md 写明“最低环境 + 一键启动”即可
  • 上传至课程指定网盘 / U 盘,文件名:学号_姓名_HerbalSachet-Min.zip