AnimeLog

一个面向动画爱好者的追番日志应用，把「番剧管理」「单集记录」和「外部番剧搜索导入」集中在同一套前后端分离项目里。

项目简介

AnimeLog 是一个仍在持续打磨中的追番记录项目。当前仓库已经完成第一版可运行形态，覆盖了从账号登录、个人追番库、番剧搜索，到单集日志沉淀的完整闭环。

它不只是一个简单的番剧清单，更偏向“个人追番工作台”：

• 可以管理自己的想看、在看、看完、搁置和弃番状态
• 可以给具体某一集写日志、打分、记录心情和标记神回
• 可以查看最近追番时间线，把碎片化记录重新串起来
• 可以从外部数据源搜索番剧并一键加入本地追番库

ps:vibe coding

核心亮点

1. 从追番列表到单集日志的完整记录链路

项目同时支持作品级和单集级的管理方式。你可以先把一部番加入追番列表，再继续维护观看进度、备注、评分，以及每一集的观后感。

2. 更像“工作台”的首页体验

首页不是单纯的信息堆叠，而是围绕当前追番节奏来组织内容：统计概览、正在追的作品、最近日志、神回记录，都能在一个界面里集中查看。

3. 支持外部番剧搜索与导入

当前版本已经接入外部番剧搜索能力。搜索后可以先看作品信息，再决定是否加入自己的追番列表，减少手动录入成本。

4. 面向继续开发的前后端分离结构

仓库按前端、后端、SQL、文档拆分，适合个人持续迭代，也适合后续补充部署、数据同步、资源上传等功能。

页面与功能概览

登录 / 注册

• 支持账号注册与登录
• 登录后使用 JWT 维持鉴权状态

工作台首页

• 展示追番统计摘要
• 聚合“在看”作品
• 展示最近日志时间线
• 展示神回记录

我的追番

• 管理个人追番列表
• 支持状态筛选、详情查看、进度维护
• 可维护评分、备注、收藏等信息

搜索番剧

• 支持按作品名、别名或原名搜索
• 可查看外部番剧详情
• 可将外部作品一键加入本地追番列表

番剧详情

• 查看作品基础资料
• 查看当前作品下的追番记录与日志内容
• 为具体集数新增或修改单集日志

个人中心

• 查看当前账号信息
• 修改昵称、头像、邮箱、简介和密码

页面展示预留

当前 README 先预留展示区域，后续可以补充真实页面截图或 GIF 演示。

首页工作台

这里可放首页总览截图，突出统计卡片、最近日志和神回记录区。

番剧搜索页

这里可放搜索结果页截图，展示外部番剧搜索与一键追番流程。

番剧详情页

这里可放番剧详情与单集日志区域截图，体现“作品信息 + 单集记录”的组合体验。

技术栈

前端

• Vue 3
• Vite
• TypeScript
• Pinia
• Vue Router

后端

• Java 21
• Spring Boot 3
• MyBatis
• PageHelper
• JWT
• Lombok

数据与接口

• MySQL 8.x
• Druid 连接池
• Redis 依赖已接入
• Springdoc OpenAPI / Swagger UI

项目结构

myweb/
├─ anime-log-web/      # Vue 3 + Vite 前端
├─ anime-log-server/   # Spring Boot + MyBatis 后端
├─ sql/                # 数据库初始化脚本
└─ doc/                # 需求、接口和初始化说明文档

快速启动

环境要求

• Java 21
• Node.js ^20.19.0 || >=22.12.0
• MySQL 8.x
• Maven 3.9+

1. 初始化数据库

执行数据库脚本：

sql/anime_log_db.sql

默认数据库名为 anime_log_db。

如需首次体验初始化账号信息，可查看 SQL 脚本中的初始化数据。

2. 启动后端

后端目录：

cd anime-log-server

启动命令：

mvn spring-boot:run

默认配置位于：

• anime-log-server/src/main/resources/application.yaml
• anime-log-server/src/main/resources/application-dev.yml

默认后端服务地址：

http://localhost:8080

3. 启动前端

前端目录：

cd anime-log-web

安装依赖：

npm install

启动开发环境：

npm run dev

默认前端访问地址：

http://localhost:5173

接口文档与开发说明

后端已集成 Springdoc OpenAPI，启动后可直接访问接口文档：

http://localhost:8080/doc.html

前端开发环境已通过 Vite 配置 /api 代理到后端：

http://localhost:8080

因此本地联调时，通常只需要分别启动前后端即可。

当前状态与后续方向

当前仓库已经完成 AnimeLog 第一版可运行版本，适合继续迭代。后续可以继续完善的方向包括：

• 更完整的外部数据源同步与缓存策略
• 图片/资源上传能力
• 更细致的番剧详情与日志编辑体验
• 部署方案、容器化和生产环境配置

补充文档

如果你想进一步了解项目设计背景，可以查看 doc 目录中的现有文档，例如：

• doc/追番日志馆-需求分析与功能模块设计.md
• doc/追番日志馆-接口文档.md
• doc/项目初始化说明.md