# wxxcx

**Repository Path**: mayprogress/wxxcx

## Basic Information

- **Project Name**: wxxcx
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-14
- **Last Updated**: 2026-07-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 供应链协同平台

<div align="center">

![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)
![License](https://img.shields.io/badge/license-MIT-green.svg)
![Node](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen.svg)
![Docker](https://img.shields.io/badge/docker-20.10%2B-blue.svg)

一个基于 Taro + NestJS 的医疗器械行业供应链协同管理平台

[文档](#文档) • [快速开始](#快速开始) • [功能特性](#功能特性) • [部署指南](#部署指南) • [API 文档](#api-文档)

</div>

---

## 目录

- [项目简介](#项目简介)
- [功能特性](#功能特性)
- [技术栈](#技术栈)
- [系统架构](#系统架构)
- [快速开始](#快速开始)
- [项目结构](#项目结构)
- [部署指南](#部署指南)
- [文档](#文档)
- [开发指南](#开发指南)
- [常见问题](#常见问题)
- [贡献指南](#贡献指南)
- [许可证](#许可证)

---

## 项目简介

供应链协同平台是一个为医疗器械行业设计的全栈应用，提供订单管理、结算管理、消息通知等核心功能。系统支持多端访问，包括微信小程序、抖音小程序和 H5 网页。

### 核心价值

- **订单协同**: 实时跟踪订单状态，提高供应链效率
- **结算管理**: 自动化结算流程，降低财务风险
- **消息通知**: 及时推送重要信息，确保沟通畅通
- **多端支持**: 支持微信小程序、抖音小程序和 H5 网页
- **安全可靠**: 完善的数据加密和权限管理

---

## 功能特性

### 订单管理

- ✅ 订单列表查询（支持筛选和搜索）
- ✅ 订单详情查看
- ✅ 订单确认操作
- ✅ 订单状态跟踪
- ✅ 订单明细管理
- ✅ 配送明细查看

### 结算管理

- ✅ 结算单列表查询（支持筛选和搜索）
- ✅ 结算单详情查看
- ✅ 结算单确认操作
- ✅ 结算状态跟踪
- ✅ 结算明细管理
- ✅ 发票信息管理

### 消息通知

- ✅ 消息列表查看
- ✅ 消息筛选（类型、紧急程度、状态）
- ✅ 消息详情查看
- ✅ 消息标记已读
- ✅ 附件下载

### 单据审批

- ✅ 单据审批列表查询（支持多条件筛选）
- ✅ 单据详情查看
- ✅ 单据审批通过/驳回操作
- ✅ 驳回时需填写驳回理由
- ✅ 单据明细展示（折叠/展开，支持翻页）
- ✅ 审批历史记录
- ✅ 单据审批接口表（interface_approvals）
- ✅ 单据审批明细接口表（interface_approval_details）

### 平台连接

- ✅ SPD 平台连接管理
- ✅ 添加、编辑、删除平台连接
- ✅ 连接状态管理
- ✅ 连接测试

### 个人中心

- ✅ 个人信息查看和编辑
- ✅ 密码修改
- ✅ 用户信息管理

---

## 技术栈

### 前端

| 技术 | 版本 | 说明 |
|------|------|------|
| Taro | 4.1.9 | 多端开发框架 |
| React | 18+ | UI 框架 |
| TypeScript | 5.4.5 | 编程语言 |
| Tailwind CSS | 4.1.18 | CSS 框架 |
| shadcn/ui | - | UI 组件库 |
| Zustand | 5.0.9 | 状态管理 |

### 后端

| 技术 | 版本 | 说明 |
|------|------|------|
| NestJS | 10.4.15 | 后端框架 |
| TypeScript | 5.7.2 | 编程语言 |
| Drizzle ORM | 0.45.1 | ORM 框架 |
| MySQL | 8.0+ | 数据库 |
| Coze SDK | 0.7.16 | 第三方集成 |

### DevOps

| 技术 | 版本 | 说明 |
|------|------|------|
| Docker | 20.10+ | 容器化 |
| Docker Compose | 2.0+ | 容器编排 |
| Nginx | 1.25+ | 反向代理 |
| Git | 2.0+ | 版本控制 |

---

## 系统架构

```
┌─────────────────────────────────────────────────────────┐
│                       客户端层                          │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐     │
│  │  微信小程序  │  │  抖音小程序  │  │    H5 Web   │     │
│  └─────────────┘  └─────────────┘  └─────────────┘     │
└─────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────┐
│                       应用层                             │
│  ┌────────────────────────────────────────────────────┐ │
│  │            NestJS 后端服务 (3000端口)               │ │
│  │  ┌──────────┐  ┌──────────┐  ┌──────────┐        │ │
│  │  │ 用户模块  │  │ 订单模块  │  │ 结算模块  │        │ │
│  │  └──────────┘  └──────────┘  └──────────┘        │ │
│  └────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────┐
│                       数据层                             │
│  ┌────────────────────────────────────────────────────┐ │
│  │            MySQL 数据库 (3306端口)                  │ │
│  └────────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
```

---

## 快速开始

### 方式一：Docker 部署（推荐）

#### 前置要求

- Docker 20.10+
- Docker Compose 2.0+

#### 部署步骤

```bash
# 1. 克隆项目
git clone <repository-url> coze-mini-program
cd coze-mini-program

# 2. 配置环境变量
cp .env.docker .env
vim .env  # 修改密码等配置

# 3. 启动服务
docker compose up -d

# 4. 查看服务状态
docker compose ps

# 5. 查看日志
docker compose logs -f
```

#### 访问系统

- **H5 网页**: http://localhost
- **API 服务**: http://localhost:3000
- **MySQL**: localhost:3306

### 方式二：手动部署

#### 前置要求

- Node.js 18+
- MySQL 8.0+
- pnpm 9.0.0+

#### 部署步骤

```bash
# 1. 克隆项目
git clone <repository-url> coze-mini-program
cd coze-mini-program

# 2. 安装依赖
pnpm install

# 3. 配置环境变量
cp .env.example .env
vim .env

# 4. 初始化数据库
mysql -u root -p < scripts/db/init.sql
mysql -u root -p coze_mini_program < scripts/db/insert-test-data.sql

# 5. 构建项目
pnpm build:server
pnpm build:web

# 6. 启动后端
cd server
pnpm start

# 7. 启动前端（开发模式）
cd ..
pnpm dev:web
```

---

## 项目结构

```
coze-mini-program/
├── src/                          # 前端源代码
│   ├── pages/                    # 页面
│   │   ├── index/                # 首页
│   │   ├── orders/               # 订单管理
│   │   ├── settlements/          # 结算管理
│   │   ├── messages/             # 消息通知
│   │   ├── platform-connections/ # 平台连接
│   │   └── profile/              # 个人中心
│   ├── components/               # 组件
│   │   └── ui/                   # UI 组件库
│   ├── api/                      # API 接口
│   ├── hooks/                    # 自定义 Hooks
│   ├── store/                    # 状态管理
│   ├── utils/                    # 工具函数
│   ├── app.config.ts             # 应用配置
│   ├── app.css                   # 全局样式
│   └── app.tsx                   # 应用入口
├── server/                       # 后端源代码
│   ├── src/
│   │   ├── modules/              # 业务模块
│   │   │   ├── users/            # 用户模块
│   │   │   ├── orders/           # 订单模块
│   │   │   ├── settlements/      # 结算模块
│   │   │   ├── messages/         # 消息模块
│   │   │   └── platforms/        # 平台连接模块
│   │   ├── common/               # 公共模块
│   │   │   ├── decorators/       # 装饰器
│   │   │   ├── filters/          # 过滤器
│   │   │   ├── guards/           # 守卫
│   │   │   ├── interceptors/     # 拦截器
│   │   │   └── pipes/            # 管道
│   │   ├── database/             # 数据库
│   │   ├── app.controller.ts     # 应用控制器
│   │   ├── app.service.ts        # 应用服务
│   │   └── main.ts               # 应用入口
│   ├── dist/                     # 构建产物
│   └── package.json              # 依赖配置
├── scripts/                      # 脚本
│   └── db/                       # 数据库脚本
│       ├── init.sql              # 初始化脚本
│       ├── insert-test-data.sql  # 测试数据
│       └── clean-test-data.sql   # 清除测试数据
├── docs/                         # 文档
│   ├── DEPLOYMENT_GUIDE.md       # 部署指南
│   └── OPERATION_MANUAL.md       # 操作手册
├── config/                       # 配置文件
│   ├── index.ts                  # 主配置
│   ├── dev.ts                    # 开发配置
│   └── prod.ts                   # 生产配置
├── dist/                         # 前端构建产物
│   ├── weapp/                    # 微信小程序
│   ├── tt/                       # 抖音小程序
│   └── web/                      # H5 网页
├── docker-compose.yml            # Docker Compose 配置
├── Dockerfile.server             # 后端 Dockerfile
├── Dockerfile.h5                 # 前端 Dockerfile
├── nginx.conf                    # Nginx 主配置
├── nginx-h5.conf                 # Nginx H5 配置
├── .env.docker                   # 环境变量模板
├── .env.example                  # 环境变量示例
├── .env                          # 环境变量（本地）
├── .env.local                    # 环境变量（本地开发）
├── package.json                  # 项目配置
├── pnpm-lock.yaml                # 依赖锁定文件
├── tsconfig.json                 # TypeScript 配置
├── .gitignore                    # Git 忽略配置
├── DESIGN_GUIDELINES.md          # 设计指南
├── DATABASE_SCHEMA.md            # 数据库结构
├── API_DOCUMENTATION.md          # API 文档
├── README.md                     # 项目说明（本文件）
└── LICENSE                       # 许可证
```

---

## 部署指南

### Docker 部署

详见 [部署指南](docs/DEPLOYMENT_GUIDE.md)

### 生产环境部署

#### 系统要求

- **CPU**: 4核+
- **内存**: 8GB+
- **磁盘**: 50GB SSD
- **网络**: 100Mbps

#### 安全配置

1. 修改默认密码
2. 配置防火墙规则
3. 启用 HTTPS
4. 配置备份策略
5. 启用日志审计

详见 [部署指南](docs/DEPLOYMENT_GUIDE.md)

### 数据库初始化

```bash
# 初始化数据库结构
mysql -u root -p < scripts/db/init.sql

# 插入测试数据
mysql -u root -p coze_mini_program < scripts/db/insert-test-data.sql

# 清除测试数据
mysql -u root -p coze_mini_program < scripts/db/clean-test-data.sql
```

---

## 文档

- [部署指南](docs/DEPLOYMENT_GUIDE.md) - 系统安装部署手册
- [操作手册](docs/OPERATION_MANUAL.md) - 系统使用操作手册
- [数据库结构](DATABASE_SCHEMA.md) - 数据库表结构说明
- [API 文档](API_DOCUMENTATION.md) - REST API 接口文档
- [设计指南](DESIGN_GUIDELINES.md) - UI 设计规范

---

## 开发指南

### 环境准备

```bash
# 安装 Node.js
nvm install 18
nvm use 18

# 安装 pnpm
npm install -g pnpm@9.0.0

# 安装依赖
pnpm install
```

### 开发模式

```bash
# 启动前端开发服务器（热更新）
pnpm dev:web

# 启动后端开发服务器（热更新）
pnpm dev:server

# 同时启动前后端
pnpm dev
```

### 代码规范

```bash
# 代码检查
pnpm lint

# 代码修复
pnpm lint:fix

# 类型检查
pnpm tsc

# 验证代码
pnpm validate
```

### 构建生产版本

```bash
# 构建所有平台
pnpm build

# 仅构建 H5
pnpm build:web

# 仅构建后端
pnpm build:server
```

### 测试

```bash
# 运行测试
pnpm test

# 测试覆盖率
pnpm test:cov
```

---

## 常见问题

### Q1: Docker 启动失败？

**A**: 请检查以下内容：

```bash
# 检查 Docker 服务
sudo systemctl status docker

# 查看容器日志
docker compose logs

# 检查端口占用
netstat -tlnp | grep -E '3306|3000|80'
```

### Q2: 数据库连接失败？

**A**: 请检查数据库配置：

```bash
# 测试数据库连接
docker compose exec mysql mysql -u coze_user -p coze_mini_program

# 检查环境变量
docker compose exec server env | grep MYSQL
```

### Q3: 如何备份数据？

**A**: 使用以下命令备份数据库：

```bash
# 备份数据库
docker compose exec -T mysql mysqldump -u root -p${MYSQL_ROOT_PASSWORD} coze_mini_program > backup_$(date +%Y%m%d_%H%M%S).sql
```

更多问题请查看 [常见问题](docs/OPERATION_MANUAL.md#常见问题)

---

## 贡献指南

我们欢迎任何形式的贡献！

### 贡献流程

1. Fork 本仓库
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'feat: Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 提交 Pull Request

### 提交规范

遵循 [Conventional Commits](https://www.conventionalcommits.org/) 规范：

- `feat`: 新功能
- `fix`: Bug 修复
- `docs`: 文档更新
- `style`: 代码格式调整
- `refactor`: 代码重构
- `test`: 测试相关
- `chore`: 构建/工具链相关

### 代码规范

- 遵循 [Airbnb JavaScript Style Guide](https://github.com/airbnb/javascript)
- 使用 ESLint 和 Prettier 格式化代码
- 添加必要的注释和文档

---

## 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

---

## 联系方式

- **项目主页**: https://github.com/yourusername/coze-mini-program
- **问题反馈**: https://github.com/yourusername/coze-mini-program/issues
- **技术支持**: support@example.com
- **商业合作**: business@example.com

---

## 致谢

感谢所有为本项目做出贡献的开发者！

特别感谢以下开源项目：

- [Taro](https://taro-docs.jd.com/)
- [NestJS](https://docs.nestjs.com/)
- [React](https://react.dev/)
- [Tailwind CSS](https://tailwindcss.com/)
- [shadcn/ui](https://ui.shadcn.com/)

---

<div align="center">

**如果本项目对你有帮助，请给一个 ⭐️**

Made with ❤️ by Coze Team

</div>