# full_stack

**Repository Path**: dailycreatebug/full_stack

## Basic Information

- **Project Name**: full_stack
- **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-08-12
- **Last Updated**: 2026-08-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TaskFlow · 智能任务协作平台

> CBCC 全栈转型评审项目 —— 基于 **Vue 3 + Spring Boot 3** 的全栈任务协作系统，含 RBAC 权限、看板拖拽、AI 辅助、活动审计。

## 一、项目简介

TaskFlow 是一个轻量级团队任务协作平台，支持项目-成员-任务的层级管理、看板式（待办/进行中/已完成）任务流转、拖拽排序、评论协作，并内置 **AI 助手**（一句话拆解任务、项目进展总结、自动周报）。

**核心特性：**
- 🔐 JWT 双 Token 认证 + RBAC 五表权限模型 + 项目级数据权限（OWNER/EDITOR/VIEWER）
- 📋 看板视图，HTML5 拖拽流转，乐观更新失败回滚
- 🗄️ MyBatis-Plus + MySQL，复杂联表查询 / 聚合统计 / 执行计划优化
- 💼 `@Transactional` 事务（状态流转同事务写审计日志）
- 🤖 AI 能力（可接真实 LLM，默认 Mock 演示），调用成本审计
- 📝 全局异常处理 + 统一响应 + AOP 操作日志
- 🧪 JUnit5 + Mockito 单测/集成测试 + JaCoCo 覆盖率
- 📚 Knife4j 在线 API 文档

## 二、技术栈

| 层 | 技术 |
|----|------|
| 前端 | Vue 3.4（`<script setup>` + TS）· Vite 5 · Pinia · Vue Router · Element Plus · Axios |
| 后端 | Spring Boot 3.2 · Spring Security 6 · MyBatis-Plus 3.5 · MySQL 8 · JJWT 0.12 |
| 工具 | Knife4j(OpenAPI3) · Hutool · MapStruct · Logback · JaCoCo · JUnit5 · Mockito |

## 三、目录结构

```
full_stack/
├── server/                      # 后端 Spring Boot
│   ├── src/main/java/com/cbcc/taskflow/
│   │   ├── common/              # Result/异常/常量/注解
│   │   ├── config/              # MybatisPlus/Security/Knife4j/CORS/数据初始化
│   │   ├── security/            # JWT/过滤器/UserDetailsService/权限
│   │   ├── aspect/              # 操作日志 AOP 切面
│   │   ├── controller/          # 9 个 RESTful 控制器
│   │   ├── service/  impl/      # 业务逻辑层
│   │   ├── mapper/              # MyBatis 接口
│   │   ├── entity/ dto/ vo/     # 领域对象分层
│   │   └── enums/               # 状态机/枚举
│   └── src/main/resources/      # application.yml / mapper XML / schema.sql / logback
├── web/                         # 前端 Vue3
│   └── src/
│       ├── api/                 # Axios 封装(取消竞态/错误处理) + 模块接口
│       ├── stores/              # Pinia 状态(分层)
│       ├── router/  layout/     # 路由守卫 + 布局
│       ├── views/               # 页面(容器组件)
│       ├── components/          # 展示/通用组件
│       └── composables/         # usePermission 等
└── docs/                        # 详细设计 / 数据库设计 / API / SQL 优化
```

## 四、快速启动

### 前置依赖
- JDK 17+（开发机为 21）、Maven 3.6+、Node 18+、MySQL 8

### 1. 初始化数据库
```bash
mysql -u root -p123456 < server/src/main/resources/db/schema.sql
```
> 默认账号由 `DataInitializer` 在后端启动时自动创建：**admin/admin123**（管理员）、**test/test123**（普通用户）。

### 2. 启动后端（:8090）
```bash
cd server
mvn spring-boot:run
```
启动后访问 API 文档：http://localhost:8090/doc.html

### 3. 启动前端（:8091）
```bash
cd web
npm install
npm run dev
```
浏览器打开 http://localhost:8091 ，使用 admin/admin123 登录。

## 五、评审点对照

| 评审项 | 落地说明 | 文档/证据 |
|--------|----------|-----------|
| 项目结构与分层 | Controller/Service/Mapper/Entity/DTO/VO 严格分离 | `server` 源码 |
| RESTful API | 资源化命名、HTTP 方法语义、状态码 | [API 文档](docs/api.md) · Knife4j |
| 代码逻辑 | 命名规范、Service 拆分、注释 | 源码 |
| 认证授权 | JWT 双 Token + RBAC 五表 + 项目级数据权限 | [设计文档](docs/design.md) |
| 异常处理 | 自定义异常体系 + `@RestControllerAdvice` 全局拦截 | `common/exception` |
| 日志 | SLF4J/Logback + AOP 操作日志切面 | `aspect/OperationLogAspect` |
| 测试 | JUnit5 + Mockito + MockMvc + JaCoCo | `server/src/test` |
| 数据库 SQL | 复杂联表 / 聚合统计 / 执行计划优化 | [数据库设计](docs/database-design.md) |
| 事务 | `@Transactional` 状态流转 + 审计 | `TaskServiceImpl` |
| 全栈整合 | 前后端联调 + Postman 集合 | [演示说明](docs/demo.md) |
| 文档 | 详细设计 / 表结构 / API | `docs/` |
| AI | AI 拆任务/总结/周报 + 成本审计 | [AI Spec](docs/ai-spec.md) |

## 六、账号与权限

| 账号 | 密码 | 角色 | 说明 |
|------|------|------|------|
| admin | admin123 | ROLE_ADMIN | 全部权限（`*:*:*` 通配） |
| test | test123 | ROLE_USER | 普通用户，需被加入项目才能访问 |