Skip to content

Latest commit

 

History

History
62 lines (59 loc) · 8.28 KB

File metadata and controls

62 lines (59 loc) · 8.28 KB

주요 기술적 의사결정

ReadMates의 durable product·technical·design·operational decision은 ADR 인덱스가 유일한 canonical registry다. 이 문서는 기존 링크 호환을 위한 파생 인덱스이며 별도 결정 산문을 두지 않는다. Accepted는 현재 코드·테스트·active architecture와 일치하는 판단 근거이고, Proposed는 승인됐지만 아직 구현되지 않은 의무다.

ADR 제목 상태
ADR-0001 Cloudflare Pages Functions를 BFF로 채택 Accepted
ADR-0002 Server clean architecture + ArchUnit 강제 Accepted
ADR-0003 Frontend route-first architecture Accepted
ADR-0004 Transactional outbox + Kafka relay (notification) Accepted
ADR-0005 BFF shared secret + multi-secret rotation Accepted
ADR-0006 서버 측 hashed session cookie (raw token 미저장) Accepted
ADR-0007 MySQL 8 + Flyway (Liquibase/Prisma migrate 기각) Accepted
ADR-0008 Multi-club domain — host header + slug 우선순위 Accepted
ADR-0009 Frontend-backend contract test (Zod schema) Accepted
ADR-0010 공개 저장소 안전 자동화 (gitleaks + custom scanner) Accepted
ADR-0012 Redis를 선택적 보조 상태로 제한 Accepted
ADR-0013 BFF host 헤더 정책 — slug 명시 누락 vs host fallback 분기 Accepted
ADR-0014 BFF secret rotation lifecycle — 4단계 절차 + preflight 진단 엔드포인트 Accepted
ADR-0015 Notification Outbox dedupeKey 정책 Accepted
ADR-0016 Deploy ledger NDJSON event schema + dual-format writer Accepted
ADR-0017 Web과 notification worker process를 분리 운영 Proposed
ADR-0018 사용자 핵심 객체를 모임기록으로 통일 Accepted
ADR-0019 URL이 소유하는 club-scoped workspace identity Accepted
ADR-0020 하나의 브랜드 시스템과 역할별 composition grammar Superseded by ADR-0045
ADR-0021 참석 응답과 실제 출석을 별도 사실로 유지 Accepted
ADR-0022 모임 lifecycle, app audience, 공개 사이트 배치를 독립 축으로 유지 Accepted
ADR-0023 Domain revision으로 host mutation을 조건부 실행 Accepted
ADR-0024 실제 출석에 명시적 UNKNOWN correction 상태 제공 Accepted
ADR-0025 모임 참여자 snapshot이 응답 분모를 소유 Accepted
ADR-0026 Member와 host가 공통 global club shell을 사용 Superseded by ADR-0051
ADR-0027 현재 모임 작업은 local task navigation으로 분리 Superseded by ADR-0044
ADR-0028 Host mutation을 idempotency receipt로 재조정 Accepted
ADR-0029 Mutating API에 BFF secret과 Origin/Referer를 함께 검증 Accepted
ADR-0030 역할 권한과 민감 문서 접근 권한을 분리 Accepted
ADR-0031 Notification 운영 metric tag를 low-cardinality 값으로 제한 Accepted
ADR-0032 Client IP hash salt를 ISO 주 단위로 회전 Accepted
ADR-0033 Business orchestration owner가 transaction boundary를 소유 Accepted
ADR-0034 Client contract generation을 모든 host mutation에 적용 Proposed
ADR-0035 Host authority 상실 시 client의 host-sensitive state를 폐기 Accepted
ADR-0036 Public projection 원자성과 cache convergence를 분리 Proposed
ADR-0037 긴급 public takedown을 platform-admin 전용 command로 실행 Proposed
ADR-0038 Host 모임·기록 목록을 server-owned cursor epoch로 제공 Accepted
ADR-0039 플랫폼 어드민을 task-centered Service Spine으로 구성 Accepted
ADR-0040 플랫폼 어드민 mutation을 도메인 소유 safe-command protocol로 실행 Accepted
ADR-0041 플랫폼 어드민 초대 전달 토큰을 도메인 분리 HMAC으로 재생성 Accepted
ADR-0042 플랫폼 어드민 audit cursor를 V57 digest key로 서명 Accepted
ADR-0043 플랫폼 어드민 support access 사유 evidence를 최소화 Accepted
ADR-0044 호스트 현재 모임을 Focus Deck 단일 주 행동으로 구성 Superseded by ADR-0046
ADR-0045 호스트·플랫폼 관리자 composition을 Focus Deck·Editorial Operations Ledger로 고정 Superseded by ADR-0055
ADR-0046 호스트 워크스페이스를 오늘 트리아지 + 모임 다이어리로 재구성 Superseded by ADR-0048
ADR-0047 플랫폼 어드민을 케이스 데스크 + 운영 서사로 재구성 Superseded by ADR-0050
ADR-0048 호스트 워크스페이스를 모임 생애주기 운영실 + 작업함으로 구성 Accepted
ADR-0049 일정 revision 확인을 접속·참석 응답·실제 출석과 분리 Accepted
ADR-0050 플랫폼 어드민을 오늘 할 일 중심 운영 데스크로 재구성 Accepted
ADR-0051 전역 공간을 플랫폼 운영·내 클럽 두 축으로 고정 Accepted
ADR-0052 OCI 용량과 복구 guardrail Proposed
ADR-0053 승인 시안을 Admin·Host 픽셀 근접 합격 기준으로 사용 Proposed
ADR-0054 코드 네이티브 시안 계약을 호스트·어드민 시각 권위로 사용 Proposed
ADR-0055 공유 브랜드 primitive에 아이콘과 셸 일관성 계약을 포함 Accepted

Active architecture는 architecture.md, 검증 경로는 test-guide.md와 각 ADR의 검증 절을 따른다. Server의 canonical PR gate는 ./scripts/server-ci-check.sh다. 외부 서비스의 가격·한도·API 동작처럼 변할 수 있는 사실은 운영 판단 직전에 공식 source로 다시 확인한다.