# kfapp-backend

**Repository Path**: zhang-junbaocom/kfapp-backend

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-01-13
- **Last Updated**: 2025-03-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 康复系统配置指南

## 环境要求

- JDK 1.8+
- Maven 3.6+
- MongoDB 4.4+
- IDE推荐：IntelliJ IDEA2024.3.3

## 开发环境配置

### 1. MongoDB安装与配置

1. 下载并安装MongoDB Community Server：
   - 访问：https://www.mongodb.com/try/download/community
   - 选择Windows版本下载并安装
   - 建议选择"Complete"安装方式
   - 安装MongoDB Compass（可视化工具）

2. 数据库初始化：
   ```bash
   # 启动MongoDB
   mongod --dbpath="D:\data\db"
   
   # 使用MongoDB Compass连接
   mongodb://localhost:27017
   
   # 创建数据库
   use kfapp
   ```

### 2. 项目配置

1. 克隆项目到本地：
   ```bash
   git clone <project-url>
   ```

2. 修改配置文件 `src/main/resources/application.yaml`：
   ```yaml
   spring:
     data:
       mongodb:
         uri: mongodb://localhost:27017/kfapp
         database: kfapp
   
   server:
     port: 9000
     servlet:
       context-path: /api/v1
   ```

3. 安装Maven依赖：
   ```bash
   mvn clean install
   ```

### 3. IDE配置

1. 在IDEA中导入项目：
   - File -> Open -> 选择项目目录
   - 等待Maven下载依赖
   - 确保Project Structure中JDK版本为1.8

2. 配置运行环境：
   - Edit Configurations
   - 添加Spring Boot配置
   - Main class: `com.example.kfapp.KfappApplication`
   - Active profiles: `dev`

## 项目启动

1. 确保MongoDB服务已启动

2. 运行项目：
   - IDE中直接运行KfappApplication
   - 或使用命令行：`mvn spring-boot:run`

3. 访问接口文档：
   - http://localhost:9000/api/v1/swagger-ui.html

## 接口测试

1. 默认接口基础路径：`http://localhost:9000/api/v1`

2. 测试登录接口：
   ```bash
   POST /auth/login
   Content-Type: application/json
   
   {
     "username": "admin",
     "password": "123456"
   }
   ```

3. 获取到token后，在其他请求的Header中添加：
   ```
   
   Authorization: Bearer <your-token>
   ```

## 常见问题

1. MongoDB连接失败：
   - 检查MongoDB服务是否启动
   - 检查连接字符串是否正确
   - 检查防火墙设置

2. 端口占用：
   - 修改application.yaml中的server.port
   - 或关闭占用端口的程序

3. 依赖下载失败：
   - 检查Maven设置
   - 尝试使用阿里云镜像：
     ```xml
     <mirrors>
       <mirror>
         <id>alimaven</id>
         <mirrorOf>central</mirrorOf>
         <name>aliyun maven</name>
         <url>http://maven.aliyun.com/nexus/content/groups/public/</url>
       </mirror>
     </mirrors>
     ```

## 开发建议

1. 使用Postman或Swagger UI测试接口
2. 开发时启用debug日志级别
3. 使用MongoDB Compass监控数据库
4. 遵循项目的代码规范和提交规范

## 联系方式

如有问题，请联系项目维护者：
- Email: 190176784@qq.com
- 微信: your-wechat-id