# AI个人空间1

**Repository Path**: jaffehe/aimywkspace1

## Basic Information

- **Project Name**: AI个人空间1
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-16
- **Last Updated**: 2026-10-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 个人 AI 工作台（AiWorkbench）

面向个人全栈开发者的一站式工作台：**工作（赚钱主线）· 生活（家庭与精神）· 学习（能力增长）**，并内置 AI 助手（DeepSeek）。

- 📄 产品需求：[docs/PRD.md](docs/PRD.md)
- 🏗️ 架构设计：[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)
- 🤖 AI 助手接入：[docs/AI-MODULE.md](docs/AI-MODULE.md)

## 功能速览

| 模块 | 核心能力 |
|------|----------|
| 工作 | 项目（全职/兼职分类）、**费用管理**（固定收费 / 浮动分成）、月度目标、需求、任务；开发进度 + 收费进度双进度 |
| 生活 | 生活记录（家庭琐事/温情时刻/情绪时间轴）、计划、家庭旅行 |
| 学习 | 学习目标（英语 / AI 等方向，KR + 自评进展）、学习打卡、单词本（SM-2）、AI 知识库 |
| 仪表盘 | 收入全景（应收/已收/逾期）、目标进度、学习趋势、家庭记录回顾 |
| AI 助手 | 学习问答、摘要入库、任务拆解、月度复盘（DeepSeek，草稿需人工确认） |

## 技术栈

- 后端：JDK 17 + Spring Boot 3.5 + Spring Security(JWT) + JPA（H2 默认 / MySQL 8 可切）
- 前端：Vue 3 + Vite + Element Plus + ECharts + Pinia
- 部署：Docker Compose

## 快速开始

### 方式一：本地开发

```bash
# 后端（默认 H2 内存/文件库，开箱即用）
cd backend && mvn spring-boot:run

# 前端
cd frontend && npm install && npm run dev
```

- 后端：<http://localhost:8080>（Swagger：`/swagger-ui.html`）
- 前端：<http://localhost:5173>
- 首次启动自动写入演示数据（`DataSeeder`）

### 方式二：Docker

```bash
cp .env.example .env   # 填入 DEEPSEEK_API_KEY 等
docker compose up -d --build
```

### 切换 MySQL

```bash
mvn spring-boot:run -Dspring-boot.run.profiles=mysql
# 连接信息见 backend/src/main/resources/application-mysql.yml 或环境变量
```

## 配置要点

| 项 | 方式 | 说明 |
|----|------|------|
| `DEEPSEEK_API_KEY` | 环境变量 / `.env` | AI 助手开关；未配置则 AI 功能置灰，其余不受影响 |
| `JWT_SECRET` | 环境变量 | 不配置则启动随机生成并告警 |
| 数据库 | profile | 默认 H2；`mysql` profile 切换 MySQL 8 |

## 文档约定

功能变更时同步更新 `docs/` 下三份文档：PRD（需求）、ARCHITECTURE(架构/数据模型)、AI-MODULE(AI 能力与配置)。