Release 2.9.0

[2.9.0] - 2026-06-16

✨ Features

• restructure gender stats response for better readability (#67) (ab2968f)
• restructure vaccination response payload for better readability (6eb9b35)
• add vaccination coverage percentage to response (af6133d)
• feat(cache): add in-memory caching layer with TTL and admin invalidation (dd0dba8)
• feat(cache): add Redis-backed dual-layer cache support (d79cd9b)

🐛 Bug Fixes

• use WORKFLOW_TOKEN for gh CLI calls in release-branch-creation workflow (f8d618e)
• use WORKFLOW_PAT org secret instead of WORKFLOW_TOKEN (d6d932c)
• remove /api/v1 prefix from @router annotations (d6ba522)
• remove /api/v1 prefix from @router annotations (fdac8c4)
• remove /api/v1 prefix from @router annotations (9e1d85e)
• remove /api/v1 prefix from @router annotations (d56aeba)
• remove /api/v1 prefix from @router annotations (a2e3f46)
• remove /api/v1 prefix from @router annotations (208a4c7)
• accept both v-prefixed and plain semver tags in deploy trigger (684e843)
• use WORKFLOW_TOKEN for gh CLI calls in release-branch-creation workflow (662fd4c)
• rewrite vaccination DTO tests to match actual struct fields (e67b84b)
• remove duplicate bump-develop-version job (handled by reusable workflow) (a50d92f)
• remove duplicate release-branch-creation workflow (fully handled by reusable workflow) (a4ba4d7)
• resolve errcheck linter errors in cached service tests (92aebd4)
• fix(docker): bump alpine runtime base to clear libcrypto3 CVE-2026-31789 (5dae362)

📚 Documentation

• update changelog for v2.6.0 (ebde3af)
• regenerate swagger with fixed paths (no double /api/v1) (a659834)
• regenerate swagger with fixed paths (no double /api/v1) (9b4bcee)
• regenerate swagger with fixed paths (no double /api/v1) (30d9fd5)
• update changelog for 2.6.1 (cf610ca)
• update changelog for 2.7.0 (67f765f)
• update changelog for 2.8.0 (0c459a7)

🧪 Tests

• add unit tests for cached services and admin handler (39f1559)

🔧 Chores

• bump version to v2.7.0 for next development cycle (6356336)
• bump version to 2.6.1 (520cf6d)
• bump version to v2.7.0 for next development cycle (be91838)
• prepare v2.7.0 release (5fc39d9)
• bump version to 2.8.0 for next development cycle (3927c36)
• bump version to 2.9.0 for next development cycle (7be7194)
• bump version to 2.9.0 (b95125a)
• back-merge 2.8.0 to develop (4c6cd59)

📝 Other Changes

• Merge pull request #62 from banua-coder/fix/release-workflow-token (b70fa3c)
• Merge pull request #60 from banua-coder/chore/bump-next-version (8ac5cd0)
• Merge branch 'develop' into chore/back-merge-v2.6.0 (c8c5136)
• Merge pull request #63 from banua-coder/chore/back-merge-v2.6.0 (7c96678)
• Merge pull request #64 from banua-coder/hotfix/2.6.1 (e4adcd0)
• Merge pull request #65 from banua-coder/chore/back-merge-2.6.1 (4e29a65)
• Merge pull request #66 from banua-coder/feature/vaccination-response-restructure (934ac0c)
• Merge pull request #69 from banua-coder/feature/vaccination-coverage-v2 (d5bf33d)
• Merge pull request #72 from banua-coder/chore/prepare-release-v2.7.0 (e3c764d)
• Merge pull request #74 from banua-coder/chore/bump-version-to-v2.8.0-dev (9d67911)
• Merge pull request #70 from banua-coder/release/2.7.0 (802e888)
• Merge branch 'develop' into chore/back-merge-2.7.0 (213c3ad)
• Merge pull request #77 from banua-coder/chore/back-merge-2.7.0 (3509785)
• Merge branch 'develop' into feat/in-memory-cache (a805d9c)
• Merge pull request #78 from banua-coder/feat/in-memory-cache (8b547c2)
• release: 2.8.0 (448e788)
• Merge branch 'develop' into chore/back-merge-2.8.0 (760eea6)
• Merge pull request #83 from banua-coder/fix/bump-alpine-base-cve (0959686)
• Merge pull request #84 from banua-coder/release/2.9.0 (9733db4)

Release 2.8.0

[2.8.0] - 2026-03-30

✨ Features

• restructure gender stats response for better readability (#67) (ab2968f)
• restructure vaccination response payload for better readability (6eb9b35)
• add vaccination coverage percentage to response (af6133d)
• feat(cache): add in-memory caching layer with TTL and admin invalidation (dd0dba8)
• feat(cache): add Redis-backed dual-layer cache support (d79cd9b)

🐛 Bug Fixes

• use WORKFLOW_TOKEN for gh CLI calls in release-branch-creation workflow (f8d618e)
• use WORKFLOW_PAT org secret instead of WORKFLOW_TOKEN (d6d932c)
• remove /api/v1 prefix from @router annotations (d6ba522)
• remove /api/v1 prefix from @router annotations (fdac8c4)
• remove /api/v1 prefix from @router annotations (9e1d85e)
• remove /api/v1 prefix from @router annotations (d56aeba)
• remove /api/v1 prefix from @router annotations (a2e3f46)
• remove /api/v1 prefix from @router annotations (208a4c7)
• accept both v-prefixed and plain semver tags in deploy trigger (684e843)
• use WORKFLOW_TOKEN for gh CLI calls in release-branch-creation workflow (662fd4c)
• rewrite vaccination DTO tests to match actual struct fields (e67b84b)
• remove duplicate bump-develop-version job (handled by reusable workflow) (a50d92f)
• remove duplicate release-branch-creation workflow (fully handled by reusable workflow) (a4ba4d7)
• resolve errcheck linter errors in cached service tests (92aebd4)

📚 Documentation

• update changelog for v2.6.0 (ebde3af)
• regenerate swagger with fixed paths (no double /api/v1) (a659834)
• regenerate swagger with fixed paths (no double /api/v1) (9b4bcee)
• regenerate swagger with fixed paths (no double /api/v1) (30d9fd5)
• update changelog for 2.6.1 (cf610ca)
• update changelog for 2.7.0 (67f765f)

🧪 Tests

• add unit tests for cached services and admin handler (39f1559)

🔧 Chores

• bump version to v2.7.0 for next development cycle (6356336)
• bump version to 2.6.1 (520cf6d)
• bump version to v2.7.0 for next development cycle (be91838)
• prepare v2.7.0 release (5fc39d9)
• bump version to 2.8.0 for next development cycle (3927c36)

📝 Other Changes

• Merge pull request #62 from banua-coder/fix/release-workflow-token (b70fa3c)
• Merge pull request #60 from banua-coder/chore/bump-next-version (8ac5cd0)
• Merge branch 'develop' into chore/back-merge-v2.6.0 (c8c5136)
• Merge pull request #63 from banua-coder/chore/back-merge-v2.6.0 (7c96678)
• Merge pull request #64 from banua-coder/hotfix/2.6.1 (e4adcd0)
• Merge pull request #65 from banua-coder/chore/back-merge-2.6.1 (4e29a65)
• Merge pull request #66 from banua-coder/feature/vaccination-response-restructure (934ac0c)
• Merge pull request #69 from banua-coder/feature/vaccination-coverage-v2 (d5bf33d)
• Merge pull request #72 from banua-coder/chore/prepare-release-v2.7.0 (e3c764d)
• Merge pull request #74 from banua-coder/chore/bump-version-to-v2.8.0-dev (9d67911)
• Merge pull request #70 from banua-coder/release/2.7.0 (802e888)
• Merge branch 'develop' into chore/back-merge-2.7.0 (213c3ad)
• Merge pull request #77 from banua-coder/chore/back-merge-2.7.0 (3509785)
• Merge branch 'develop' into feat/in-memory-cache (a805d9c)
• Merge pull request #78 from banua-coder/feat/in-memory-cache (8b547c2)
• release: 2.8.0 (448e788)

Release 2.7.0

[2.7.0] - 2026-03-25

✨ Features

• restructure gender stats response for better readability (#67) (ab2968f)
• restructure vaccination response payload for better readability (6eb9b35)
• add vaccination coverage percentage to response (af6133d)

🐛 Bug Fixes

• use WORKFLOW_TOKEN for gh CLI calls in release-branch-creation workflow (f8d618e)
• use WORKFLOW_PAT org secret instead of WORKFLOW_TOKEN (d6d932c)
• remove /api/v1 prefix from @router annotations (d6ba522)
• remove /api/v1 prefix from @router annotations (fdac8c4)
• remove /api/v1 prefix from @router annotations (9e1d85e)
• remove /api/v1 prefix from @router annotations (d56aeba)
• remove /api/v1 prefix from @router annotations (a2e3f46)
• remove /api/v1 prefix from @router annotations (208a4c7)
• accept both v-prefixed and plain semver tags in deploy trigger (684e843)
• use WORKFLOW_TOKEN for gh CLI calls in release-branch-creation workflow (662fd4c)
• rewrite vaccination DTO tests to match actual struct fields (e67b84b)
• remove duplicate bump-develop-version job (handled by reusable workflow) (a50d92f)
• remove duplicate release-branch-creation workflow (fully handled by reusable workflow) (a4ba4d7)

📚 Documentation

• update changelog for v2.6.0 (ebde3af)
• regenerate swagger with fixed paths (no double /api/v1) (a659834)
• regenerate swagger with fixed paths (no double /api/v1) (9b4bcee)
• regenerate swagger with fixed paths (no double /api/v1) (30d9fd5)
• update changelog for 2.6.1 (cf610ca)

🔧 Chores

• bump version to v2.7.0 for next development cycle (6356336)
• bump version to 2.6.1 (520cf6d)
• bump version to v2.7.0 for next development cycle (be91838)
• prepare v2.7.0 release (5fc39d9)

📝 Other Changes

• Merge pull request #62 from banua-coder/fix/release-workflow-token (b70fa3c)
• Merge pull request #60 from banua-coder/chore/bump-next-version (8ac5cd0)
• Merge branch 'develop' into chore/back-merge-v2.6.0 (c8c5136)
• Merge pull request #63 from banua-coder/chore/back-merge-v2.6.0 (7c96678)
• Merge pull request #64 from banua-coder/hotfix/2.6.1 (e4adcd0)
• Merge pull request #65 from banua-coder/chore/back-merge-2.6.1 (4e29a65)
• Merge pull request #66 from banua-coder/feature/vaccination-response-restructure (934ac0c)
• Merge pull request #69 from banua-coder/feature/vaccination-coverage-v2 (d5bf33d)
• Merge pull request #72 from banua-coder/chore/prepare-release-v2.7.0 (e3c764d)
• Merge pull request #70 from banua-coder/release/2.7.0 (802e888)

Release 2.6.1

[2.6.1] - 2026-03-25

🐛 Bug Fixes

• use WORKFLOW_PAT org secret instead of WORKFLOW_TOKEN (d6d932c)
• remove /api/v1 prefix from @router annotations (d6ba522)
• remove /api/v1 prefix from @router annotations (fdac8c4)
• remove /api/v1 prefix from @router annotations (9e1d85e)
• remove /api/v1 prefix from @router annotations (d56aeba)
• remove /api/v1 prefix from @router annotations (a2e3f46)
• remove /api/v1 prefix from @router annotations (208a4c7)

📚 Documentation

• update changelog for v2.6.0 (ebde3af)
• regenerate swagger with fixed paths (no double /api/v1) (a659834)
• regenerate swagger with fixed paths (no double /api/v1) (9b4bcee)
• regenerate swagger with fixed paths (no double /api/v1) (30d9fd5)

🔧 Chores

• bump version to 2.6.1 (520cf6d)

📝 Other Changes

• Merge pull request #64 from banua-coder/hotfix/2.6.1 (e4adcd0)

Release v2.6.0

[v2.6.0] - 2026-03-25

✨ Features

• add pagination to hospitals, vaccination, regencies, and task-force endpoints (8dd0903)

🐛 Bug Fixes

• use update-version.sh script for develop version bump (750a7e7)
• handle errcheck lint issues in GetPaginatedByProvinceID (057a22e)

📚 Documentation

• update changelog for v2.5.1 (5999231)

🧪 Tests

• improve code coverage from 47% to 61.6% (63552ac)
• push code coverage from 57% to 80.5% (adc36b5)
• push coverage to 82.3% (above 80% CI threshold) (988ccc5)

👷 CI

• exclude cmd, docs, pkg/database from coverage calculation (aba5f17)

🔧 Chores

• bump version to v2.6.0 for next development cycle (85e547b)
• bump version to 4.6.0 and fix lint errors (f6a1bd1)
• correct version to 2.6.0 (not 4.6.0) (6fa7209)
• bump version to v2.6.0 (59fcbca)
• prepare v2.6.0 release (2421171)

📝 Other Changes

• Merge pull request #49 from banua-coder/chore/bump-version-to-v2.6.0-dev (7f42cdc)
• Merge branch 'develop' into chore/back-merge-v2.5.0 (46efc5f)
• Merge pull request #53 from banua-coder/chore/back-merge-v2.5.0 (9b873c5)
• Merge branch 'develop' into chore/back-merge-v2.5.1 (fb8a336)
• Merge pull request #57 from banua-coder/chore/back-merge-v2.5.1 (bbffd95)
• Merge pull request #58 from banua-coder/feature/pagination-and-restructure-api (d967794)
• Merge pull request #61 from banua-coder/chore/prepare-release-v2.6.0 (999d8a1)
• Merge pull request #59 from banua-coder/release/v2.6.0 (c675ca6)

[v2.5.1] - 2026-03-15

[v2.6.0] - 2026-03-16

Added

• Add pagination to hospitals, vaccination, regencies, and task-force endpoints (8dd09036)

Fixed

• Handle errcheck lint issues in getpaginatedbyprovinceid (057a22ee)
• Use update-version.sh script for develop version bump (750a7e7f)

Documentation

• Update changelog for v2.5.1 (59992313)

Tests

• Push coverage to 82.3% (above 80% ci threshold) (988ccc5a)
• Push code coverage from 57% to 80.5% (adc36b55)
• Improve code coverage from 47% to 61.6% (63552acc)

CI/CD

• Exclude cmd, docs, pkg/database from coverage calculation (aba5f170)

Maintenance

• Correct version to 2.6.0 (not 4.6.0) (6fa7209d)
• Bump version to 4.6.0 and fix lint errors (f6a1bd1a)
• Bump version to v2.6.0 for next development cycle (85e547b2)

Release v2.5.1

[v2.5.1] - 2026-03-15

🐛 Bug Fixes

• add all new endpoints to /api/v1 index response (0bb07af)

📚 Documentation

• update changelog for v2.5.0 (ed28b3f)

🔧 Chores

• bump version to v2.5.1 (31e554d)

📝 Other Changes

• Merge pull request #56 from banua-coder/hotfix/v2.5.1 (2ed01ec)

Release v2.5.0

[v2.5.0] - 2026-03-15

✨ Features

• enable Swagger UI in production build (fe19501)
• migrate Lumen endpoints — regencies, hospitals, task forces (29d7863)
• add vaccination endpoints — national, province, locations (32ce6f4)
• add province stats, national by day, single province endpoints (16ad143)

🐛 Bug Fixes

• create-release job now runs after successful deployment (73b1fbb)
• update host to pico-api-go.banuacoder.com (f97f6c9)
• use ./cmd/ package path in Dockerfile (main_production.go not found) (8359a50)
• update swagger host to pico-api-go.banuacoder.com (983fa25)
• handle NULL values in province case ODP/PDP fields (8238837)
• upgrade golangci-lint to v2.10.1 for Go 1.26 compatibility (aa3bcf9)
• remove redundant embedded DB field selectors (QF1008) (cfbeecc)
• remove all redundant embedded DB field selectors (QF1008) (d85e9d6)
• resolve golangci-lint errcheck and govet issues (5428b62)
• resolve git auth error in release branch creation workflow (6de04ee)
• add nolint:errcheck to remaining defer Close() calls (a4d975f)
• properly handle rows.Close() and db.Close() errors (29041b6)
• properly handle rows/db Close() errors (07fb831)
• pin release workflow to @v1 tag (08a1f1e)
• restore corrupt assert.Equal args and fix .version-config.yml patterns (a016065)

📚 Documentation

• add CONTRIBUTING.md with git flow workflow (401732c)

🧪 Tests

• add unit tests for all new handlers + refactor to service interfaces (6ff000d)
• add service layer unit tests to improve coverage (9066ddd)
• add repository tests to meet 85% coverage threshold (0d01572)

👷 CI

• add Docker build and deploy workflow to GHCR (3928c39)
• add setup-buildx-action to fix GHA cache export (56a74d0)
• separate deploy (main only) and CI workflows (develop/feature/PR) (3331bac)
• deploy triggers on main + hotfix/**, CI on develop + feature/bugfix/release + PRs (820f648)
• restore original ci.yml; deploy triggers on version tags (Docker/GHCR) (75c1982)
• add SSH deploy step — pull & restart container after image push (9936208)
• retrigger CI after golangci-lint-action upgrade to v7 (5ce2c25)
• re-trigger release workflow with new WORKFLOW_TOKEN (556305d)

🔧 Chores

• back-merge v2.4.0 from main to develop (832fc4f)
• update version to 2.5.0 and fix remaining issues (367fac9)
• sync develop with main (resolve conflicts, keep main version) (b0d0bd6)
• upgrade Go to 1.26 and migrate to reusable workflows (31439dd)
• integrate branch cleanup from reusable workflow (4d473d6)
• prepare v2.5.0 release (0aca0fc)
• bump version to v2.5.0 (b47db4a)

📝 Other Changes

• Merge pull request #38 from banua-coder/chore/back-merge-v2.4.0-to-develop (38837aa)
• Merge pull request #40 from banua-coder/fix/nullable-province-case-fields (8c77691)
• hotfix: fix deploy workflow — trigger on tags, add SSH deploy step (776d957)
• Merge pull request #43 from banua-coder/hotfix/fix-deploy-workflow (461c699)
• Merge pull request #45 from banua-coder/chore/upgrade-go-and-integrate-reusable-workflows (787b598)
• Merge pull request #44 from banua-coder/feature/migrate-lumen-endpoints (cb0a27f)
• Merge pull request #46 from banua-coder/chore/integrate-branch-cleanup-housekeeping (81ec193)
• Merge pull request #47 from banua-coder/chore/prepare-release-v2.5.0 (70d1dac)
• Merge pull request #48 from banua-coder/release/v2.5.0 (fad460f)

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

[Unreleased]

[v2.5.0] - 2026-03-15

Hotfixes

• Fix deploy workflow — trigger on tags, add ssh deploy step (776d9578)

Added

• Add province stats, national by day, single province endpoints (16ad143b)
• Add vaccination endpoints — national, province, locations (32ce6f4a)
• Migrate lumen endpoints — regencies, hospitals, task forces (29d7863f)
• Enable swagger ui in production build (fe19501b)

Fixed

• Remove all redundant embedded db field selectors (qf1008) (d85e9d61)
• Remove redundant embedded db field selectors (qf1008) (cfbeecc3)
• Upgrade golangci-lint to v2.10.1 for go 1.26 compatibility (aa3bcf9e)
• Handle null values in province case odp/pdp fields (82388377)
• Update swagger host to pico-api-go.banuacoder.com (983fa25e)
• Use ./cmd/ package path in dockerfile (main_production.go not found) (8359a50c)
• Update host to pico-api-go.banuacoder.com (f97f6c9e)
• Create-release job now runs after successful deployment (73b1fbbc)

Documentation

• Add contributing.md with git flow workflow (401732c9)

Tests

• Add repository tests to meet 85% coverage threshold (0d01572b)
• Add service layer unit tests to improve coverage (9066ddd6)
• Add unit tests for all new handlers + refactor to service interfaces (6ff000db)

CI/CD

• Retrigger ci after golangci-lint-action upgrade to v7 (5ce2c25e)
• Add ssh deploy step — pull & restart container after image push (9936208a)
• Restore original ci.yml; deploy triggers on version tags (docker/ghcr) (75c19820)
• Deploy triggers on main + hotfix/**, ci on develop + feature/bugfix/release + prs (820f648d)
• Separate deploy (main only) and ci workflows (develop/feature/pr) (3331bace)
• Add setup-buildx-action to fix gha cache export (56a74d00)
• Add docker build and deploy workflow to ghcr (3928c39c)

Maintenance

• Upgrade go to 1.26 and migrate to reusable workflows (31439dd0)
• Sync develop with main (resolve conflicts, keep main version) (b0d0bd6d)
• Update version to 2.5.0 and fix remaining issues (367fac96)

🚀 v2.4.0

🚀 Release v2.4.0

Release Type: release
Deployment: ✅ Successfully deployed to production

What's Changed

🚀 Features:

• feat: add pagination support to national COVID-19 cases endpoint
• feat: add automatic PR creation from release/hotfix branches to main

🐛 Bug Fixes:

• fix: resolve build, lint, and test failures
• fix: remove duplicate method implementations in service layer
• fix: create-release job now runs after successful deployment

🛠️ Other Changes:

• chore: update version to 2.4.0 across all files
• chore: enhance GitHub Actions workflow for git flow automation
• chore: add test file patterns to version configuration
• chore: fix lint issues and code formatting

📋 Deployment Details

• Binary: Built with Go 1.25.x
• Platform: Linux AMD64
• Health Check: API is responding correctly

🔗 Links

• API Documentation
• Repository
• Health Check

Contributors

• @banua-coder

🚀 v2.3.0

🚀 Release v2.3.0

Release Type: release
Deployment: ✅ Successfully deployed to production

What's Changed

Changes since v2.2.0:

• fix: resolve shell expansion issue in GitHub release creation
• fix: enable automatic deployment trigger on tag creation
• chore: back-merge v2.3.0 from main to develop
• chore: bump version to v2.4.0 for next development cycle
• chore: prepare v2.3.0 release
• docs: add go expert usage guideline to CLAUDE.md
• docs: regenerate swagger documentation with pagination support
• Revert "fix: resolve linter issues and add national pagination support"
• style: add missing newlines at end of files
• feat: add national cases pagination support
• fix: handle nullable pointer fields in province case tests
• fix: standardize error handling in province case repository
• fix: handle NULL values in province case database fields
• docs: remove RATE_LIMITING.md documentation file
• feat: update deployment workflow for static Swagger UI
• refactor: migrate Swagger UI to static files
• fix: update version bump workflow to include test files
• fix: add .htaccess to properly route Swagger UI requests to Go app
• refactor: remove swagger documentation upload from deployment
• chore: bump version to v2.3.0 for next development cycle

📋 Deployment Details

• Binary: Built with Go 1.25.x
• Platform: Linux AMD64
• Deployment Time: $(date -u '+%Y-%m-%d %H:%M:%S UTC')
• Health Check: https://pico-api.banuacoder.com/api/v1/health

🔗 Links

• API Documentation
• Repository
• Health Check

🚀 v2.2.0

🚀 Release v2.2.0

Release Type: release
Deployment: ✅ Successfully deployed to production

What's Changed

Changes since v2.1.0:

• fix: simplify health check to remove heredoc syntax errors
• fix: add automatic conflict resolution to back-merge workflow
• chore: prepare v2.2.0 release
• docs: regenerate swagger documentation
• fix: add commit hashes to changelog and remove unnecessary release notes
• fix: improve changelog generation debugging and file handling
• fix: create PR workflow instead of direct commits to release branch
• fix: add Go binary path for swag command in workflows
• fix: improve YAML parsing and GitHub Actions output handling
• chore(version): update for next version
• feat: implement comprehensive version management system
• style: add missing newline at end of workflow file
• feat: add comprehensive branch conflict handling to release workflow
• feat: unified release workflow with auto-tag, deploy & back-merge
• feat: add automatic tag creation workflow for releases
• docs: update .env.example with rate limiting configuration
• fix: handle error return values in rate limit tests for linter
• style: fix formatting and add missing newlines
• feat: implement rate limiting middleware
• fix: correct package coverage parsing in CI workflow

📋 Deployment Details

• Binary: Built with Go 1.25.x
• Platform: Linux AMD64
• Deployment Time: 2025-09-08 07:54:49 UTC
• Health Check: https://pico-api.banuacoder.com/api/v1/health

🔗 Links

• API Documentation
• Repository
• Health Check