# BalloonWords

**Repository Path**: ddddduo/BalloonWords

## Basic Information

- **Project Name**: BalloonWords
- **Description**: BallonWords是一个轻量化中文语句灵感平台，致力于用技术赋予文字生命力。我们旨在让灵感如气球般在云端自在漂浮，让经典台词、网络金句、文学摘录等碎片化灵感以气球性的方式飘进数字世界，构建一个持续生长的开放式语句库。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: https://dddddduo.github.io/BalloonWords/
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-31
- **Last Updated**: 2025-04-12

## Categories & Tags

**Categories**: Uncategorized

**Tags**: Redis, ElasticSearch, RabbitMQ, cannel, workflows

## README

# BallonWords 🎈  
**——让文字灵感如气球般自由漂浮，飞向无限的云端**

## ⭐ 项目 Github Star 走势
[![Star History Chart](https://api.star-history.com/svg?repos=Dddddduo/BalloonWords&type=Date)](https://star-history.com/#Dddddduo/BalloonWords&Date)

## 🎪 项目介绍  
BallonWords 是一个轻量级中文语句灵感平台，致力于为文字注入生命力。通过动态气球特效，我们将每一句打动人心的文字承载在气球上，让经典台词、网络金句、文学摘录等灵感以趣味化的方式漂浮于数字世界，逐步构建一个持续扩展的开放式语句库。

这个项目如同用JVM编织的气球艺术展，Java集合框架在其中构成了气球捆绑绳，而LinkedList则定义了它们的飘动轨迹。借助动态对象池技术，我们让每个语句都成为一个可悬浮的 **BalloonEntity**，在Spring应用上下文的气流中优雅律动。

我们的愿景是让每个字节都绽放成充满哲理的气球，轻盈地悬浮在现实与想象的交汇点。

## 📖 官方文档

详细开发指南、API文档及设计规范请访问官方文档：  [https://dddddduo.github.io/BalloonWords/](https://dddddduo.github.io/BalloonWords/)

## 🌌 项目灵感  

<div align="center">
  <img src="https://ooo.0x0.ooo/2025/02/14/OGQ8z6.jpg" width="30%">
  <p>✨ 每个词句都是幸运兔手中的气球 ✨</p>
</div>

## ✅ 已实现功能和后期展望 (通过这个项目你可以学到)
  - [x] 词库管理数据库表的设计
  - [x] 初始化get接口的实现
  - [x] 根据标签去查询语句
  - [x] 引入消息队列RabbitMQ解耦
  - [x] 前端接口文档的开发并且上线
  - [x] 使用异步化，线程池，分布式锁做并发控制
  - [x] 面向AOP编程，实现日志管理 
  - [x] 引入redis缓存降低数据库查询的压力，采用延迟双删+乐观锁
  - [x] 引入Elasticsearch完善搜索引擎，定制化搜索
  - [x] Docker Compose一键部署
  - [x] Github自动化Workflows配置，maven项目跑CI/CD流程，代码覆盖率检查
  - [x] 使用jmeter进行压力测试，并完成报告
  - [ ] 使用cannel实时检测mysql
  - [ ] 完成前端管理界面(vue) 并且使用satoken完成鉴权处理

## - 🌱 开发日志
**2.10 - 2.12**
- 设计数据库表
- 多表联查实现首个接口 /get

**2.22 - 2.24**
- 完成基础五大接口开发
- 集成 Junit5 + MockMvc 单元测试框架

**3.01 - 3.05**
- 引入 RabbitMQ 消息队列解耦系统
- 通过 Spring 事件监听器实现上下文同步控制

**3.05 - 3.10**
- 部署 Redis 缓存降低数据库负载
- 基于 RedissonClient 实现分布式锁，防止缓存穿透

**3.10 - 3.13**
- 使用 Spring 事务管理保证写操作原子性
- 通过 @Transactional 注解配置超时与异常回滚策略

**3.15 - 3.17**
- 集成 Elasticsearch 构建高效搜索引擎
- 优化查询性能，降低核心业务搜索压力

**3.20 - 3.21**
- 实现 Docker Compose 一键化部署方案
- 打通 IDEA 与 Docker 的容器开发调试链路

**3.22 - 3.25**
- 配置 GitHub Actions 自动化流水线
- 集成 Maven CI/CD 流程与代码覆盖率检测

**3.26 - 3.27**
- 使用 JMeter 完成全接口压力测试
- 生成性能调优报告（TPS/QPS/响应时间分析）

## - ✨ 架构演进亮点
- 缓存一致性方案
  采用延时双删策略 + 版本号乐观锁，保障 MySQL 与 Redis 数据最终一致性

- 容器化部署
  通过容器网络配置实现微服务组件的弹性扩缩容，日志采集对接 EFK 技术栈

- 事务管理强化
  在分布式场景中结合补偿事务机制，完善跨服务数据一致性保障


## 🛠️ 技术架构  

```mermaid
graph TD
    A[Java 17] --> B[Spring Boot 2.6.14] 
    B --> C[MySQL 8.0.36]
    C --> D[Redis 6]
    C --> E[Rabbitmq 3.12.4]
    B --> F[Elasticsearch 8.15.0]
    F --> G[Docker compose]
    F --> H[cannel]
```

## 🛠️ 主要数据库表关系  

![b5737b8cfced58b2f02bead1e4faac03](https://github.com/user-attachments/assets/fb562c0f-ed6a-488f-9973-33f9f7e32307)

## 🌈 创新亮点  
1. **词库气球周期轮换**  
   - 新语句：气球充气效果（渐显）  
   - 经典语句：悬浮特效，停留在屏幕上  
   - 旧语句：定期自动飘出视野范围  

2. **实时同步气球特效**  
   - 使用HashMap对气球进行标签化分组（如：励志红、哲理蓝、诗词青）  
   - 利用PriorityQueue排列近期热门语句的显示优先级  
   - 过时语句执行SoftReference柔性回收

## 🚀 快速开始  
![image](https://github.com/user-attachments/assets/6445c01b-d2e7-4cd6-9dd8-97fa657aaf38)

```bash
# 获取随机语句
curl https://api.ballonwords.com/get

# 示例响应
{
   "content": "你好像在等十九世纪的青洄，可我是北纬六十七度以北的雪",
    "tagName": [
      "青春",
      "故事"
    ]
}
```

## 📦 词库管理  
- 支持JSON/YAML格式批量导入  
- 自动去重校验（基于MD5和语义校验）  
- 词库支持热更新，无需重启服务

### 调整重点：
1. 技术描述围绕“Ballon”隐喻展开，简化了部分技术内容。
2. 突出Java集合框架在词库管理中的关键作用。
3. 直观展示了气球交互的逻辑，降低了架构的复杂度。

## 🧑💻 核心开发者  
**点击图片跳转至个人主页**

<a href="https://github.com/Dddddduo">
  <img src="https://ooo.0x0.ooo/2025/02/15/OG0Mbq.jpg" width="200" />
</a>

## 🤝 贡献者  
感谢以下贡献者（按贡献时间排序）  

<a href="https://github.com/yapi0420" style="display: block; text-align: center; margin-top: 10px;">
  <img src="https://avatars.githubusercontent.com/u/188179474?v=4" width="100" />
</a>
<a href="https://github.com/666mch" style="display: block; text-align: center; margin-bottom: 10px;">
  <img src="https://avatars.githubusercontent.com/u/176784073?v=4" width="100" />
</a>

## 📜 协作规范
1. **代码仓库地址**：https://github.com/Dddddduo/balloonWords
2. **代码提交**：请遵循[Angular提交规范](https://github.com/angular/angular/blob/main/CONTRIBUTING.md)  
3. **分支管理**：
    ```bash 
   git checkout -b feat/your-feature  # 新功能开发 
   git checkout -b fix/issue-number   # Bug修复
    ```

**注意事项**：
- 新功能开发请使用`feature/功能名称`分支。
- 问题修复使用`bugfix/问题描述`分支。
- 提交代码需通过ESLint检查 [1]。
- 重大变更需更新`CHANGELOG.md`文件。

🕊️ 让每个灵感都能自由飞翔 —— BallonWords 开发组 🎈