feat: add badge collection examples and update release notes for version 2.0.3

Author: pphatdev

README.md

@@ -246,6 +246,35 @@ for more detail checkout [Here](docs/example/badge-user.md)
 ![badge-minimal](https://stats.pphat.top/badge/total-pull-requests?username=pphatdev&theme=tokyonight&hideFrame=true&hideIcon=true)
 
 
+# 🧩 Badge Collection Examples
+
+for more detail checkout [Here](docs/example/badge-collection.md)
+
+### Default Collection
+
+```
+![badge-collection-default](https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,total-stars,repositories)
+```
+
+![badge-collection-default](https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,total-stars,repositories)
+
+### Layout Controls (columns + gap)
+
+```
+![badge-collection-layout](https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,total-stars,repositories,total-issues,followers&columns=2&gap=8)
+```
+
+![badge-collection-layout](https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,total-stars,repositories,total-issues,followers&columns=2&gap=8)
+
+### Multiple Themes (cycled per badge)
+
+```
+![badge-collection-multi-theme](https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,total-stars,repositories,total-issues,followers&theme=galaxy,aurora,ocean)
+```
+
+![badge-collection-multi-theme](https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,total-stars,repositories,total-issues,followers&theme=galaxy,aurora,ocean)
+
+
 # 📁 Project Badge Examples
 
 for more detail checkout [Here](docs/example/project.md)

docs/RELEASE/RELEASE_v2.0.3.md

@@ -0,0 +1,76 @@
+# Release v2.0.3
+
+Release date: 2026-04-04
+
+## Summary 📝
+
+This release focuses on consistency, maintainability, and documentation improvements.
+
+## Highlights ✨
+
+- 🧩 Added badge collection examples to the main README.
+- 🎨 Added support for multiple themes in badge collections (theme cycling by badge index).
+- ✅ Added explicit theme validation for badge collection requests.
+- 🧱 Standardized controller filenames to the pattern `filename.controller.ts`.
+- 🛠️ Standardized service filenames to the pattern `filename.service.ts`.
+- 🚀 Updated project version to `2.0.3`.
+
+## API Notes 🔌
+
+### Badge Collection 🧩
+
+Endpoint:
+
+- `GET /badge/collection`
+
+Key query parameters:
+
+- `username` (required)
+- `type` (required, comma-separated badge types)
+- `columns` (optional, 1-50)
+- `gap` (optional, 0-100)
+- `theme` (optional)
+
+Theme behavior:
+
+- Single theme: applies to all badges
+- Multiple themes: comma-separated list, applied in a loop across badges
+
+Example:
+
+```text
+https://stats.pphat.top/badge/collection?username=pphatdev&type=visitors,total-stars,repositories,total-issues,followers&theme=galaxy,aurora,ocean
+```
+
+## Refactor Details 🔧
+
+### Controllers renamed 🎮
+
+- `stats.ts` -> `stats.controller.ts`
+- `languages.ts` -> `languages.controller.ts`
+- `graph.ts` -> `graph.controller.ts`
+- `badge.ts` -> `badge.controller.ts`
+- `controller.ts` -> `index.controller.ts`
+
+### Services renamed 🧰
+
+- `base.ts` -> `base.service.ts`
+- `github-graphql-optimizer.ts` -> `github-graphql-optimizer.service.ts`
+
+## Compatibility 🔒
+
+- No endpoint removals in this release.
+- Existing route behavior remains unchanged outside the documented badge collection improvements.
+
+## Verification Checklist ✅
+
+- Build passes after import path updates.
+- `README.md` includes badge collection examples.
+- `package.json` version is `2.0.3`.
+- Controller and service imports use standardized file patterns.
+
+## Related Docs 📚
+
+- `README.md`
+- `docs/example/badge-collection.md`
+- `docs/RELEASE/RELEASE_ICONS.md`