feat(analytics): add support for analytics

.gitignore

@@ -3,4 +3,10 @@
 routing-config/venv
 routing-config/output.sql
 dump.rdb
-.vscode
+.vscode
+**/node_modules
+cypress/screenshots
+cypress/videos
+cypress/fixtures
+# Added by code-review-graph
+.code-review-graph/

.mintlify-dev.log

@@ -0,0 +1,26 @@
+⠋ preparing local preview...
+⠙ preparing local preview...
+warning - Error validating OpenAPI file /mint.json: Error: Failed to validate OpenAPI schema:Unknown path: Can’t find supported Swagger/OpenAPI version in specification, version must be a string.
+⠙ preparing local preview...
+⠹ preparing local preview...
+⠸ preparing local preview...
+⠼ preparing local preview...
+update available - run `mint update` to get the latest version
+
+✓ preview ready
+
+  local   → http://localhost:3000
+  network → http://192.168.1.4:3000
+
+press ctrl+c to exit the preview
+
+
+update available - run `mint update` to get the latest version
+
+✓ preview ready
+
+  local   → http://localhost:3000
+  network → http://192.168.1.4:3000
+
+press ctrl+c to exit the preview
+

.typos.toml

@@ -1,2 +1,84 @@
 [default]
 check-filename = true
+
+# Ignore 2-3 letter all-caps identifiers (likely codes/abbreviations)
+# and 2-3 letter lowercase identifiers (likely variable names)
+extend-ignore-identifiers-re = [
+    "^[A-Z]{2,3}$",
+    "^[a-z]{2,3}$",
+]
+
+# Module/type aliases used throughout the codebase
+[default.extend-identifiers]
+HasTable = "HasTable"
+ETO = "ETO"
+ETCC = "ETCC"
+ETM = "ETM"
+ETD = "ETD"
+ETCa = "ETCa"
+ETTD = "ETTD"
+ETOd = "ETOd"
+ETMo = "ETMo"
+TE = "TE"
+ser = "ser"
+
+# ISO 3166-1 alpha-3 country codes
+CAF = "CAF"
+NAM = "NAM"
+SOM = "SOM"
+THA = "THA"
+FO = "FO"
+
+# ISO 4217 currency codes
+ZAR = "ZAR"
+
+# Common abbreviations in code (e.g., ect = extendedCardType)
+ect = "ect"
+
+# CamelCase identifiers (Mis = Mismatch, etc.)
+Mis = "Mis"
+
+# Time zones (IST = Indian Standard Time)
+IST = "IST"
+Ist = "Ist"
+ist = "ist"
+
+# Order Type abbreviation
+OT = "OT"
+
+# Value Added Services (banking term)
+VAS = "VAS"
+Vas = "Vas"
+
+# JWT library API term
+encrypter = "encrypter"
+
+[default.extend-words]
+# Project-specific terms that are valid
+incase = "incase"
+# Database column name (would require migration to fix)
+penality = "penality"
+# HashiCorp (company name)
+hashi = "hashi"
+# CamelCase function name (Mismatch)
+Mis = "Mis"
+# Time zones (Indian Standard Time)
+IST = "IST"
+Ist = "Ist"
+ist = "ist"
+# Order Type abbreviation
+OT = "OT"
+# Value Added Services (banking term)
+VAS = "VAS"
+Vas = "Vas"
+# JWT library API term
+encrypter = "encrypter"
+
+[files]
+extend-exclude = [
+    # Exclude non-source files
+    "*.groovy",
+    "**/Untitled*",
+    # Exclude build artifacts
+    "website/dist/**",
+]

AGENTS.md

