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**: Accepted
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**: Accepted
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