feat(observability): add OpenTelemetry Collector, Jaeger, and custom dashboard for monitoring

fix(infra): update NATS configuration for OpenTelemetry tracing and JetStream support refactor(dapr): modify Dapr sidecar configuration to use new resources path and config file chore(docs): update deployment documentation to include observability services docs(commit-convention): establish commit message guidelines for Asepharyana Hub docs(deploy-workflow): outline CI/CD pipeline and manual deployment steps for Asepharyana Hub feat(event-driven): implement event-driven architecture patterns with Dapr and NATS docs(hub-rules): define repository structure, submodule strategy, and infrastructure patterns
2026-07-22 16:43:37 +07:00
parent df71487563
commit dcb93035f3
20 changed files with 1055 additions and 23 deletions
@@ -0,0 +1,65 @@
+---
+name: commit-convention
+description: Commit message convention — type(scope): description for Asepharyana Hub
+---
+
+# Commit Convention — Asepharyana Hub
+
+## Format
+
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer]
+```
+
+## Types
+
+| Type       | Usage                                |
+| ---------- | ------------------------------------ |
+| `feat`     | Fitur baru                           |
+| `fix`      | Bug fix                              |
+| `chore`    | Maintenance, config, tooling         |
+| `docs`     | Dokumentasi                          |
+| `refactor` | Perubahan kode tanpa fungsional baru |
+| `test`     | Nambah/update test                   |
+| `ci`       | CI/CD workflows                      |
+| `perf`     | Optimasi performa                    |
+| `style`    | Formatting (tanda kutip, dll)        |
+
+## Scopes
+
+| Scope         | Area                              |
+| ------------- | --------------------------------- |
+| `scraper`     | apps/scraper submodule           |
+| `infra`       | infra/ (compose, traefik, docker) |
+| `ci`          | .github/workflows/                |
+| `dapr`        | Dapr config & sidecar             |
+| `nats`        | NATS message bus                  |
+| `docs`        | Dokumentasi                       |
+| `deps`        | Dependencies                      |
+| `scripts`     | Utility scripts                   |
+| `root`        | Root config files                 |
+
+## Contoh
+
+```
+feat(scraper): add anime detail caching via Dapr pubsub
+fix(infra): correct NATS CLI flags for JetStream
+chore(deps): update biome to v2.5.3
+docs(infra): add deployment order for Dapr services
+ci(deploy): add nats.yml to ALL_COMPOSE_FILES
+refactor(scraper): migrate EventBus from tokio broadcast to Dapr pubsub
+```
+
+## Aturan
+
+1. **Wajib** menyertakan scope dalam tanda kurung
+2. **Wajib** `Co-Authored-By` untuk commit yang digenerate AI
+3. **Gunakan imperative mood**: "add" bukan "added" / "adds"
+4. **Jangan capitalize** type: `feat:` bukan `Feat:`
+5. **No period** di akhir subject baris
+6. Body explain **why** dan **what**, bukan **how**
+7. Refer issue dengan `Closes #123` atau `Fixes #123` di footer