Concepts & Decisions
Architecture Decision Records (ADRs) document the key design choices behind Karmyq.
ADR-001: Natural Language Parsing for Location Input
**Date**: 2025-12-29
ADR-002: 3-Tier Geocoding Cache Architecture
**Date**: 2025-12-29
ADR-003: Multi-Tenant Row-Level Security (RLS) Database Design
**Date**: 2025-12-29
ADR-004: Microservices Event-Driven Architecture
**Date**: 2025-12-29
ADR-005: Minimalist Dashboard Design
**Date**: 2025-12-29
ADR-006: Standardized API Response Format
**Date**: 2025-12-29
ADR-007: Polymorphic Request System ("Everything App")
**Date**: 2025-12-29
ADR-008: 3-Column Dashboard Layout (V7)
**Date**: 2025-12-29
ADR-009: Ephemeral Data Design
**Date**: 2025-12-29
ADR-010: JWT-Based Multi-Community Authentication
**Date**: 2025-12-29
ADR-011: Reputation Decay System (Social Karma v2)
**Date**: 2025-12-29
ADR-012: Real-Time Communication Stack (WebSocket + SSE)
**Date**: 2025-12-29
ADR-013: Monorepo with Turborepo
**Date**: 2025-12-29
ADR-014: Testing Strategy (Integration + E2E + Unit)
**Date**: 2025-12-29
ADR-015: Observability Stack (Grafana/Loki/Prometheus)
**Date**: 2025-12-29
ADR-016: Prestige-Based Recognition System
**Date**: 2025-12-29
ADR-017: Cohort-Based Community Layers
**Date**: 2025-12-29
ADR-018: Community Splitting Mechanics
**Date**: 2025-12-29
ADR-019: Referral Chain Trust System
**Date**: 2025-12-29
ADR-020: Trust-First Design Philosophy
**Date**: 2025-12-29
ADR-021: Configurable Trust Path Filtering & Adaptive Trust Preferences
**Date**: 2025-01-01
ADR-022: Multi-Tier Feed Architecture (Explore-Exploit Balance)
**Date**: 2025-12-30
ADR-023: Infrastructure Standardization and Environment Management
**Date**: 2026-01-09
ADR-006: Synthetic User Simulation for Demo Environment
**Status**: Proposed
ADR-027: Docker Image Size Optimization (Deferred Technical Debt)
**Status**: Accepted
ADR-028: NPM Workspace Package for Shared Code in Docker
**Date**: 2026-01-30
ADR-029: Test-Driven Development (TDD) Framework
**Status**: Implemented
ADR-030: Community Configuration System (Phase 1)
**Status**: Accepted
ADR-031: Unified Trust-Scored Feed & Community Specialization
**Status**: Accepted
ADR-032: Server-Driven UI - Database-Driven Request Type Schemas
**Status**: Accepted
ADR-033: Offer Fulfillment Workflow
**Status**: Proposed
ADR-034: Multi-Layer Trust Path Computation
**Date**: 2026-02-24
ADR-035: Karma Allocation Strategy and Trust Score Abstraction
**Date**: 2026-02-25
ADR-036: Private Feedback Model — Trust Without Rating Economies
**Date**: 2026-02-25
ADR-037: Multi-Signal Trust Score — Bonding Capital, Bridging Capital, and Community-Configurable Floors
**Date**: 2026-02-25
ADR-038: Cross-Community Trust — Carry Model with Community-Configurable Decay
**Date**: 2026-02-26
ADR-039: Trust Score Decay Consistency — Time-Weighted Signals
**Date**: 2026-02-26
ADR-040: Community Trust Score
**Status**: Implemented
ADR-041: Two-Layer Mutual Aid + Professional Services
**Status**: Accepted
ADR-042: Provider Trust Score
**Status**: Implemented
ADR-043: Three-Score Model — Karma, Personal Trust, and Provider Trust
**Status**: Implemented
ADR-044: Community Trust Model Questionnaire
**Status**: Implemented
ADR-045: Network Cohesion Score
**Status**: Implemented
ADR-046: Trust Model Evolution
**Status**: Implemented
ADR-047: Community Evolution Engine
**Status**: Implemented
ADR-048: Feed Ranking v2 — 7-Signal Formula + Interaction Logging
**Status**: Implemented
ADR-049: Error Visibility — `error_type` Discriminator and `X-Request-Id` Convention
**Date**: 2026-04-06
ADR-050: Group Communities as a Distinct Community Type
**Status**: Implemented
ADR-051: Explore/Exploit Two-Tier Dibs Candidate Selection
**Status**: Implemented
ADR-052: Security Hardening — OWASP Top 10 Baseline
**Date**: 2026-05-10
ADR-053: Feed Design Philosophy
**Status**: Accepted
ADR-054: Trust Graph Architecture
**Status**: Implemented
ADR-055: Trust-Based Governance Architecture
**Status**: Implemented
ADR-056: Intrinsic Trust Decay (Interaction Half-Life)
**Status**: Implemented
ADR-057: Community Fission Mechanism
**Status**: Implemented
ADR-058: Fusion Mechanism
**Status**: Implemented
ADR-059: Dependency Vulnerability Remediation + Blocking CI Security Gate
**Status**: Implemented
ADR-060: Code Scanning Remediation + Blocking CI Code-Scanning Gate
**Status**: Implemented
ADR-061: Supply-Chain & Secrets Hardening
**Status**: Implemented
ADR-062: Community Identity & Idempotent Creation
**Status**: Implemented
ADR-063: Canonical Decayed Trust Metric & Unified Graph Visualization
**Status**: Implemented
ADR-064: Authorize Mutations from Authenticated Identity, Not Client-Supplied IDs
**Status**: Implemented
ADR-065: Karmyq.org and Karmyq.com Domain Roles
**Status**: Implemented
ADR-066: Unified Feed Model
**Status**: Implemented
ADR-067: `request_type` vs `payload_type` Vocabulary
**Status**: Implemented
ADR-068: Community Page Information Architecture (warm four-tab model)
**Status**: Implemented
ADR-069: Data Retention and Forgetting (content anonymization policy)
**Status**: Implemented
ADR-070: Visible Decay Model (decay tiers + re-warming nudge)
**Status**: Implemented
ADR-071: Fold Feed Service Into Request Service
**Status:** Implemented