starter-kit/docs/changelog.md

Changelog

Tất cả những thay đổi đáng chú ý trong dự án sẽ được ghi lại ở đây.

Định dạng dựa trên Keep a Changelog, và dự án này tuân theo Semantic Versioning.

[Unreleased]

Added

• Logger Improvements:
  • Hỗ trợ phân biệt stdout/stderr cho các mức log khác nhau
  • Tự động thêm thông tin người gọi (caller) vào log
  • Hỗ trợ nhiều định dạng log (JSON, Text)
  • Tự động thêm các trường mặc định vào mỗi log entry
  • Tối ưu hiệu năng với buffer và sync.Pool
  • Hỗ trợ log rotation thông qua các hooks
  • Tài liệu chi tiết về cách sử dụng và cấu hình
  • Thread-safe implementation
  • Hỗ trợ context và request-scoped fields
  • Tích hợp với cấu hình ứng dụng

Changed

• Logger Refactor:
  • Thay đổi cấu trúc package logger để dễ mở rộng
  • Cải thiện hiệu suất với ít cấp phát bộ nhớ hơn
  • Chuẩn hóa định dạng log đầu ra
  • Cập nhật middleware HTTP để sử dụng logger mới

Fixed

• Logger:
  • Sửa lỗi race condition khi khởi tạo logger
  • Đảm bảo tất cả log đều có đầy đủ context
  • Cải thiện xử lý lỗi khi cấu hình không hợp lệ

Changed

• Thay thế standard log package bằng Logrus trong toàn bộ ứng dụng
• Di chuyển cấu hình logging từ app.log_level sang section logger riêng biệt
• Cập nhật HTTP server để sử dụng structured logging
• Cải thiện validation cho database config với required_if conditions
• Nâng cấp cấu hình logger để hỗ trợ nhiều tùy chọn hơn
• Tối ưu hiệu năng của hệ thống logging

[0.1.1] - 2025-05-14

Added

• Triển khai module config với các chức năng:
  • Đọc cấu hình từ file YAML
  • Hỗ trợ biến môi trường
  • Validation tự động các giá trị cấu hình
  • Giá trị mặc định cho các tham số
• Thiết lập cấu trúc thư mục theo mô hình DDD (Domain-Driven Design)
• Cấu hình CI/CD với Gitea Workflows
• Cấu hình Docker cho môi trường development và production
• Tích hợp các Git hooks để đảm bảo chất lượng mã nguồn

[0.1.0] - 2025-05-12

Added

• Khởi tạo repository
• Tạo roadmap ban đầu
• Thiết lập kiến trúc hệ thống theo mô hình DDD
• Định nghĩa U-Hierarchy cho tổ chức mã nguồn