ReleaseFlow

Ứng dụng mã nguồn mở biến pull request đã merge thành release note có người duyệt và không thể sửa sau khi xuất bản.

ReleaseFlow là ứng dụng web mã nguồn mở (Apache-2.0) giúp một team viết release note từ chính những thay đổi đã merge. Pull request trên GitHub, merge request trên GitLab, issue hoàn thành trên Linear và Jira được ghi nhận thành change, phân loại bằng rule có thể giải thích, được AI bổ sung tóm tắt nếu bạn bật, rồi đi qua một vòng review trước khi trở thành release note. Sau khi xuất bản, note bị khóa ở cả tầng ứng dụng lẫn database.

Điểm nổi bật

Bốn nguồn thay đổi: webhook có chữ ký cho GitHub, GitLab, Linear và polling cho Jira Cloud, kèm import lịch sử 90 ngày cho GitHub và GitLab.
Phân loại theo rule trước, AI sau: OpenAI, Anthropic hoặc DeepSeek chỉ được gọi một lần cho mỗi change, và không bao giờ được xóa cờ breaking mà rule đã đặt.
Vòng đời release DRAFT → IN_REVIEW → APPROVED → PUBLISHED, mỗi change cần một quyết định của người duyệt.
Một note riêng cho từng audience (operator, contributor, end user) bằng template Mustache, tối đa năm ngôn ngữ qua DeepL.
Automation giao note đã xuất bản tới GitHub Release, Slack, email, Notion, Confluence, Microsoft Teams, Zendesk và changelog công khai có RSS.
Multi-tenant trên một schema PostgreSQL, secret mã hóa AES-256-GCM, metrics Prometheus không bao giờ mang thông tin tenant.
Thử một bản phát hành chỉ cần Docker: mỗi release kèm compose.yaml (image pin theo digest) và quickstart.sh tự sinh secret, không cần clone repository. JAR và image đi kèm SBOM, SHA256SUMS và provenance attestation để kiểm chứng.

Giao diện

Trang Change Inbox của ReleaseFlow với bộ lọc theo project, category, trạng thái và context, khung Source sync của repository acme/checkout-web, và change #109 gắn nhãn Feature đang ở trạng thái Needs review

Hình 1. Change Inbox: change được phân loại bằng rule, change breaking hoặc chưa nhận diện được chờ người duyệt

Trang release 1.4.0 đã xuất bản, ghi rõ người duyệt và người xuất bản, với các tab Contributor, End user, Operator và bản Markdown của note bên cạnh nút Copy và Download

Hình 2. Release đã xuất bản: mỗi audience một note, bị khóa thành snapshot bất biến

Toàn bộ tour bằng ảnh chụp màn hình đi qua một release từ workspace trống đến note được giao tới email, Slack, Notion và changelog công khai.

Công nghệ

Java 21 · Spring Boot 4 · PostgreSQL · Flyway · Thymeleaf · Tailwind CSS · Alpine.js · Docker · Prometheus · Grafana

ReleaseFlow là một modular monolith: một Maven module, một file JAR, nhưng code được chia theo năng lực sản phẩm (change, release, audience, automation…). Công việc chạy nền dùng các bảng hàng đợi trong PostgreSQL với FOR UPDATE SKIP LOCKED, nên nhiều instance có thể chạy cùng lúc mà không cần message broker hay leader election.

Trạng thái hiện tại

Bản đầu tiên, v0.1.0, được phát hành ngày 23/09/2026 với toàn bộ các lát cắt trong kế hoạch ban đầu. Bản mới nhất là v0.2.1 (03/10/2026): v0.1.1 sửa các lỗi phát hiện khi chạy trọn một release trên môi trường demo, v0.2.0 thêm quickstart bundle, và repository hiện có 31 ADR ghi lại các quyết định kiến trúc. Một số phần vẫn được cố ý để lại: đổi vai trò hoặc xóa thành viên, xoay vòng secret và token, phân trang và tìm kiếm trong Change Inbox, cũng như sửa hoặc gỡ một release note đã xuất bản. Quickstart và Docker Compose demo đều dành cho một máy, chưa phải cấu hình production.

Series bài viết

Xây dựng ReleaseFlow: từ pull request đã merge đến release note — bài toán, kiến trúc modular monolith và hàng đợi bền vững trong PostgreSQL.
AI đề xuất, con người quyết định — rule trước AI, vòng đời review và release note bất biến.
Bảo mật một ứng dụng multi-tenant nhận webhook từ người lạ — tenant isolation, webhook có chữ ký, mã hóa secret và observability.