# LoveWorld

**Repository Path**: ww522/love-world

## Basic Information

- **Project Name**: LoveWorld
- **Description**: 情侣空间小程序
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-08-31
- **Last Updated**: 2025-12-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 情侣世界 (LoveWorld)

一个专为情侣设计的微信小程序，帮助情侣记录美好时光、管理共同计划、分享甜蜜回忆。

## 项目结构

```
LoveWorld/                          # 项目根目录
├── README.md                       # 项目说明文档
├── PROJECT_SUMMARY.md              # 项目总结文档
├── API.md                          # API接口文档
├── database.sql                    # 数据库建表脚本
├── docs/                           # 项目文档目录
│   └── ...
├── backend/                        # 后端服务目录
│   ├── src/                        # 源代码目录
│   │   ├── main/
│   │   │   ├── java/
│   │   │   │   └── com/loveworld/
│   │   │   │       ├── controller/     # 控制器层
│   │   │   │       ├── service/        # 业务逻辑层
│   │   │   │       ├── mapper/         # 数据访问层
│   │   │   │       ├── entity/         # 实体类
│   │   │   │       ├── dto/            # 数据传输对象
│   │   │   │       ├── config/         # 配置类
│   │   │   │       ├── enums/          # 枚举类
│   │   │   │       └── LoveWorldApplication.java
│   │   │   └── resources/
│   │   │       ├── application.yml     # 应用配置
│   │   │       └── mapper/             # MyBatis映射文件
│   │   └── test/                       # 测试代码
│   ├── target/                         # 编译输出目录
│   ├── pom.xml                         # Maven依赖配置
│   └── README.md                       # 后端说明文档
└── frontend/                           # 前端小程序目录
    ├── pages/                          # 页面目录
    │   ├── login/                      # 登录页
    │   ├── couple/                     # 情侣空间页
    │   ├── index/                      # 首页(记录列表)
    │   ├── memory/                     # 发布记录页
    │   ├── photo/                      # 照片相册页
    │   ├── plan/                       # 计划列表页
    │   ├── plan-create/                # 创建计划页
    │   └── profile/                    # 个人中心页
    ├── utils/                          # 工具类目录
    │   ├── api.js                      # API接口封装
    │   └── util.js                     # 通用工具函数
    ├── components/                     # 自定义组件
    ├── styles/                         # 全局样式
    ├── app.js                          # 小程序逻辑
    ├── app.json                        # 小程序配置
    ├── app.wxss                        # 全局样式
    ├── project.config.json             # 项目配置
    ├── sitemap.json                    # 站点地图
    └── README.md                       # 前端说明文档
```

## 技术栈

### 后端技术
- **框架**: Spring Boot 2.7.x
- **数据库**: MySQL 8.0
- **ORM**: MyBatis Plus
- **认证**: JWT + 微信小程序登录
- **文档**: Swagger/OpenAPI 3.0
- **构建工具**: Maven

### 前端技术
- **框架**: 微信小程序原生框架
- **UI组件**: Vant Weapp
- **开发工具**: 微信开发者工具

## 快速开始

### 环境要求
- JDK 11+
- Maven 3.6+
- MySQL 8.0+
- Node.js 16+
- 微信开发者工具

### 后端启动
```bash
# 进入后端目录
cd backend

# 安装依赖
mvn install

# 启动服务
mvn spring-boot:run
```

### 前端启动
1. 用微信开发者工具打开 `frontend` 目录
2. 配置小程序 AppID
3. 修改 `app.js` 中的后端 API 地址
4. 编译并预览

### 数据库配置
1. 创建数据库：`CREATE DATABASE love_world`
2. 执行建表脚本：`database.sql`
3. 修改后端配置：`backend/src/main/resources/application.yml`

## 功能特性

### 核心功能
- 🔐 微信授权登录
- 💑 情侣关系管理
- 📝 美好回忆记录
- 📷 照片相册管理
- 📅 未来计划制定
- 👤 个人中心管理

### 技术特性
- 🏗️ 前后端分离架构
- 🎨 响应式UI设计
- 🔒 JWT身份认证
- 📱 原生小程序开发
- 💾 MySQL数据存储
- 📖 完整API文档

## 开发规范

### 后端开发规范
- 遵循RESTful API设计
- 统一返回格式：Result<T>
- 分层架构：Controller -> Service -> Mapper
- 统一异常处理
- 参数校验注解

### 前端开发规范
- 组件化开发
- 统一样式规范
- API统一封装
- 错误统一处理
- 用户体验优化

## 部署说明

### 生产环境部署
1. 后端打包：`mvn clean package`
2. 上传 jar 文件到服务器
3. 配置生产环境数据库
4. 启动服务：`java -jar love-world-backend.jar`
5. 前端上传到微信小程序后台

### 配置说明
- 后端配置：`backend/src/main/resources/application.yml`
- 前端配置：`frontend/app.js` 中的 baseUrl

## 贡献指南

1. Fork 项目
2. 创建功能分支
3. 提交更改
4. 推送到分支
5. 创建 Pull Request

## 许可证

MIT License

## 联系方式

如有问题或建议，请提交 Issue 或 Pull Request。

---

**注意**: 在正式部署前，请确保已正确配置所有环境变量和数据库连接。