# 贯的

**Repository Path**: yunwangshu/guandi

## Basic Information

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

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-05
- **Last Updated**: 2026-01-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 目标行动记录与可视化分享系统 - MVP版本

基于需求文档开发的MVP版本，包含核心目标管理、记录功能、手动整理和基础可视化功能。

## 技术栈

### 后端
- Java 8+
- Spring Boot 2.7.14
- MyBatis Plus 3.5.3.1
- MySQL 8.0
- Redis

### 前端
- 微信小程序（WXML + WXSS + JavaScript）
- 原生小程序开发框架

## 项目结构

```
aRelaxManage/
├── backend/                 # 后端Spring Boot项目
│   ├── src/
│   │   ├── main/
│   │   │   ├── java/com/relaxmanage/
│   │   │   │   ├── controller/     # 控制器层
│   │   │   │   ├── service/        # 服务层
│   │   │   │   ├── mapper/         # 数据访问层
│   │   │   │   ├── model/          # 实体类
│   │   │   │   ├── dto/            # 数据传输对象
│   │   │   │   └── config/         # 配置类
│   │   │   └── resources/
│   │   │       └── application.yml # 配置文件
│   │   └── test/
│   └── pom.xml                     # Maven配置
├── miniprogram/            # 微信小程序前端
│   ├── pages/              # 页面目录
│   ├── components/         # 组件目录
│   ├── utils/              # 工具函数
│   ├── app.js              # 小程序入口
│   ├── app.json            # 全局配置
│   └── app.wxss            # 全局样式
├── database/
│   └── schema.sql          # 数据库脚本
└── README.md
```

## 功能特性（MVP版本）

### 1. 目标管理
- ✅ 创建、编辑、删除目标
- ✅ 目标分类（学习/运动/工作/生活）
- ✅ 目标状态管理（进行中/暂停中/已完成/已放弃）
- ✅ 目标进度跟踪（0-100%）

### 2. 零碎记录
- ✅ 文字记录
- ✅ 关联目标
- ✅ 记录时间、地点、情绪标签、耗时
- ✅ 记录列表查看
- ✅ 时间轴视图

### 3. 手动整理功能
- ✅ 阶段管理（创建、编辑、删除阶段）
- ✅ 任务管理（创建、编辑、删除任务）
- ✅ 里程碑管理（创建、编辑、删除里程碑）

### 4. 基础可视化
- ✅ 甘特图（任务时间线）
- ✅ 时间轴图表（记录统计）

## 快速开始

### 环境要求
- JDK 1.8+
- Maven 3.6+
- MySQL 8.0+
- Redis 5.0+（可选）
- 微信开发者工具

### 数据库配置

1. 创建数据库：
```sql
CREATE DATABASE relax_manage DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
```

2. 执行数据库脚本：
```bash
mysql -u root -p relax_manage < database/schema.sql
```

### 后端启动

1. 修改数据库配置（`backend/src/main/resources/application.yml`）：
```yaml
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/relax_manage?useUnicode=true&characterEncoding=utf8&useSSL=false&serverTimezone=Asia/Shanghai
    username: root
    password: your_password
```

2. 启动后端：
```bash
cd backend
mvn clean install
mvn spring-boot:run
```

后端服务运行在：http://localhost:8080/api

### 小程序启动

1. 下载并安装[微信开发者工具](https://developers.weixin.qq.com/miniprogram/dev/devtools/download.html)

2. 配置API地址：
   - 编辑 `miniprogram/app.js`
   - 修改 `globalData.baseUrl` 为后端API地址
   - 本地开发时可使用内网穿透工具（如ngrok）或配置本地域名

3. 打开微信开发者工具：
   - 选择"导入项目"
   - 选择 `miniprogram` 目录
   - 填入AppID（可使用测试号）
   - 点击"编译"运行

4. 本地开发配置：
   - 在微信开发者工具中，点击"详情"
   - 勾选"不校验合法域名、web-view（业务域名）、TLS 版本以及 HTTPS 证书"
   - 这样可以在本地开发时访问本地API

## API接口文档

### 目标管理
- `GET /api/goals/list` - 获取目标列表
- `GET /api/goals/{id}` - 获取目标详情
- `POST /api/goals` - 创建目标
- `PUT /api/goals/{id}` - 更新目标
- `DELETE /api/goals/{id}` - 删除目标
- `PUT /api/goals/{id}/progress` - 更新进度

### 记录管理
- `GET /api/records/goal/{goalId}` - 获取目标的记录列表
- `POST /api/records` - 创建记录
- `DELETE /api/records/{id}` - 删除记录

### 阶段管理
- `GET /api/phases/goal/{goalId}` - 获取目标的阶段列表
- `POST /api/phases` - 创建阶段
- `PUT /api/phases/{id}` - 更新阶段
- `DELETE /api/phases/{id}` - 删除阶段

### 任务管理
- `GET /api/tasks/goal/{goalId}` - 获取目标的任务列表
- `POST /api/tasks` - 创建任务
- `PUT /api/tasks/{id}` - 更新任务
- `DELETE /api/tasks/{id}` - 删除任务

### 里程碑管理
- `GET /api/milestones/goal/{goalId}` - 获取目标的里程碑列表
- `POST /api/milestones` - 创建里程碑
- `PUT /api/milestones/{id}` - 更新里程碑
- `DELETE /api/milestones/{id}` - 删除里程碑

## 注意事项

1. **用户认证**：当前MVP版本使用固定的userId=1，实际项目中需要实现微信登录
2. **API地址**：小程序要求使用HTTPS，本地开发需要配置或使用内网穿透
3. **文件上传**：图片、语音上传功能未实现，后续版本需要添加
4. **数据校验**：部分数据校验较为简单，生产环境需要加强

## 后续计划

根据需求文档，后续版本将包含：
- 用户认证与授权（微信登录）
- 智能整理辅助（AI推荐）
- 社区分享功能
- 多模板可视化扩展
- 文件上传（图片、语音、视频）
- 数据统计与分析

## 许可证

MIT License