# woniunote

**Repository Path**: yunjinqi/woniunote

## Basic Information

- **Project Name**: woniunote
- **Description**: 使用flask、html、css和mysql建的个人博客，目前已经在个人网站(yunjinqi.top)上运行
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: dev_cpp
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2023-04-29
- **Last Updated**: 2026-10-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# WoniuNote - 云子量化博客系统

<div align="center">

[![C++](https://img.shields.io/badge/C++-17+-00599C.svg)](https://isocpp.org/)
[![Drogon](https://img.shields.io/badge/Drogon-1.9+-blue.svg)](https://github.com/drogonframework/drogon)
[![Vue](https://img.shields.io/badge/Vue-3.4+-4FC08D.svg)](https://vuejs.org/)
[![Element Plus](https://img.shields.io/badge/Element%20Plus-2.5+-409EFF.svg)](https://element-plus.org/)
[![License](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)

**高性能前后端分离的个人博客系统，基于 C++ Drogon + Vue 3 + Element Plus**

🌐 **在线演示**: [https://www.yunjinqi.top](https://www.yunjinqi.top)

[中文](#-项目简介) | [English](#-english-version)

</div>

---

## 📖 项目简介

WoniuNote（蜗牛笔记）是一个博客系统，采用**前后端分离架构**，使用高性能 C++ 后端，提供文章发布、用户管理、评论互动、数学训练等完整功能。

### 🎯 技术架构

| 层级 | 技术栈 | 说明 |
|------|--------|------|
| **前端** | Vue 3 + Vite 5 + Element Plus + Pinia | 现代化 SPA 单页应用 |
| **后端** | C++ 17 + Drogon + JWT + bcrypt | 高性能异步 API 服务 |
| **数据库** | MySQL 8.0 + Redis | 持久化存储 + 缓存加速 |
| **部署** | Nginx + HTTPS + systemd | 生产环境部署 |

---

## 🌟 项目特色

- **高性能后端** - C++ Drogon 框架，比 Python 快 5-10 倍，低延迟高吞吐
- **前后端分离** - Vue 3 SPA + RESTful API，开发部署灵活
- **安全防护** - JWT 认证、bcrypt 密码加密、CORS 保护、API 限流
- **现代 UI** - Element Plus 组件库、响应式设计
- **丰富功能** - 文章管理、用户系统、评论互动、数学训练
- **生产就绪** - Nginx + HTTPS、systemd 服务管理、完整部署脚本

---

## 🏗️ 项目结构

```
woniunote/
├── 📁 backend_cpp/                  # C++ 后端服务 (Drogon)
│   ├── main.cc                      # 应用入口
│   ├── config.json                  # 开发环境配置
│   ├── config.prod.json             # 生产环境配置
│   ├── CMakeLists.txt               # CMake 构建配置
│   ├── vcpkg.json                   # vcpkg 依赖清单
│   ├── controllers/                 # API 控制器
│   │   ├── AuthController           # 认证 (登录/注册/登出)
│   │   ├── ArticleController        # 文章 (CRUD/搜索/分类)
│   │   ├── CommentController        # 评论 (评论/回复/投票)
│   │   ├── FavoriteController       # 收藏管理
│   │   ├── UserController           # 用户信息
│   │   ├── AdminController          # 管理后台
│   │   ├── UploadController         # 文件上传
│   │   ├── CreditController         # 积分系统
│   │   ├── CaptchaController        # 验证码
│   │   ├── MathTrainingController   # 数学训练
│   │   └── SystemController         # 系统状态
│   ├── core/                        # 核心模块
│   │   ├── config.h/cc              # 配置加载
│   │   ├── database.h/cc            # 数据库工具
│   │   ├── security.h/cc            # JWT + bcrypt
│   │   └── logger.h/cc              # 日志工具
│   ├── models/                      # 数据模型
│   └── filters/                     # 中间件 (认证/限流)
│
├── 📁 frontend/                     # Vue 3 前端应用
│   ├── src/
│   │   ├── api/                     # Axios API 封装
│   │   ├── components/              # 公共组件
│   │   ├── views/                   # 页面视图
│   │   │   ├── Home.vue             # 首页
│   │   │   ├── ArticleDetail.vue    # 文章详情
│   │   │   ├── Category.vue         # 分类页
│   │   │   ├── Search.vue           # 搜索页
│   │   │   ├── WriteArticle.vue     # 写文章
│   │   │   ├── UserCenter.vue       # 用户中心
│   │   │   ├── MathTraining.vue     # 数学训练
│   │   │   ├── Login.vue            # 登录
│   │   │   ├── Register.vue         # 注册
│   │   │   └── admin/               # 管理后台
│   │   ├── stores/                  # Pinia 状态管理
│   │   ├── router/                  # Vue Router 路由
│   │   └── main.js                  # 入口文件
│   ├── package.json                 # Node.js 依赖
│   └── vite.config.js               # Vite 构建配置
│
├── 📁 scripts/                      # 部署和管理脚本
│   ├── setup_ubuntu.sh              # Ubuntu 环境配置
│   ├── database_transfer.sh         # 数据库导出与迁移
│   ├── update_nginx_ssl.sh          # 更新 Nginx 配置
│   ├── renew_ssl.sh                 # SSL 证书申请与续订
│   ├── update_thumbs.sh             # 手动更新文章缩略图
│   └── sql/                         # 数据库脚本
│
├── 📁 configs/                      # 配置文件
│   ├── woniunote_nginx_prod.conf    # Nginx 生产配置
│   └── yunjinqi.top_nginx/          # 本地/服务器 SSL 证书目录（不入库）
│
├── 📁 docs/archive/legacy-flask-tests/  # 旧 Flask 测试归档（迭代19 迁入，非当前主线门禁）
├── 📁 docs/                         # 项目文档
├── start_app.sh                     # 一键启动脚本
├── stop_app.sh                      # 停止脚本
└── restart_app.sh                   # 重启脚本
```

---

## 🌿 分支与版本

| 项 | 值 |
|---|---|
| 活跃开发分支 | `dev_cpp`（同时是 GitHub 仓库当前的**默认分支**） |
| 历史主线分支 | `master`（Flask 时代主线；当前不接收活跃开发） |
| 当前发行版本 | `2.0.0`（源码发行：C++ Drogon 后端 + Vue 3 前端） |
| 版本唯一来源 | `backend_cpp/CMakeLists.txt` 的 `project(... VERSION)` |

版本号在 `backend_cpp/CMakeLists.txt`、`frontend/package.json` 与 `backend_cpp/vcpkg.json`
三处必须一致，由 `bash scripts/check_release_version.sh` 校验（CI 的 `repo-hygiene` job 会执行）。
注意区分：旧 `setup.py`（0.1.5）、英文 README 的 0.1.4 徽章和 Sphinx 文档站的 1.0.0
都是**历史口径**，不代表本次 C++/Vue 发行版本。

API 路由前缀 `/api/...` 与产品发行号无关，两者独立演进。

---

## 🚀 快速开始

### 环境要求

| 组件 | 版本 | 必需 |
|------|------|------|
| C++ 编译器 | GCC 10+ / Clang 13+ / MSVC 2019+ | ✅ |
| CMake | 3.20+ | ✅ |
| vcpkg | 固定基线 `e7b524242c8a5d718a7afa26794c3c19bb8b0c71`（见 `backend_cpp/vcpkg.json`） | ✅ |
| Node.js | >= 20.19.0（CI 与部署验收版本：22.13.0） | ✅ |
| MySQL | 8.0+ | ✅ |
| Redis | 6.0+ | ❌ (可选，推荐) |

> 前端依赖以 `frontend/package-lock.json` 为准：安装必须使用 `npm ci`（不要删除锁文件或改用 `npm install`）。
> `frontend/package.json` 的 `engines` 声明最低 Node 版本，`npm run check:node` 可在安装/构建前校验。

### 方式一：一键启动（推荐）

```bash
# 克隆项目
git clone https://github.com/cloudQuant/woniunote.git
cd woniunote

# 开发模式 (前端热重载)
bash start_app.sh dev

# 生产模式 (构建前端 + Nginx 服务)
bash start_app.sh prod

# 访问
# 前端: http://localhost:8888
# 后端 API: http://localhost:5173
```

### 方式二：手动启动

#### 1. 编译并启动后端

```bash
cd backend_cpp

# 安装 vcpkg (如未安装)
git clone https://github.com/microsoft/vcpkg.git ~/vcpkg
~/vcpkg/bootstrap-vcpkg.sh

# 编译
mkdir build && cd build
cmake .. -DCMAKE_TOOLCHAIN_FILE=~/vcpkg/scripts/buildsystems/vcpkg.cmake
cmake --build . --config Release -j8

# 配置数据库连接
cp ../config.json .
# 编辑 config.json 设置数据库密码等

# 启动
./woniunote_backend
# 后端运行在 http://localhost:5173
```

#### 2. 启动前端

```bash
cd frontend

# 安装依赖
npm install

# 开发模式
npm run dev
# 访问: http://localhost:8888

# 生产构建
npm run build
```

### 方式三：生产环境部署 (Ubuntu 22.04 + HTTPS)

#### 1. 运行环境配置脚本

```bash
# 需要 root 权限
sudo bash scripts/setup_ubuntu.sh
```

此脚本会自动安装:
- 系统依赖 (build-essential, cmake, nginx 等)
- MySQL 8.0 和 Redis
- Node.js 22.x（若已安装的 Node 低于前端 `engines` 要求则自动升级）
- vcpkg 和 C++ 依赖包
- 编译 C++ 后端

前端依赖使用 `npm ci` 按锁文件安装；Node 版本不满足 `frontend/package.json` 的
`engines`（>= 20.19.0）时脚本会明确报错，而不是继续构建。

#### 2. 配置数据库

```bash
mysql -u root -p

CREATE DATABASE woniunote CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'woniunote_user'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON woniunote.* TO 'woniunote_user'@'localhost';
FLUSH PRIVILEGES;
```

#### 3. 配置并启动

```bash
# 编辑生产配置
nano backend_cpp/config.prod.json

# 更新 Nginx 配置
sudo bash scripts/update_nginx_ssl.sh

# 启动服务
bash restart_app.sh prod
```

**访问地址**: https://www.yunjinqi.top

---

## 数据库导出与迁移

`scripts/database_transfer.sh` 用于在开发、测试和生产环境间迁移当前 C++ 后端使用的 MySQL 数据库。导出的压缩 SQL 文件包含数据库定义、全部数据表及数据、触发器、存储过程和事件；每次导出还会生成 SHA-256 校验文件和不含密码的元数据文件。

脚本默认优先读取未纳入版本控制的 `backend_cpp/config.local.json`，其次读取 `backend_cpp/config.json`。运行机器需要安装 `mysql`、`mysqldump` 和 `gzip`。

### 常用命令

```bash
# 1. 导出当前数据库到 ./backups/（该目录已被 Git 忽略）
bash scripts/database_transfer.sh export

# 2. 使用明确的环境配置导出，例如生产配置
bash scripts/database_transfer.sh export --config backend_cpp/config.prod.json

# 3. 在目标机器导入到同名且为空的数据库
bash scripts/database_transfer.sh import backups/woniunote_YYYYMMDDTHHMMSSZ.sql.gz

# 4. 确认需要覆盖时，删除并重建已有目标数据库
bash scripts/database_transfer.sh import --replace backups/woniunote_YYYYMMDDTHHMMSSZ.sql.gz

# 5. 不落盘密码，临时覆盖目标机器连接参数
WONIUNOTE_DB_HOST=db.example.com \
WONIUNOTE_DB_PORT=3306 \
WONIUNOTE_DB_NAME=woniunote \
WONIUNOTE_DB_USER=woniunote_user \
WONIUNOTE_DB_PASSWORD='请替换为目标密码' \
bash scripts/database_transfer.sh import backups/woniunote_YYYYMMDDTHHMMSSZ.sql.gz
```

### 导入保护与验证

导入时会自动进行 gzip 完整性、SHA-256 和表数量校验。备份不包含密码；目标环境可配置 `backend_cpp/config.local.json`，也可设置上例中的 `WONIUNOTE_DB_*` 环境变量。为避免误恢复，导入端的数据库名必须与备份中的名称一致；若目标库已有表，脚本会拒绝执行，只有显式添加 `--replace` 才会覆盖。

可通过以下命令运行脚本契约测试；测试使用临时的模拟客户端，不会连接任何真实数据库：

```bash
bash scripts/tests/test_database_transfer.sh
```

---

## SSL 证书更新

`scripts/renew_ssl.sh` 负责 `yunjinqi.top` / `www.yunjinqi.top` 的 Let's Encrypt 证书申请与续订，采用 HTTP-01 webroot 验证。脚本需要**在生产服务器上以 root 运行**（依赖 `certbot`、`nginx` 与 `/etc/letsencrypt`），本地开发机无需执行。

一次完整的续订流程为：申请/续订证书 → 复制到 `configs/yunjinqi.top_nginx/` → 重载 Nginx → 打印证书有效期。

| 配置项 | 值 |
|--------|-----|
| 域名 | `yunjinqi.top`、`www.yunjinqi.top` |
| 验证方式 | HTTP-01（webroot） |
| 验证目录 | `/root/woniunote/frontend/dist` |
| 证书落盘 | `configs/yunjinqi.top_nginx/yunjinqi.top_bundle.pem`、`yunjinqi.top.key` |
| 续订日志 | `/var/log/certbot-renew.log` |

### 首次安装与开启自动续订

在新服务器上执行一次即可，脚本会安装 `certbot`、签发首张证书，并写入自动续订的 cron 任务：

```bash
cd /root/woniunote
sudo bash scripts/renew_ssl.sh install
```

cron 任务为 `0 3 1 */2 *`，即**每两个月的 1 号凌晨 3:00**（1/3/5/7/9/11 月）执行一次。Let's Encrypt 证书有效期 90 天，60 天一次的频率足以落在到期前 30 天的续订窗口内。

安装完成后可确认任务是否生效：

```bash
sudo crontab -l | grep renew_ssl
```

### 手动续订

证书临近到期或需要立即更换时执行：

```bash
cd /root/woniunote
sudo bash scripts/renew_ssl.sh renew
```

`renew` 同时是不带参数时的默认命令。脚本使用 `--keep-until-expiring`，若证书尚未进入续订窗口，certbot 会提示 `Certificate not yet due for renewal` 并跳过签发，此时沿用现有证书，属于正常行为。

### 查看证书状态

```bash
# 查看 certbot 管理的全部证书及到期时间
sudo bash scripts/renew_ssl.sh status

# 查看证书文件的生效与到期时间
openssl x509 -in configs/yunjinqi.top_nginx/yunjinqi.top_bundle.pem -noout -dates

# 从任意机器验证线上实际生效的证书
echo | openssl s_client -servername yunjinqi.top -connect yunjinqi.top:443 2>/dev/null \
  | openssl x509 -noout -dates
```

### 关闭自动续订

```bash
sudo bash scripts/renew_ssl.sh uninstall
```

该命令只移除 cron 任务，不会删除已签发的证书。

### 续订失败排查

| 现象 | 排查方向 |
|------|----------|
| `Permission denied` | 未使用 `sudo` 运行 |
| HTTP-01 验证失败 | 确认 80 端口可从公网访问（云服务器安全组需放行），且 Nginx 中 `server_name yunjinqi.top` 的 80 端口配置块存在 `location /.well-known/acme-challenge/` 并指向 `/root/woniunote/frontend/dist` |
| `too many certificates already issued` | 触发 Let's Encrypt 限流（同域名每周 5 张），停止重试并等待一周 |
| 浏览器仍显示旧证书 | 确认 `systemctl reload nginx` 成功，且 Nginx 配置中的 `ssl_certificate` 指向 `configs/yunjinqi.top_nginx/` 下的证书 |

排查时先看日志：

```bash
sudo tail -50 /var/log/certbot-renew.log
```

---

## 文章缩略图更新

文章列表卡片的缩略图是构建产物：`backend_cpp/scripts/generate_thumbs.py` 为每个文章分类渲染一张 226×136 的 PNG，输出到 `backend_cpp/resource/thumb/<type>.png`（该目录不入库），前端通过 `/api/thumb/<type>.png` 读取。

每张图由「分类名 + 分隔线 + 一行 4 个关键词」构成。关键词有两条来源，走哪条由分类下的文章数量决定：

| 来源 | 触发条件 | 说明 |
|------|----------|------|
| **内容词** | 分类下文章 ≥ 20 篇 | 从该分类所有文章的标题与正文抽取，按词频排序，过滤词性和单篇噪声 |
| **精选词** | 文章不足 20 篇 | 使用脚本内置的 `TYPE_KEYWORDS` / `ROOT_KEYWORDS`，保证不出现无意义的词 |

分界线是脚本顶部的 `MIN_ARTICLES_FOR_CONTENT`。文章归类整理好之后，调低这个值即可让更多分类改用内容词。

### 自动生成

`start_app.sh` 启动时会先跑一次 `--check`：缩略图齐备就跳过，只有缺失才生成。日常重启不会重复渲染。

### 手动更新

文章内容或分类变动后，用下面的脚本主动重建：

```bash
# 全量重建（约 4 秒）
bash scripts/update_thumbs.sh

# 只预览关键词、不生成图片——先确认词对不对，再决定要不要出图
bash scripts/update_thumbs.sh --dry-run

# 只重建指定分类，其余分类的图会保留
bash scripts/update_thumbs.sh --only 101,102
```

执行顺序为：环境自检 → 数据库连通性检查 → 生成到临时目录 → 校验尺寸 → 原子替换。**任一步失败都不会改动现有缩略图**；数据库连不上会明确报错，而不是静默退回精选词。

### 直接调用生成器

需要更细的控制时可以直接用 Python 入口，参数含义与上面一致：

```bash
python3 backend_cpp/scripts/generate_thumbs.py --dry-run
python3 backend_cpp/scripts/generate_thumbs.py --only 101
python3 backend_cpp/scripts/generate_thumbs.py --check          # 缺图时退出码为 1
python3 backend_cpp/scripts/generate_thumbs.py --output-dir /tmp/thumbs
```

### 依赖

生成需要 Python 的 `Pillow`、`jieba`、`PyMySQL`，以及一款中文字体（macOS 自带 Hiragino Sans GB；Ubuntu 需 `apt-get install fonts-noto-cjk`）。缺任何一项时脚本会在自检阶段报错并给出安装命令。

> 更新后浏览器可能仍显示旧图——前端按 `THUMB_VERSION` 缓存。若未变化，重启后端或强制刷新页面。

---

## 🔧 核心功能

### 📝 内容管理
- **文章系统** - 支持原创/转载/翻译，富文本编辑器 (UEditor)
- **分类管理** - 多级分类、灵活的文章归类
- **搜索功能** - 关键词搜索、分类筛选

### 👥 用户系统
- **认证授权** - JWT Token 认证、bcrypt 密码加密
- **用户注册** - 验证码保护
- **个人中心** - 资料管理、头像上传、密码修改
- **角色权限** - 普通用户/管理员

### 💬 互动功能
- **评论系统** - 文章评论、多级回复、点赞
- **收藏功能** - 收藏文章、收藏管理
- **积分系统** - 用户活跃度积分

### 🧮 数学训练
- **口算练习** - 加减乘除四则运算
- **难度分级** - 多难度级别
- **成绩记录** - 答题统计

### 🛠️ 管理后台
- **文章审核** - 待审核文章管理
- **用户管理** - 用户列表、权限控制
- **系统监控** - 健康检查、数据库状态
- **数据统计** - 访问量、文章统计

---

## 🛠️ 技术栈

### 后端技术 (C++)

| 技术 | 说明 |
|------|------|
| **Drogon** | 高性能 C++ 异步 Web 框架 |
| **jwt-cpp** | JWT Token 认证 |
| **OpenSSL** | 加密、bcrypt 密码哈希 |
| **jsoncpp** | JSON 解析 |
| **hiredis** | Redis 客户端 |
| **libmariadb** | MySQL 客户端 |
| **spdlog** | 高性能日志库 |

### 前端技术

| 技术 | 说明 |
|------|------|
| **Vue 3.4** | 渐进式 JavaScript 框架 |
| **Vite 5** | 下一代前端构建工具 |
| **Element Plus 2.5** | Vue 3 UI 组件库 |
| **Pinia** | Vue 3 状态管理 |
| **Vue Router** | 官方路由管理器 |
| **Axios** | HTTP 请求库 |

### 基础设施

| 组件 | 说明 |
|------|------|
| **MySQL 8.0** | 主数据库 |
| **Redis 6.0+** | 缓存、限流 |
| **Nginx** | 反向代理、HTTPS、静态资源 |
| **vcpkg** | C++ 包管理器 |

---

## 🧪 测试

当前发布门禁以 C++ Drogon 后端与 Vue 前端为准。`docs/archive/legacy-flask-tests/`（原根目录 `tests/`，迭代19 迁入）是旧 Flask 栈测试归档，不再作为当前主线覆盖率来源。

```bash
# 后端 C++ 单元测试
cd backend_cpp/build
ctest --output-on-failure

# 后端 HTTP 集成测试（需要测试 MySQL/Redis）
cd ../..
bash backend_cpp/tests/integration/run_integration.sh

# 前端 lint / 单测覆盖率 / 构建 / E2E
cd frontend
npm run lint:ci
npm run test:coverage
npm run build
npm run test:e2e

# 前端生产依赖安全审计
# 本机 registry 若指向 npmmirror 等镜像，audit endpoint 不可用，须用下面的脚本走官方 registry
npm run audit:ci
```

---

## 📚 API 文档

### 主要 API 端点

| 模块 | 端点 | 说明 |
|------|------|------|
| **认证** | `/api/auth/login`, `/api/auth/register`, `/api/auth/logout` | 登录/注册/登出 |
| **用户** | `/api/auth/me`, `/api/users/{id}`, `/api/users/profile`, `/api/users/password` | 用户信息/资料/密码 |
| **文章** | `/api/articles`, `/api/articles/{id}`, `/api/articles/hot`, `/api/articles/types` | 文章 CRUD/列表/分类 |
| **评论** | `/api/comments/article/{id}`, `/api/comments`, `/api/comments/{id}/vote` | 评论/回复/点赞 |
| **收藏** | `/api/favorites`, `/api/favorites/{articleId}`, `/api/favorites/check/{articleId}` | 收藏管理 |
| **积分** | `/api/credits/balance`, `/api/credits/history`, `/api/credits/pay-article/{id}` | 积分查询/支付 |
| **数学** | `/api/math-training/records`, `/api/math-training/wrong-answers`, `/api/math-training/summary` | 数学训练 |
| **上传** | `/api/upload/image`, `/api/upload/file`, `/api/upload/avatar` | 文件上传 |
| **验证码** | `/api/captcha/generate`, `/api/captcha/verify` | 验证码 |
| **管理** | `/api/admin/stats`, `/api/admin/users`, `/api/admin/articles` | 管理后台 |
| **系统** | `/api/system/health`, `/api/system/status` | 健康检查 |

---

## 🤝 贡献指南

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

### 开发规范

- 后端遵循 C++17 / Drogon 现有控制器、模型、过滤器组织方式
- 前端遵循 Vue 3 Composition API 风格
- 提交前运行当前主线测试和代码检查（见“测试”章节）
- 添加适当的注释和文档

---

## 📄 许可证

本项目采用 MIT 许可证 - 详见 [LICENSE](LICENSE) 文件

---

## 📧 联系方式

- **作者**: yunjinqi (云金杞)
- **邮箱**: yunjinqi@gmail.com
- **网站**: [yunjinqi.top](http://yunjinqi.top)
- **GitHub**: [github.com/cloudQuant](https://github.com/cloudQuant)

---

## 🌐 English Version

### Overview

WoniuNote is a high-performance personal blog system for quantitative investment, built with **C++ Drogon + Vue 3 + Element Plus** using a frontend-backend separation architecture.

### Features

- **High Performance** - C++ Drogon framework, 5-10x faster than Python
- **Modern Frontend** - Vue 3 SPA + Element Plus
- **Security** - JWT authentication, bcrypt password hashing, rate limiting
- **Rich Features** - Articles, comments, favorites, math training
- **Production Ready** - Nginx + HTTPS, systemd service management

### Quick Start

```bash
# Clone
git clone https://github.com/cloudQuant/woniunote.git
cd woniunote

# Development mode
bash start_app.sh dev

# Production mode
bash start_app.sh prod

# Frontend: http://localhost:8888
# Backend API: http://localhost:5173
```

### Tech Stack

| Layer | Technologies |
|-------|-------------|
| **Frontend** | Vue 3.4 + Vite 5 + Element Plus + Pinia |
| **Backend** | C++ 17 + Drogon + JWT + bcrypt |
| **Database** | MySQL 8.0 + Redis |
| **Deployment** | Nginx + HTTPS + systemd |

### API Endpoints

| Module | Endpoints | Description |
|--------|-----------|-------------|
| Auth | `/api/auth/*` | Login, Register, Logout |
| Articles | `/api/article/*` | CRUD, Search, Categories |
| Comments | `/api/comment/*` | Comment, Reply, Vote |
| Favorites | `/api/favorite/*` | Bookmark management |
| Users | `/api/user/*` | User profile |
| Math | `/api/math/*` | Math training |
| Admin | `/api/admin/*` | Admin dashboard |

### License

MIT License - see [LICENSE](LICENSE) for details.

---

⭐ 如果这个项目对你有帮助，请给一个 Star！

⭐ If this project helps you, please give it a star!