ISLI 证书存证认证系统 (ISLI-Cert-System)

基于 JDK 21 + Spring Boot 3 + JOOQ 构建的现代化数字资产存证平台

📌 项目简介

本项目旨在为 ISLI (国际标准关联标识符) 提供高效、可信的数字资产登记、存证与证书生成服务。 采用了 2025 年主流的现代化 Java 技术栈，摒弃了传统的 MyBatis XML 与笨重的线程池模式，全面拥抱 类型安全 DSL 与 虚拟线程。

核心能力

• 证书生成：基于 Headless Browser (Playwright) 的高保真 HTML 转图片渲染，完美支持 Tailwind CSS。
• 高并发：利用 JDK 21 虚拟线程处理任务调度框架、海量 ISLI 编码轮询与入库;
• 支付集成：支付宝当面付/网页支付集成。
• 存证上链：(TODO)

🛠 技术栈 (Tech Stack)

后端基座

• Language: Java 21 (LTS) - Record, Pattern Matching, Virtual Threads
• Framework: Spring Boot 4.0.0
• Container: Docker & Docker Compose (V2)

数据存储与访问

• Database: MySQL 8.0.33
• Cache: Redis 7.2 (Alpine)
• ORM: JOOQ (Java Object Oriented Querying) - 告别 XML，代码即 SQL
• Migration: Flyway - 数据库版本控制

关键组件

• Rendering: Microsoft Playwright - 新一代无头浏览器渲染引擎
• Testing: Testcontainers - 构建时自动拉起数据库生成代码
• File Storage: 本地文件系统 (MD5 三级打散存储)

🚀 快速开始 (Quick Start)

1. 环境准备

• JDK 21+
• Docker & Docker Compose
• Maven 3.9+

2. 启动依赖环境

本项目集成了 Spring Boot Docker Compose 支持，只需点击 IDE 的 Run 按钮，MySQL 和 Redis 会自动启动。

如果你习惯命令行，也可以手动启动：

docker-compose up -d

3. 配置文件说明

项目包含多环境配置：

• application.yml: 通用配置
• application-dev.yml: 本地开发 (开启 Debug 日志，模拟回调)
• application-prod.yml: 生产环境 (严谨配置)

注意：本地开发时，支付回调地址需配合内网穿透工具 (如 Natapp) 使用。

💻 核心开发规范

1. 数据库操作 (JOOQ)

• 禁止 手写 JDBC SQL 字符串。
• 禁止 在 Service 层裸写 DSL，请封装在 Repository/Dao 层。
• 查询：简单 CRUD 使用生成的 DAO，复杂查询使用 DSLContext。
• 分页：遵循 Count + Limit/Offset 模式。

2. 异步任务

• IO 密集型 (如 HTTP 请求)：使用 Virtual Threads (已全局启用)。
• 业务解耦 (如 注册->发证)：使用 Spring Event + @Async。

3. 代码生成

数据库表结构变更后，请运行以下命令重新生成 Java 代码：

mvn clean generate-sources

注：构建时会自动启动 Testcontainers 临时容器进行生成，确保代码与 SQL 脚本一致。

📦 部署指南 (Deployment)

推荐使用 Docker 容器化部署。

构建镜像

docker build -t isli-cert-system:v1.0 .

注意：Dockerfile 基于 Ubuntu (Eclipse Temurin) 镜像构建，已内置中文字体支持 Playwright 渲染，请勿随意更换为 Alpine。

docker run -d -p 8080:8080 \
--name isli-cert \
-e SPRING_PROFILES_ACTIVE=prod \
isli-cert-system:v1.0

📝 维护者

• Owner: [Luzg de Valois]
• Email: [[email protected]]

Generated by Your Gemini 3 Pro Preview (AI) ⚡️

• 哈基米哦南北绿豆
• 哈洗嘎纳哈呀库
• 欧妈吉里叮咚鸡
• 叮咚叮咚哈基米
• 大狗一段带一段
• 漫波越打越难捋
• 哈呀酷哦哈基米

好滋味,且去也