# LinkKeeper

**Repository Path**: codewarning/linkkeeper

## Basic Information

- **Project Name**: LinkKeeper
- **Description**: 在线书签，探寻llm在项目中的运用；技术栈：springboot、mysql、redis、vue3、ts、mybatis plus、通义千问大模型
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-25
- **Last Updated**: 2026-01-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 在线书签管理系统 (Online Bookmark)

这是一个功能完善的在线书签管理平台，采用前后端分离架构。用户可以轻松管理自己的网络书签，进行分类、标记、优先级排序，并支持访问历史统计。

## ✨ 功能特性

- **用户认证**: 支持用户注册、登录、登出，基于 JWT Token 进行身份验证。
- **书签管理**: 
  - 添加、编辑、删除书签
  - 支持收藏、置顶、优先级设置
  - 自动解析网页标题与图标，AI推荐分组、打标签
  - 访问次数统计与最近访问记录
- **分类体系**:
  - **分组管理**: 自定义分组名称、图标，支持拖拽排序
  - **标签管理**: 为书签打标签，支持多标签筛选
- **数据安全**: 基于租户/用户的数据隔离，确保隐私安全
- **高性能**: 后端使用 Redis 缓存 Token，配合 MyBatis-Plus 高效处理数据库操作

## 🛠 技术栈

### 后端 (Backend)
- **核心框架**: Java, Spring Boot
- **ORM**: MyBatis-Plus
- **数据库**: MySQL
- **缓存**: Redis
- **安全**: Spring Security, JWT

### 前端 (Frontend)
- **核心框架**: Vue 3
- **构建工具**: Vite
- **状态管理**: Pinia
- **UI 样式**: SCSS

## 📂 项目结构

```
online-bookmark/
├── frontend/                # 前端项目 (Vue 3 + Vite)
│   ├── public/             # 静态资源
│   ├── src/                # 源代码
│   │   ├── api/            # API 接口封装
│   │   ├── layout/         # 布局组件
│   │   ├── page/           # 页面视图
│   │   ├── router/         # 路由配置
│   │   ├── store/          # 状态管理
│   │   └── styles/         # 全局样式
│   └── index.html          # 入口文件
│
├── backend/                 # 后端项目 (Spring Boot)
│   ├── app/                 # 主应用程序
│   │   ├── src/main/java/org/elias/app/
│   │   │   ├── config/     # 配置类 (Web, Security, CORS)
│   │   │   ├── controller/ # 控制器 (API 接口)
│   │   │   ├── manager/    # 业务逻辑层
│   │   │   ├── pojo/       # 数据传输对象 (Form, Resp)
│   │   │   └── security/   # 安全相关组件
│   │   └── resources/      # 配置文件
│   ├── common/             # 公共模块 (工具类, 异常, 枚举)
│   ├── dao/                # 数据访问层
│   │   ├── entity/         # 数据库实体类
│   │   ├── mapper/         # MyBatis Mapper 接口
│   │   └── service/        # 服务层实现
│   └── ai/                 # AI 扩展模块
│
└── sql/                    # 数据库 SQL 脚本
```

## 🚀 快速开始

### 环境要求
- JDK 21+
- Node.js 18+
- MySQL 8.0+
- Redis 6.0+

### 后端配置

1. **初始化数据库**: 执行 `sql/schema.sql` 创建数据库表结构。
2. **配置数据库**: 修改 `backend/app/src/main/resources/application-custom.yml` 中的数据库连接信息。
3. **配置 Redis**: 确保 Redis 服务已启动，并在配置文件中指定地址。
4. **运行项目**:
   ```bash
   cd backend
   mvn spring-boot:run
   ```
   服务默认运行在 `http://localhost:8080`。

### 前端配置

1. **安装依赖**:
   ```bash
   cd frontend
   pnpm install
   ```
2. **启动开发服务器**:
   ```bash
   pnpm dev
   ```
   或构建生产版本:
   ```bash
   pnpm build
   ```