# backend

**Repository Path**: wangpanA/backend

## Basic Information

- **Project Name**: backend
- **Description**: tcm-backend
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-02-15
- **Last Updated**: 2025-10-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TCM System - 后端服务

本项目是 TCM System 的后端部分，基于 Spring Boot 实现。

## 项目描述

提供 TCM System 所需的后台管理功能和 API 接口，包括但不限于：

*   用户管理
*   质检任务管理
*   药材管理
*   订单管理
*   系统配置等

## 技术栈

*   **框架**: Spring Boot 2.7.0
*   **语言**: Java 17
*   **构建工具**: Maven
*   **数据库**: MySQL (使用 Druid 连接池)
*   **数据访问**: MyBatis-Plus, MyBatis
*   **其他**: Lombok, Spring Security (加密)

## 环境要求

*   **JDK**: 17 或更高版本
*   **Maven**: 3.6 或更高版本
*   **MySQL**: 5.7 或更高版本 (推荐 8.0+)

## 项目设置

1.  **克隆仓库**:
    ```bash
    git clone <your-repository-url>
    cd tcm-system/backend
    ```

2.  **数据库配置**:
    *   确保你有一个正在运行的 MySQL 实例。
    *   在 MySQL 中创建一个数据库，例如 `tcm_system`。
    *   修改 `src/main/resources/application.properties` 文件，配置正确的数据库连接信息：
        ```properties
        spring.datasource.url=jdbc:mysql://<你的数据库主机>:<端口>/tcm_system?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai&allowPublicKeyRetrieval=true&useSSL=false
        spring.datasource.username=<你的数据库用户名>
        spring.datasource.password=<你的数据库密码>
        ```
        **注意**: 请将 `<你的数据库主机>`, `<端口>`, `<你的数据库用户名>`, `<你的数据库密码>` 替换为实际值。默认配置指向 `localhost:3306`，请确认是否需要修改。

3.  **数据库初始化 (如果需要)**:
    *   如果项目包含数据库初始化脚本 (例如在 `src/main/resources/db/migration` 或类似目录下)，请按照相应说明执行。
    *   (如果项目使用 Flyway 或 Liquibase，Maven 构建时可能会自动执行迁移)。

## 构建项目

在项目根目录 (`backend` 目录下) 运行 Maven 命令：

```bash
mvn clean package
```

该命令会编译代码、运行测试（如果有）并将应用打包成一个可执行的 JAR 文件，通常位于 `target/` 目录下 (例如 `target/backend-0.0.1-SNAPSHOT.jar`)。

## 运行项目

有两种主要方式运行应用：

1.  **使用 Maven**:
    ```bash
    mvn spring-boot:run
    ```
    这会直接启动嵌入式 Tomcat 服务器运行应用。

2.  **运行打包后的 JAR 文件**:
    ```bash
    java -jar target/backend-0.0.1-SNAPSHOT.jar
    ```
    (请将 `backend-0.0.1-SNAPSHOT.jar` 替换为实际生成的 JAR 文件名)

应用启动后，默认会在 `http://localhost:8080` (端口可在 `application.properties` 中修改 `server.port`) 监听请求。


## 注意事项

*   确保 JDK 和 Maven 环境变量配置正确。
*   检查防火墙设置，确保应用端口和数据库端口可以访问。