# 个人笔记学习

**Repository Path**: esylian/root

## Basic Information

- **Project Name**: 个人笔记学习
- **Description**: 个人开发，练技术！！！
纯免费！！！
可借鉴！！！
可交流！！！
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-02-23
- **Last Updated**: 2026-02-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

PerBlog - 学习笔记管理系统

一个现代化的学习笔记管理系统，支持多科目笔记、Markdown编辑、学习统计等功能。

技术栈

后端

- Java 17
- Spring Boot 3.2
- Spring Security + JWT
- Spring Data JPA + MyBatis（双重ORM支持）
- MySQL 8.x
- Redis
- Spring AOP（自动切面处理）

前端

- Vue 3
- Vite
- Pinia
- Vue Router
- Element Plus
- Axios

项目结构

    Per-blog/
    ├── backend/          # 后端项目
    │   ├── src/
    │   │   └── main/
    │   │       ├── java/com/perblog/
    │   │       │   ├── entity/        # 实体类
    │   │       │   ├── repository/    # 数据访问层
    │   │       │   ├── service/       # 业务逻辑层
    │   │       │   ├── controller/    # 控制器
    │   │       │   ├── config/        # 配置类
    │   │       │   ├── dto/           # 数据传输对象
    │   │       │   └── util/          # 工具类
    │   │       └── resources/
    │   │           └── application.yml
    │   └── pom.xml
    └── frontend/         # 前端项目
        ├── src/
        │   ├── views/     # 页面组件
        │   ├── components/# 公共组件
        │   ├── router/    # 路由配置
        │   ├── stores/    # 状态管理
        │   ├── api/       # API接口
        │   └── utils/     # 工具函数
        ├── package.json
        └── vite.config.js

快速开始

前置要求

- JDK 17+
- Node.js 18+
- MySQL 8.x
- Redis

1. 数据库配置

使用SQL脚本初始化（推荐）

项目已配置为使用SQL脚本初始化数据库表结构，确保表结构完全可控。

步骤：

1. 先创建数据库：

    CREATE DATABASE perblog CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

1. 项目启动时会自动执行 schema.sql（创建表结构）和 data.sql（初始化数据）

或者手动执行：

    # 使用schema.sql创建表结构
    mysql -u root -p < backend/src/main/resources/schema.sql

修改 backend/src/main/resources/application.yml 中的数据库连接信息。

2. 启动后端

    cd backend
    mvn spring-boot:run

后端服务将在 http://localhost:8080 启动

3. 启动前端

    cd frontend
    npm install
    npm run dev

前端应用将在 http://localhost:3000 启动

功能特性

- 用户认证：注册、登录、JWT令牌验证
- 笔记管理：创建、编辑、删除笔记，支持Markdown
- 科目管理：自定义学习科目
- 标签系统：为笔记添加标签
- 文件上传：支持附件上传和下载
- 笔记导出：支持导出为PDF
- 学习统计：今日完成、打卡记录、学习趋势
- 响应式设计：适配多种设备
- 双重ORM支持：同时兼容JPA和MyBatis
- SQL脚本初始化：使用schema.sql和data.sql管理表结构
- AOP自动处理：
  - 自动更新创建时间和修改时间
  - 自动记录用户登录时间和登录次数
  - 便于后续对接管理系统

主要页面

- /login - 登录页
- /register - 注册页
- /notes - 笔记列表
- /note/:id - 笔记编辑
- /subjects - 科目管理
- /stats - 学习统计

开发说明

后端API路径统一以 /api 开头，主要接口：

- /api/auth/* - 认证相关
- /api/notes/* - 笔记相关
- /api/subjects/* - 科目相关
- /api/stats/* - 统计相关