# 活牛采购智能数字化系统 - 项目总览

## 📋 项目简介

活牛采购智能数字化系统是一个专为活牛采购行业打造的全流程数字化管理平台。系统通过标准化采购流程、实时运输跟踪、智能结算支付等功能，解决传统活牛采购中信息不透明、流程不规范、风险控制难等核心痛点。

## 🎯 核心价值

- **流程标准化**：建立统一的采购流程规范，减少人为错误
- **信息透明化**：实时跟踪采购全流程，提升信息透明度
- **风险可控化**：通过数字化手段，降低采购风险
- **效率最大化**：自动化处理重复性工作，提升整体效率

## 🏗️ 系统架构

### 多端应用矩阵
- **管理后台**：基于Vue 3的Web管理系统，面向内部管理人员
- **小程序矩阵**：基于Uni-app的跨平台小程序，包含4个专业小程序
  - 采购人小程序：订单管理、验收支付
  - 供应商小程序：订单处理、牛只管理
  - 司机小程序：运输跟踪、状态上报
  - 内部员工小程序：全流程监控管理
- **企业官网**：基于HTML5的企业展示网站

### 技术栈
- **前端**：Vue 3 + TypeScript + Element Plus + Uni-app
- **后端**：Node.js + Express.js + MySQL + Redis
- **部署**：Docker + Nginx + PM2

## 📚 文档导航

### 📋 产品文档
- [产品需求文档 (PRD)](./产品需求文档.md) - 详细的产品功能需求和用户故事
- [用户角色与权限](./用户角色与权限.md) - 系统用户角色定义和权限矩阵

### 🏗️ 技术文档
- [系统架构设计](./系统架构设计.md) - 整体技术架构和模块划分
- [数据库设计](./数据库设计.md) - 数据表结构和关系设计
- [API接口文档](./API接口文档.md) - 后端接口规范和调用说明
- [前端开发规范](./前端开发规范.md) - 前端代码规范和开发指南

### 🚀 部署运维
- [环境配置指南](./环境配置指南.md) - 开发和生产环境配置
- [部署运维手册](./部署运维手册.md) - 系统部署和运维操作指南
- [监控告警方案](./监控告警方案.md) - 系统监控和故障处理

### 🧪 测试文档
- [测试计划](./测试计划.md) - 测试策略和测试用例
- [质量保证规范](./质量保证规范.md) - 代码质量和测试规范

### 📊 项目管理
- [开发计划](./开发计划.md) - 项目里程碑和开发进度
- [版本发布记录](./版本发布记录.md) - 系统版本更新记录

## 🚀 快速开始

### 环境要求
- Node.js 16+
- MySQL 5.7+
- Redis 6.0+

### 本地开发
```bash
# 1. 克隆项目
git clone [项目地址]

# 2. 安装依赖
cd niumall
npm install

# 3. 配置环境变量
cp backend/.env.example backend/.env
# 编辑 .env 文件，配置数据库连接等信息

# 4. 初始化数据库
cd backend
npm run init:db

# 5. 启动后端服务
npm run dev

# 6. 启动前端服务
cd admin-system
npm run dev
```

### 项目结构
```
niumall/
├── admin-system/          # 管理后台 (Vue 3)
├── backend/              # 后端服务 (Node.js)
├── mini_program/         # 小程序矩阵 (Uni-app)
├── website/             # 企业官网 (HTML5)
├── docs/                # 项目文档
└── README.md           # 项目说明
```

## 👥 团队协作

### 开发流程
1. **需求分析** → 产品经理编写PRD文档
2. **技术设计** → 架构师设计技术方案
3. **开发实现** → 开发团队按模块开发
4. **测试验收** → QA团队执行测试计划
5. **部署上线** → 运维团队执行部署方案

### 代码规范
- 遵循ESLint和Prettier配置
- 提交信息遵循Conventional Commits规范
- 代码审查通过后方可合并

## 📞 联系方式

- **项目负责人**：[姓名] - [邮箱]
- **技术负责人**：[姓名] - [邮箱]
- **产品负责人**：[姓名] - [邮箱]

## 📄 许可证

本项目采用 [MIT License](../LICENSE) 许可证。

---

*最后更新时间：2024年12月*