# your_bloom

**Repository Path**: oftenlin/your_bloom

## Basic Information

- **Project Name**: your_bloom
- **Description**: Your bloom starts here. 你的绽放，由此开始, 让努力，一直暖暖的
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-13
- **Last Updated**: 2025-09-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 暖守伴 (YourBloom) - 智能生产力伴侣

> Your bloom starts here. 你的绽放，由此开始, 让努力，一直暖暖的

## 🌟 项目简介

暖守伴是一个AI驱动的智能生产力伴侣应用，通过**智能拆解、情感化陪伴、游戏化激励**三大核心价值，帮助用户克服拖延、清晰路径、建立自信，最终形成目标达成的正向循环。

### 核心价值
- **懂你** - AI智能解析自然语言目标
- **陪你** - 情感化陪伴与问责机制  
- **激励你** - 游戏化成长体系与正反馈

## 🎯 目标用户

1. **进取型专业人士** - 复杂项目管理与OKR达成
2. **自律挑战者** - 习惯培养与外部激励需求
3. **创意自由职业者** - 项目结构化与防遗漏
4. **轻度拖延症患者** - 执行力提升与温和推力

## 🏗️ 系统架构

### 技术栈
- **后端**: Python Flask + MySQL + Flask-Admin
- **前端**: React (Web/Admin) + React Native (Mobile) + Taro (MiniProgram) + Electron (Desktop)
- **AI服务**: OpenAI API集成
- **部署**: Docker + Kubernetes

### 项目结构
```
├── backend/                 # Flask后端服务
│   ├── app/                 # 应用源码
│   ├── config/              # 配置文件
│   ├── migrations/          # 数据库迁移
│   └── requirements.txt     # Python依赖
├── frontend/                # 多端前端应用
│   ├── web/                 # 用户Web端 (React)
│   ├── admin/               # 后台管理系统 (React)
│   ├── mobile/              # 移动端 (React Native)
│   ├── miniprogram/         # 微信小程序 (Taro)
│   ├── desktop/             # 桌面端 (Electron)
│   └── shared/              # 多端共享代码
├── docs/                    # 项目文档
│   ├── 1-产品需求/          # 产品设计文档
│   ├── 2-架构设计/          # 技术架构设计
│   ├── 3-UI设计/            # 视觉设计系统
│   ├── 4-开发测试/          # 开发规范指南
│   └── 5-部署/              # 部署运维文档
└── README.md               # 项目说明文档
```

## 📋 核心功能模块

### MVP 一期功能
1. **用户系统** - 手机号/微信登录、用户管理
2. **任务管理** - 手动/AI创建、多视图展示、标签系统
3. **陪伴系统** - 逾期关怀问卷、完成庆祝
4. **激励系统** - 积分规则、自定义奖励池
5. **动态系统** - 活动流记录与自然语言叙述
6. **后台管理** - 数据统计、用户洞察、系统监控

### 特色功能
- 🧠 **智能目标解析** - NLP自然语言处理
- ❤️ **情感化陪伴** - 逾期关怀而非简单失败标记
- 🎮 **游戏化激励** - 多维积分与自定义奖励
- 📊 **深度分析** - 用户行为模式识别与洞察

## 🚀 快速开始

### 环境要求
- Python 3.8+
- Node.js 16+
- MySQL 5.7+
- Docker (可选)

### 开发环境设置

#### 后端开发
```bash
cd backend
python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或 venv\Scripts\activate  # Windows

pip install -r requirements.txt
# 配置环境变量后运行
python run.py
```

#### 前端开发
```bash
cd frontend/web    # Web端
npm install
npm run dev

cd frontend/admin  # 管理后台  
npm install
npm run dev

cd frontend/mobile # 移动端
npm install
npm run android/ios
```

### 生产部署

使用 Docker 快速部署：
```bash
cd backend
docker-compose up -d
```

详细部署说明请参考 `docs/5-部署/testing-deployment.md`

## 📚 文档资源

### 产品设计
- `docs/1-产品需求/暖守伴产品设计.md` - 产品定位与核心价值
- `docs/1-产品需求/暖守伴系统功能需求规格说明书.md` - MVP功能规格

### 技术架构  
- `docs/2-架构设计/architecture-design.md` - 系统架构设计
- `docs/2-架构设计/database-schema.md` - 数据库设计
- `docs/2-架构设计/api-specification.md` - API接口规范

### UI设计
- `docs/3-UI设计/视觉系统设计规范.md` - 完整设计系统
- `docs/3-UI设计/设计系统实施指南.md` - 开发实施指南
- `docs/3-UI设计/design-tokens.json` - Design Token定义
- `docs/3-UI设计/css-variables.css` - CSS变量实现

### 开发规范
- `docs/4-开发测试/code-organization.md` - 代码组织与最佳实践
- `docs/4-开发测试/development-roadmap.md` - 开发路线图
- `docs/4-开发测试/development-setup.md` - 开发环境设置

### 部署运维
- `docs/5-部署/testing-deployment.md` - 测试与部署指南

## 🛠️ 开发规范

### 代码风格
- **Python**: PEP8规范，使用black格式化
- **TypeScript**: ESLint + Prettier
- **Git**: Conventional Commits规范

### 提交信息格式
```
feat: 添加新功能
fix: 修复bug
docs: 文档更新
style: 代码格式调整
test: 测试相关
refactor: 代码重构
chore: 构建过程或辅助工具变动
```

## 🤝 贡献指南

1. Fork 本项目
2. 创建特性分支 (`git checkout -b feature/AmazingFeature`)
3. 提交更改 (`git commit -m 'feat: Add some AmazingFeature'`)
4. 推送到分支 (`git push origin feature/AmazingFeature`)
5. 开启Pull Request

## 📄 许可证

本项目采用 MIT 许可证 - 查看 [LICENSE](LICENSE) 文件了解详情

## 🏆 开发团队

- **产品设计**: 暖守伴产品团队
- **技术开发**: 全栈开发团队
- **UI/UX设计**: 设计系统团队

## 📞 联系我们

- 项目主页: [YourBloom Official Site]
- 问题反馈: [GitHub Issues]
- 邮箱: contact@yourbloom.com

---

**让努力，一直暖暖的** ❤️