Architecture Decision Records (ADR)¶
중요한 설계·운영 결정을 한 형식으로 기록한다. 회의록이나 PRD가 아니라, 결정과 그 이유만 증류한다.
- 형식은 0000-template.md 하나로 고정한다 — 맥락 · 결정 · 대안 · 결과.
- 한 번 승인된 ADR은 수정하지 않는다. 결정이 바뀌면 새 ADR을 추가하고 옛 ADR의 상태를
대체됨(→ ADR-XXXX)으로 표시한다. - 번호는 순차 증가. 파일명은
NNNN-kebab-제목.md.
| ADR | 제목 | 상태 |
|---|---|---|
| 0001 | 모노레포·폴리글랏 워크스페이스 구조 | 승인됨 |
| 0002 | 에이전트 지침은 AGENTS.md 단일 출처 | 승인됨 |
| 0003 | 브랜치 전략 — dev 경유 엄격한 사다리 | 승인됨 |
| 0004 | Squash 전용 머지 | 대체됨 (→ 0007) |
| 0005 | DB를 단일 계약으로 · 확장-수축 마이그레이션 | 승인됨 |
| 0006 | gateway 단일 엣지 · 라우트별 신뢰 필터 | 대체됨 (→ 0010) |
| 0007 | 머지 전략 — 경계별(feature→dev Squash, dev→main Merge commit) | 승인됨 |
| 0008 | super-admin 콘솔 — cross-tenant 운영자 표면 | 승인됨 |
| 0009 | AWS 배포 토폴로지 — Terraform IaC · 단계 스택 | 제안됨 (gateway 공개 엣지 조항 대체 → 0032·0034 · 배치 구성 대체 → 0028) |
| 0010 | 하이브리드 On-Premise 피벗 — 고객 접점·컴플라이언스의 증권사 이전 | 승인됨 (노출 이력 항목 대체 → 0053) |
| 0011 | RLS 멀티테넌시에서 테넌트별 물리 격리로 전환 | 승인됨 |
| 0012 | Sync 인증서 부트스트랩 — CSR 방식, 개인키 비반출 | 승인됨 |
| 0013 | Exposure Log 기록 — 조회 시점 자동 기록, 고객 해시는 증권사 생성 | 대체됨 (→ 0053) |
| 0014 | 정정 이벤트 처리 — 무조건 재검수 | 대체됨 (→ 0041) |
| 0015 | Sync 프로토콜 — cursor 기반 delta, MVP 스펙과 목표 계약 분리 | 대체됨 (→ 0040) |
| 0016 | 코드베이스 — 단일 레포, 배포 아티팩트 2종 | 승인됨 |
| 0017 | 데모/개발 토폴로지 — 별도 EC2 + Docker Compose 가상 온프렘 | 승인됨 (스택 열거 중 Redis 대체 → 0051) |
| 0018 | Compliance Rule 배포 경로 — Rule Type은 릴리스, Sync 채널은 데이터 전용 | 승인됨 |
| 0019 | 팀 오너십 — Sync 프로토콜 양단 단일 오너, 인터페이스는 계약 하나로 고정 | 대체됨 (→ 0026) |
| 0020 | 검증 반영 — 규제 서사 재정렬 및 설계 정합 일괄 정정 | 승인됨 |
| 0021 | 설계 보강 — DMZ 배치·cursor 발번 시점·정정 리비전 모델 확정 | 승인됨 |
| 0022 | 검증·보강 2차 — 규제 사실관계 외부 검증 및 배치·온보딩 옵션 보강 | 승인됨 |
| 0023 | 고객 검증 반영 — 증권사 현업 리뷰 확보·이해상충은 노출 범위 제외로 통제 | 승인됨 |
| 0024 | MVP 상품 범위 — 국내 ETF, 스키마는 미국 확장성 선반영 | 승인됨 |
| 0025 | 온프렘 콘솔 인증 — SSO/AD 지향 + 데모 자체 계정 하이브리드 | 승인됨 |
| 0026 | 팀 오너십 경계 정정 — 진기는 DB 적재까지, 인터페이스는 DB 스키마 | 승인됨 |
| 0027 | 도메인 ID 체계 — 불투명 서로게이트(ULID), 외부 식별자는 속성 | 승인됨 |
| 0028 | 파이프라인 SFN 통합 — feature/분석 경계 (분석은 ALPHA-806 에서 예고대로 큐 소비자로 분리 → SFN 은 3페이즈) | 승인됨 (raw 게이트 대체 → 0030) |
| 0029 | apps 플레인 그룹핑 · schema 마이그레이션 세트 대칭 명명 | 승인됨 |
| 0030 | raw 페이즈는 부분 실패를 격리한다 — 전량 성공 게이트 제거 | 승인됨 |
| 0031 | serving-api를 Publication 도메인으로 리네이밍 | 승인됨 (호출자·노출 기록 조항 대체 → 0053) |
| 0032 | gateway 은퇴 — 클라우드 엣지를 ALB 직결로 | 승인됨 |
| 0033 | 데모 온프렘 terraform 스택 분리 — 실 클라우드와 state 격리 | 승인됨 (Redis 대체 → 0051 · 데모 프록시 문면 대체 → 0053) |
| 0034 | 공개 엣지 호스트 단위 분리 — 서비스당 ALB 1개, 경로 라우팅 없음 | 승인됨 |
| 0035 | 위젯 UI를 빌드 산출물로 납품 — 실행 서버 없음 | 승인됨 (런타임 경로 문면 대체 → 0053) |
| 0036 | Sync 온프렘 토폴로지 — Sync Agent(DMZ)+Intake(내부망) 2모듈 표준 | 승인됨 (조율 메커니즘 대체 → 0052) |
| 0037 | 점검 실행 모듈 명칭 — Compliance Engine → Screening Worker | 승인됨 |
| 0038 | 온프렘 조회 표준으로 JPA 도입 — 스키마는 Flyway SSOT, 앱은 validate-only | 승인됨 (가변 엔티티 예시 문면 대체 → 0053) |
| 0039 | Screening 판정의 DDD 전환은 사건 기반 — 첫 테넌트 기준 연결이 방아쇠 | 승인됨 |
| 0040 | Sync 번들 무결성 — 체크섬·byte[] 응답을 MVP에서 목표 계약(서명)으로 이관 | 승인됨 |
| 0041 | 정정 리비전도 신규와 동일한 정책 평가 — 0014 대체 | 대체됨 (→ 0044) |
| 0042 | sync Pull 응답을 공통 응답 포맷으로 통일 — 신규 없음 204 폐지 | 승인됨 |
| 0043 | Dataset Contract와 ETF freshness 상태 축 | 승인됨 |
| 0044 | 정정(CORRECTION) 전달 폐지 — 무효화(INVALIDATION) 단독 | 승인됨 |
| 0045 | 실시간 스냅샷 게시 전환 — day-grain 게이트 폐지, 승계와 3축 무효화 | 승인됨 |
| 0046 | 위험등급 융합 산정 폐기 — 확신도 AND 게이트 전환, max_risk 은퇴 | 승인됨 (결정 5 후단 대체 → 0047) |
| 0047 | 금칙어 심각도 은퇴 — 결과를 정하는 축은 처리 방식뿐 | 승인됨 |
| 0048 | 설명 S3 폴백 폐기 — 영속 전제는 LLM 앞에서 검사, bundle 주입 필수화 | 승인됨 |
| 0049 | 스크리닝 LLM 트리아지 층 — 게시 후 감사·검수 확정 회수 | 승인됨 |
| 0050 | 콘솔 규칙 엔진의 사실 공급 — 엔드포인트는 사실만, 평가는 클라이언트 | 승인됨 |
| 0051 | BYOC 배포 토폴로지 — 증권사 클라우드 사상, 단계형 구성과 승격 조건 | 승인됨 |
| 0052 | Sync 온프렘 토폴로지 재검토 — 클라우드 사상에서도 2모듈 표준 유지, 근거 재정초 | 승인됨 |
| 0053 | 고객 컨텍스트 제거 — MTS 위젯 직접 호출, Exposure Log 은퇴 | 승인됨 (응답 형상·204 수렴 문면 대체 → 0054) |
| 0054 | publication-api 설명 조회 응답을 공통 응답 포맷으로 통일 — 설명 없음 204 폐지 | 승인됨 |
| 0055 | KIS 호출 한도를 PostgreSQL 공유 예산으로 통제 — 기본 비활성, 응답 불확실 시 발신 중단 | 제안됨 |
| 0056 | ETF Orca 앱 API(app-api) 클라우드 인프라 — 별도 PostgreSQL·ElastiCache·N 인스턴스·단일 호스트 | 승인됨 |
| 0057 | 레이크 데이터셋 정본과 운영 소비 경로, 승격·폐기 절차 | 제안됨 (적용 보류) |
| 0058 | 유한 배치의 Airflow 실행 환경 — ECS on EC2 자체 운영 | 승인됨 (메타DB 는 기존 업무 RDS 안 DB — ADR 상태 추기) |
| 0059 | 대상 ETF 선정 기준 — 국내 주식형에서 테마별 거래대금 상위 10종 (0024 구체화) | 제안됨 |
| 0060 | 분 가격 수집을 전용 KIS 키로 분리 — 공유 호출 예산은 켜지 않는다 (0055 를 대체하지 않음) | 제안됨 |