@@ -0,0 +1,159 @@
+# Decision Engine Agent Guide
+
+## Purpose
+
+Use this file as the first-stop operating guide for work in `decision-engine`.
+
+- Use docs for orientation, then verify behavior against code, config, and CI before making claims.
+- Prefer the smallest relevant surface first: route -> service -> config -> storage -> deployment.
+- When docs and code disagree, trust code, config, and CI over prose.
+
+## Source of Truth
+
+Use this precedence order when answering questions or planning changes:
+
+1. Runtime code and entrypoints in `src/`
+2. Config files and deployment manifests in `config/`, `docker-compose.yaml`, and `helm-charts/`
+3. `justfile`, `Makefile`, `.github/workflows/`, and `scripts/ci-checks.sh`
+4. Setup and API docs in `docs/`
+5. `README.md` for high-level product context only
+
+Do not treat README claims or marketing language as definitive implementation truth.
+
+## Repo Map
+
+- `src/bin/open_router.rs`: process entrypoint; loads config, fetches secrets, starts app and metrics servers
+- `src/app.rs`: main HTTP server wiring, route registration, middleware, graceful shutdown, TLS handling
+- `src/routes/`: REST handlers and endpoint behavior
+- `src/config.rs`: config structs, config loading, env override behavior, validation hooks
+- `src/tenant.rs`: tenant-aware app state wiring
+- `src/decider/`: routing decision logic
+- `src/euclid/`: routing rules and evaluation engine
+- `src/feedback/`: score updates and routing feedback flows
+- `docs/local-setup.md`: canonical local and on-prem style startup guide
+- `docs/configuration.md`: config-oriented documentation and deployment pointers
+- `docs/api-reference1.md`: human-readable API examples
+- `docs/openapi.json`: machine-readable API contract
+- `docker-compose.yaml`: local topology, compose profiles, supporting services
+- `helm-charts/`: Kubernetes and on-prem deployment assets
+- `justfile`: canonical engineering commands
+- `Makefile`: convenience wrappers around common compose flows
+- `.github/workflows/`: CI expectations and release automation
+- `scripts/ci-checks.sh`: DB feature compile matrix enforced by CI
+- `website/`: dashboard/frontend assets
+- `cypress/`: frontend/end-to-end test area
+
+## Which Docs to Open First
+
+- Local startup or environment bring-up: `docs/local-setup.md` -> `docker-compose.yaml` -> `justfile`
+- Runtime/config questions: `docs/configuration.md` -> `config/*.toml` -> `src/config.rs`
+- API behavior: `docs/openapi.json` -> `docs/api-reference1.md` -> `src/routes/*`
+- Server startup and wiring: `src/bin/open_router.rs` -> `src/app.rs`
+- Deployment or on-prem: `helm-charts/README.md` -> `helm-charts/templates/*` -> `docker-compose.yaml`
+- CI or verification expectations: `justfile` -> `.github/workflows/*` -> `scripts/ci-checks.sh`
+- Routing logic: `src/decider/` -> `src/euclid/` -> `src/routes/decide_gateway.rs` -> `src/routes/rule_configuration.rs` -> `src/routes/update_gateway_score.rs`
+- Tenant behavior: `src/tenant.rs` -> `src/custom_extractors.rs` -> `src/app.rs`
+
+## Canonical Startup Paths
+
+Use `docs/local-setup.md` as the canonical startup guide. Default to PostgreSQL unless the task is explicitly MySQL-specific.
+
+Preferred quick-start paths:
+
+- PostgreSQL with GHCR images:
+  `docker compose --profile postgres-ghcr up -d`
+- PostgreSQL with local build:
+  `docker compose --profile postgres-local up -d --build`
+- Convenience wrappers:
+  `make init-pg-ghcr`
+  `make init-pg-local`
+
+Source-run commands:
+
+- PostgreSQL build:
+  `cargo build --release --no-default-features --features middleware,kms-aws,postgres`
+- PostgreSQL run:
+  `RUSTFLAGS="-Awarnings" cargo run --no-default-features --features postgres`
+- MySQL build:
+  `cargo build --release --features release`
+- MySQL run:
+  `RUSTFLAGS="-Awarnings" cargo run --features release`
+- PostgreSQL migration:
+  `just migrate-pg`
+
+Verification:
+
+- Health:
+  `curl http://localhost:8080/health`
+
+Choose the startup path based on task intent:
+
+- local debugging: compose or source run
+- deployment review: Helm and compose manifests
+- API behavior inspection: route code plus health/startup verification
+
+## Coding Expectations
+
+- Rust edition is 2021; MSRV in `Cargo.toml` is `1.85.0`
+- `unsafe` is forbidden
+- Treat clippy warnings around `unwrap`, `expect`, `panic`, `todo`, and `unimplemented` as meaningful design constraints
+- Verify both DB tracks when changing shared core logic; do not assume only one backend is affected
+- The default feature path is MySQL; PostgreSQL uses `--no-default-features --features postgres`
+- Touch the smallest relevant surface first instead of broad refactors
+- When changing externally visible behavior, update the relevant docs in `docs/`
+- Confirm implementation facts in `src/`, config, and deployment manifests instead of relying on README wording
+
+## Verification Expectations
+
+Before claiming a change is done, choose the smallest sufficient set of checks and state what was run.
+
+Recommended command ladder:
+
+- format check:
+  `cargo +nightly fmt --all --check`
+- lint:
+  `just clippy`
+- broad compile coverage:
+  `just check`
+- unit tests:
+  `cargo test`
+- PostgreSQL migration path when relevant:
+  `just migrate-pg`
+- startup/config smoke check when relevant:
+  `curl http://localhost:8080/health`
+- CI-sensitive Rust changes:
+  inspect `scripts/ci-checks.sh`
+
+Rules:
+
+- If a change touches shared Rust logic in `src/`, validate both MySQL and PostgreSQL compile paths because CI checks both.
+- If a task is docs-only, config-reading only, or frontend-only, say which checks were intentionally skipped.
+- If deployment behavior is in question, inspect manifests and templates directly instead of assuming docs are current.
+
+## Task Playbooks
+
+- Bug fix:
+  reproduce -> identify route/config/storage surface -> patch -> run targeted checks -> run broader compile checks if core logic changed
+- API change:
+  inspect route handler -> inspect request/response types -> inspect `docs/openapi.json` and `docs/api-reference1.md` -> update docs if behavior changed
+- Deployment issue:
+  inspect `docs/local-setup.md` -> inspect `docker-compose.yaml` or `helm-charts/templates/*` -> inspect config loading in `src/config.rs`
+- Prod or on-prem readiness question:
+  verify against Helm, compose, config defaults, secrets handling, probes, CI, and runtime code
+- Routing logic question:
+  inspect `src/routes/decide_gateway.rs`, `src/decider/`, `src/euclid/`, and feedback/update-score flows
+- Tenant question:
+  inspect `src/tenant.rs`, `src/custom_extractors.rs`, route handlers, and config-backed tenant wiring
+
+## Optional Local Tooling
+
+- When available, prefer `code-review-graph` for code navigation, dependency tracing, and change-impact analysis.
+- If unavailable, fall back to normal repository inspection.
+- Do not make task success depend on optional local AI tooling.
+
+## Important Caveats
+
+- Default config files are development-oriented and should not be treated as production-ready defaults.
+- Deployment docs are useful, but readiness claims must be verified against chart templates, compose manifests, runtime config, and code.
+- Use actual route wiring and config structs as the authority for behavior.
+- Some docs overlap or duplicate each other; prefer `docs/local-setup.md`, `docs/configuration.md`, `docs/openapi.json`, and the route code as canonical references.