# Publish — AI 日报分发平台

私有化部署的日报/周报管理与分发平台。后端 Spring Boot + SQLite，前端 Vue 3 + Vite。

## 快速开始

### 开发

```bash
# 后端（需要 Java 21）
./mvnw.cmd spring-boot:run

# 前端
pnpm install
pnpm dev  # → http://localhost:41733
```

### 部署

本项目使用**宝塔面板**部署（不是 Docker）。

```bash
powershell -File deploy/package.ps1
# 生成 deploy/publish_deploy.zip
# 上传到服务器 /usr/local/publish_dishboard/ 解压覆盖
```

完整部署步骤见 [deploy/README.md](deploy/README.md)

## 文档

- [API.md](API.md) — 完整 API 文档
- [CHANGELOG.md](CHANGELOG.md) — 更新日志
- [deploy/README.md](deploy/README.md) — 部署说明

## 项目结构

```
publish/
├── src/main/java/com/reportdist/   # Spring Boot 后端
│   ├── controller/                 # REST API
│   ├── service/                    # 业务逻辑
│   ├── repository/                 # JPA 仓储
│   ├── entity/                     # 数据库实体
│   ├── dto/                        # 数据传输对象
│   └── exception/                  # 异常处理
├── src/                            # Vue 3 前端
│   ├── pages/                      # 页面
│   ├── components/                 # 组件
│   ├── composables/                # 组合式 API
│   └── router/                     # 路由
├── deploy/                         # 部署脚本与说明
├── pom.xml                         # Maven 配置
└── package.json                    # 前端依赖
```

## 技术栈

- **后端**：Spring Boot 3.2.5 + Spring Data JPA + SQLite + Apache POI + PDFBox
- **前端**：Vue 3.4 + Vite 5 + TailwindCSS 4 + Axios
- **构建**：Maven + pnpm
- **部署**：宝塔面板 (Java 21 + Node.js)

## 端口约定

| 服务 | 端口 |
|------|------|
| 后端 (Spring Boot) | 30081 |
| 前端 (Node.js static server) | 30080 |
| 开发模式 - Vite | 41733 |

## 许可证

私有项目