# eshop-class2-group3 **Repository Path**: grade24-fullstack-class2/eshop-class2-group3 ## Basic Information - **Project Name**: eshop-class2-group3 - **Description**: No description available - **Primary Language**: Unknown - **License**: Not specified - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 4 - **Created**: 2026-07-21 - **Last Updated**: 2026-08-13 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 电子商城（E-Shop）暑期企业级综合项目实战 > 班级：_软件技术2班 组号：3____ 组名：____ ## 一、项目简介 本项目为软件技术专业暑期企业级综合项目实战，目标是以小组协作方式，在 **4 周** 内完成一个功能完整、可演示、可部署的多端电子商城系统，系统包含**消费者端、商家端、平台管理端**三大业务端口。全程模拟企业真实研发流程：需求分析 → 系统设计 → 编码实现 → 测试 → 部署 → 验收答辩。 ## 二、小组成员与分工（端口 + 模块负责制） 本项目采用**端口全栈负责制**：不按前后端拆分，每人认领对应业务端口，独立负责该端口下所有业务模块的 **数据库表设计 + 后端接口开发 + 前端页面实现** 完整链路。 表格 | 姓名 | 学号 | 角色 | 负责范围（全栈） | | :----- | :--------- | :------------- | :----------------------------------------------------------- | | 仝凯元 | 2444310226 | 组长 / 架构员 | 项目脚手架搭建、统一登录鉴权体系、公共组件与通用工具封装、全项目集成联调、代码质量管控、进度统筹 | | 黄钰 | | 商家端负责人 | 商家端全链路开发：商家入驻与店铺信息管理、商品发布 / 编辑 / 上下架、店铺订单处理与发货、商家经营数据看板 | | 张志鑫 | | 消费者端负责人 | 消费者端全链路开发：商品分类 / 搜索 / 详情页、购物车管理、订单提交与模拟支付、个人中心、收货地址管理 | | 谭卓文 | | 平台端负责人 | 平台管理端全链路开发：用户账号管理、商品审核与违规处理、订单全链路监管、平台数据统计、系统配置管理 | > 4 人组模式下，测试与部署职责由全体成员协同完成，组长统筹推进；选做功能由组内协商认领，考核权重单独核算。 > > 分工规则详见 `docs/00-项目要求/项目要求.md` 第三节，模块难度权重与考核挂钩。 ## 三、技术栈 | 端口 / 模块 | 前端 | 后端 | 数据库 | | :---------------- | :---------------------------- | :---------------------- | :------------ | | 消费者交易模块 | React + Vite | Node.js + Express + Prisma | MariaDB | | 商家经营模块 | React + TypeScript + Ant Design | Node.js + Express + Prisma | MariaDB | | 平台运营治理模块 | React 19 + Vite | Node.js + Express + Prisma | SQLite | | 公共基建 / 集成 | — | JWT/RBAC 统一鉴权、统一响应、MinIO 对象存储 | — | > 三端统一接口规范：前缀 `/api/v1`，响应格式 `{ code, data, msg }`，统一错误码。 > 部署：宝塔面板 + Nginx + PM2 + MinIO（源码部署，平台端提供 `start.bat` 一键启动）。 ## 四、仓库目录结构 ``` ├── README.md # 项目说明（本文件） ├── docs/ # 项目文档 │ ├── 00-项目要求/ # 项目要求、验收标准、评分标准（教师发布，勿改） │ ├── 01-需求文档/ # PRD 需求文档 │ ├── 02-设计文档/ # 整体技术方案、数据库表设计、接口文档 │ ├── 03-测试文档/ # 测试报告、Bug 清单与修复记录 │ ├── 04-会议记录/ # 每周小组会议纪要 │ └── 05-总结答辩/ # 项目总结报告、答辩材料 ├── reports/ # 日报周报 │ ├── daily/ # 日报（每人每日一份，按成员分目录） │ │ ├── 仝凯元/ # 组长日报 │ │ ├── 张志鑫/ # 消费者端日报 │ │ ├── 黄钰/ # 商家端日报 │ │ └── 谭卓文/ # 平台端日报 │ └── weekly/ # 周报（每组每周一份，组长汇总） ├── 消费者交易模块/ # 消费者端（张志鑫负责） │ ├── backend/ # Express + Prisma + MariaDB 后端 │ │ └── src/modules/ # account / catalog / orders / support 等 │ └── frontend/ # React + Vite 前端 ├── 商家经营模块/ # 商家端（黄钰负责） │ ├── backend/ # Express + Prisma 后端 │ │ └── src/modules/ # merchant / product / order / refund / settlement / review / dashboard / im / notification │ └── frontend/ # React + TypeScript + Ant Design 前端 └── 平台运营治理模块/ # 平台管理端（谭卓文负责） ├── server/ # Express + Prisma + SQLite 后端 │ └── src/routes/ # 认证 / 审核 / 订单 / 结算 / 审计等 13 个路由 ├── client/ # React 19 + Vite 前端 ├── start.bat # Windows 一键启动脚本 └── 模块说明.md # 模块定位、功能范围、核心流程 ``` ## 五、关键时间节点（4 周） | 阶段 | 时间 | 交付物 | | :------ | :--------------- | :----------------------------------------------------------- | | 第 1 周 | 需求与设计阶段 | 三端需求规格说明书、系统架构设计、数据库设计、统一接口规范 | | 第 2 周 | 核心功能开发 | 消费者端商品浏览与个人中心、商家端商品管理、平台端用户管理可演示；统一鉴权体系三端打通 | | 第 3 周 | 完整功能开发 | 购物车、订单、模拟支付全链路打通；商家端订单处理、平台端审核与监管功能可演示；选做功能开发 | | 第 4 周 | 测试、部署与答辩 | 三端功能测试报告、边界场景验证、Docker 部署上线、项目总结报告、最终答辩 | ## 六、Git 协作规范 1. 主分支 `master` 只存放可运行代码，禁止直接 push。 2. 功能开发使用 `feature/端口-功能名` 分支（如 `feature/merchant-goods-publish`），开发完成后经组长 Code Review 合并。 3. 提交信息格式：`: <描述>`，type 取值：`feat` `fix` `refactor` `docs` `test` `chore`。 4. **每人每天至少一次有效提交**，提交记录将作为个人考核依据。 5. **交叉 Code Review**：每人的功能分支由相邻端口负责人审查后方可合并（审查人需在合并说明中留名）。 ## 七、如何开始 1. 全组共同阅读 `docs/00-项目要求/` 下的全部文档，明确项目验收标准与考核规则。 2. 确认分工表、技术栈信息，完善本文件对应空白内容。 3. 各端口负责人参照 `docs/01-需求文档/` 模板，分别编写对应端口的需求规格说明书。 4. 组长牵头完成项目脚手架搭建与基础鉴权模块，同步输出统一接口规范。 5. 每人每日下班前提交个人日报至 `reports/daily/` 目录。