# smartdesk

**Repository Path**: kuang_ren/smartdesk

## Basic Information

- **Project Name**: smartdesk
- **Description**: 智桌项目仓库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-13
- **Last Updated**: 2026-06-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 智桌 (SmartDesk)

面向中小学教师的桌面效率工具 — 本地安全处理学生数据，云端 AI 批量生成评语。

**功能**：分波交付 — MVP(beta) → v2.0.0 → v2.0.5 → v2.1.0。详见 [功能全景图](docs/features/PM-功能全景图.md) 与 Skill [quick-reference](.cursor/skills/smartdesk-dev/quick-reference.md)。

## 项目结构

```
├── SmartDeskClient/   Java 17 + JavaFX 21 桌面客户端
├── SmartDeskServer/   Java 17 + Spring Boot 3.2 云端服务
├── SmartDeskWeb/      Vue 3 + Element Plus 管理后台
└── docs/              需求与设计文档
```

## 快速开始

### Server

```bash
cd SmartDeskServer
mvn spring-boot:run
# 健康检查: http://localhost:8080/api/health
```

### Client

```bash
cd SmartDeskClient
mvn javafx:run
```

### Web

```bash
cd SmartDeskWeb
npm install
npm run dev
# 默认: http://localhost:5173
```

## 技术栈

| 组件 | 技术 |
|------|------|
| Client | JavaFX 21, SQLite, Apache POI |
| Server | Spring Boot 3.2, JPA, MySQL 8 |
| Web | Vue 3, Vite, Element Plus |

## 文档

- 总规格书：[docs/智桌-SmartDesk-需求规格书-v2.md](docs/智桌-SmartDesk-需求规格书-v2.md)
- 模块文档：[docs/features/README.md](docs/features/README.md)
- 开发约束 Skill：[.cursor/skills/smartdesk-dev/SKILL.md](.cursor/skills/smartdesk-dev/SKILL.md)

## 仓库

https://gitee.com/kuang_ren/smartdesk