# np-server

**Repository Path**: NexusPrime/np-server

## Basic Information

- **Project Name**: np-server
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-13
- **Last Updated**: 2026-02-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 商品采购管理系统后端服务

## 项目结构

本项目采用Maven多模块结构，支持初期单体部署和后续平滑拆分为微服务。

```
np-server/
├── pom.xml                          # 父POM（聚合所有模块）
├── np-common/                       # 公共模块（所有模块依赖）
├── np-service-wechat-mp/            # 微信小程序端服务模块
├── np-service-wechat-admin/         # 微信小程序管理端服务模块
├── np-service-pc-web/               # PC前端服务模块
├── np-service-pc-admin/             # PC管理端服务模块
└── np-service-all/                  # 聚合服务模块（初期使用）
```

## 运行方式

### 方式一：聚合模式（推荐，初期使用）

运行聚合服务，所有服务在一个进程中：

```bash
# 打包
mvn clean package

# 运行
java -jar np-service-all/target/np-service-all-0.0.1-SNAPSHOT.jar
```

访问地址：http://localhost:8080/api/v1

### 方式二：独立模式（拆分后使用）

每个服务模块可以独立运行：

```bash
# 打包单个服务
mvn clean package -pl np-service-wechat-mp -am

# 运行单个服务
java -jar np-service-wechat-mp/target/np-service-wechat-mp-0.0.1-SNAPSHOT.jar
```

各服务端口：
- np-service-wechat-mp: 8081
- np-service-wechat-admin: 8082
- np-service-pc-web: 8083
- np-service-pc-admin: 8084

## 模块说明

### np-common
公共模块，包含：
- 常量定义（UserType, ClientType, Role等）
- 公共实体类（User, Order, Product等）
- 安全相关（JWT工具类、权限处理器）
- 公共工具类（Result、Exception、Annotation）
- 公共配置类（RedisConfig、MyBatisConfig）
- 公共Mapper接口

### np-service-wechat-mp
微信小程序端服务（药店老板）
- 端口：8081
- 用户类型：pharmacy_owner

### np-service-wechat-admin
微信小程序管理端服务（业务员）
- 端口：8082
- 用户类型：business_staff

### np-service-pc-web
PC前端服务（连锁店采购）
- 端口：8083
- 用户类型：chain_purchaser

### np-service-pc-admin
PC管理端服务（业务员、内勤、超级业务员、管理员）
- 端口：8084
- 用户类型：business_staff, super_business_staff, internal_staff, admin

### np-service-all
聚合服务模块（初期使用）
- 端口：8080
- 聚合所有服务模块

## 开发说明

1. 公共代码放在 `np-common` 模块
2. 各服务模块的Controller、Service放在对应模块中
3. 配置文件在各模块的 `src/main/resources/application.yml`
4. 初期开发使用 `np-service-all` 模块运行
5. 后续可以按需拆分服务模块独立部署

## 技术栈

- Spring Boot 3.5.9
- Java 17
- MyBatis Plus 3.5.5
- MySQL 8.0
- Redis 6.0+