Docs·4ff474d·Updated Mar 14, 2026·43 ADRs

Concepts & Decisions

Architecture Decision Records (ADRs) document the key design choices behind Karmyq.

29 accepted10 implemented2 proposed2 other
ADR-001

ADR-001: Natural Language Parsing for Location Input

**Date**: 2025-12-29

accepted
ADR-002

ADR-002: 3-Tier Geocoding Cache Architecture

**Date**: 2025-12-29

accepted
ADR-003

ADR-003: Multi-Tenant Row-Level Security (RLS) Database Design

**Date**: 2025-12-29

accepted
ADR-004

ADR-004: Microservices Event-Driven Architecture

**Date**: 2025-12-29

accepted
ADR-005

ADR-005: Minimalist Dashboard Design

**Date**: 2025-12-29

accepted
ADR-006

ADR-006: Standardized API Response Format

**Date**: 2025-12-29

accepted
ADR-007

ADR-007: Polymorphic Request System ("Everything App")

**Date**: 2025-12-29

unknown
ADR-008

ADR-008: 3-Column Dashboard Layout (V7)

**Date**: 2025-12-29

superseded
ADR-009

ADR-009: Ephemeral Data Design

**Date**: 2025-12-29

accepted
ADR-010

ADR-010: JWT-Based Multi-Community Authentication

**Date**: 2025-12-29

accepted
ADR-011

ADR-011: Reputation Decay System (Social Karma v2)

**Date**: 2025-12-29

accepted
ADR-012

ADR-012: Real-Time Communication Stack (WebSocket + SSE)

**Date**: 2025-12-29

accepted
ADR-013

ADR-013: Monorepo with Turborepo

**Date**: 2025-12-29

accepted
ADR-014

ADR-014: Testing Strategy (Integration + E2E + Unit)

**Date**: 2025-12-29

accepted
ADR-015

ADR-015: Observability Stack (Grafana/Loki/Prometheus)

**Date**: 2025-12-29

accepted
ADR-016

ADR-016: Prestige-Based Recognition System

**Date**: 2025-12-29

accepted
ADR-017

ADR-017: Cohort-Based Community Layers

**Date**: 2025-12-29

accepted
ADR-018

ADR-018: Community Splitting Mechanics

**Date**: 2025-12-29

accepted
ADR-019

ADR-019: Referral Chain Trust System

**Date**: 2025-12-29

implemented
ADR-020

ADR-020: Trust-First Design Philosophy

**Date**: 2025-12-29

accepted
ADR-021

ADR-021: Configurable Trust Path Filtering & Adaptive Trust Preferences

**Date**: 2025-01-01

accepted
ADR-022

ADR-022: Multi-Tier Feed Architecture (Explore-Exploit Balance)

**Date**: 2025-12-30

accepted
ADR-023

ADR-023: Infrastructure Standardization and Environment Management

**Date**: 2026-01-09

accepted
ADR-024

ADR-006: Synthetic User Simulation for Demo Environment

**Status**: Proposed

proposed
ADR-027

ADR-027: Docker Image Size Optimization (Deferred Technical Debt)

**Status**: Accepted

accepted
ADR-028

ADR-028: NPM Workspace Package for Shared Code in Docker

**Date**: 2026-01-30

accepted
ADR-029

ADR-029: Test-Driven Development (TDD) Framework

**Status**: Accepted

accepted
ADR-030

ADR-030: Community Configuration System (Phase 1)

**Status**: Accepted

accepted
ADR-031

ADR-031: Unified Trust-Scored Feed & Community Specialization

**Status**: Accepted

accepted
ADR-032

ADR-032: Server-Driven UI - Database-Driven Request Type Schemas

**Status**: Accepted

accepted
ADR-033

ADR-033: Offer Fulfillment Workflow

**Status**: Proposed

proposed
ADR-034

ADR-034: Multi-Layer Trust Path Computation

**Date**: 2026-02-24

implemented
ADR-035

ADR-035: Karma Allocation Strategy and Trust Score Abstraction

**Date**: 2026-02-25

implemented
ADR-036

ADR-036: Private Feedback Model — Trust Without Rating Economies

**Date**: 2026-02-25

accepted
ADR-037

ADR-037: Multi-Signal Trust Score — Bonding Capital, Bridging Capital, and Community-Configurable Floors

**Date**: 2026-02-25

implemented
ADR-038

ADR-038: Cross-Community Trust — Carry Model with Community-Configurable Decay

**Date**: 2026-02-26

implemented
ADR-039

ADR-039: Trust Score Decay Consistency — Time-Weighted Signals

**Date**: 2026-02-26

implemented
ADR-040

ADR-040: Community Trust Score

**Status**: Implemented

implemented
ADR-041

ADR-041: Two-Layer Mutual Aid + Professional Services

**Status**: Accepted

accepted
ADR-042

ADR-042: Provider Trust Score

**Status**: Accepted

accepted
ADR-043

ADR-043: Three-Score Model — Karma, Personal Trust, and Provider Trust

**Status**: Implemented

implemented
ADR-044

ADR-044: Community Trust Model Questionnaire

**Status**: Implemented

implemented
ADR-045

ADR-045: Network Cohesion Score

**Status**: Implemented

implemented