projects/P08_stock/DECISIONS/ADR-0421-BRD-V0.2-UPDATE.md

---
adr_id: P08-ADR-0421-BRD-V0.2-UPDATE
project: P08_stock
status: accepted
date: 2026-04-21
owner: 대표님
source: Confluence LGCOMMIE-4362
supersedes: P08-ADR-0421-BRD-V0.1-INTAKE
---

# P08 Upcoming Stock — BRD v0.2 개정본 수신 및 박제

## 결정
LG 컨플루언스 `LGCOMMIE-4362` BRD가 **v0.1 → v0.2** 로 개정되어 재박제.
v0.2 를 P08 공식 요구사항 최신본(canonical)으로 삼고, v0.1은 이력 보존용으로 남긴다.

## 파일
- 원본: [deliverables/BRDv0.2_20260421.docx](../deliverables/BRDv0.2_20260421.docx) (1.2MB)
- 추출본: [deliverables/BRDv0.2_20260421.extracted.md](../deliverables/BRDv0.2_20260421.extracted.md) (710 paragraphs)
- 드롭존 사본: `raw/confluence/BRDv0.2_20260421.docx`
- 이전 버전(이력 보존): [BRDv0.1_20260421.docx](../deliverables/BRDv0.1_20260421.docx)

## v0.1 → v0.2 주요 변경

### 1. 핵심 로직 변경 (⚠ 중요)
| 항목 | v0.1 | v0.2 |
|---|---|---|
| 용어 | ATS (Available Total Stock) | **AS (Available Stock)** |
| 공식 | `ATS = On-hand Stock + Upcoming Stock` | **`AS = On-hand Stock − Reserved Stock + Upcoming Stock`** |
| Buy Now 조건 | On-hand Stock = 0 | On-hand Stock − Reserved Stock = 0 |
| 고객 표기 조건 | Buying qty > On-hand qty | Buying qty > (On-hand qty − Reserved Stock) |

→ **Reserved Stock 개념이 신규 반영됨.** 기존 예약 재고를 차감해서 실질 가용재고로 계산.

### 2. Diagram 섹션 확장
- v0.1: Place Order flow 하나
- v0.2: **Place Order / Cancel / Return / Stock flow** 4종 다이어그램 명시

### 3. OMS Admin 설정 항목 추가
- `10.2.2 Upcoming Stock email configuration` 신설 — 일반 주문 확인 이메일과 분리된 별도 템플릿을 Website Scope 로 설정
- `10.2.3 Upcoming Stock Buffer Date configuration` 신설 — **Warehouse 단위 Buffer Date**를 Website Scope 로 설정
- Mass action 에 **enable/disable rules** 추가 (기존 mass update Apply/Expire/Stock/Buffer Date 외)

### 4. Order grid 기능 강화
- v0.1: 구분 컬럼
- v0.2: **filter + flag** 명시

### 5. 권한 모델 명시 (Non-functional, 신설)
- **HQ role Admin**: 모든 법인(Subsidiary)의 Upcoming Stock 설정/룰 조회
- **Subsidiary Admin**: 해당 법인 범위만

### 6. Non-functional Requirements 섹션 신설
- 성능/보안/권한/운영 항목이 별도 블록으로 분리됨 (v0.1 에는 없음)

### 7. 용어·문구 정돈
- "is out of scope" → "remains unchanged in this BRD" (표현 순화)
- "Addon Bundle (only allow OMD)" → "(only OMD)" 로 간소화
- Dependencies 섹션 → **"Dependencies and Constraints"** 로 명칭 통합

### 8. 설정 Off 시 동작 명시
- Upcoming Stock = No(기본값) → `AS = On-hand Stock − Reserved Stock` (as-is 유지), Buy Now CTA 도 as-is

## 영향 (다운스트림 봇 주의사항)
- **이전 산출물(v0.1 기반) 전부 재검토 대상** — 특히 ATS 공식을 참조한 설계/테스트 케이스.
- FE 의존성 명시됨 → "Buy Now" CTA 룰 변경은 FE 개발·설정에 종속.
- Warehouse 단위 Buffer Date 설정이 추가됨 → 창고 마스터/Website 매핑 필요.
- HQ vs Subsidiary 권한 모델이 설계 단계에 선행되어야 함 (Magento 권한 구조 검토 필요).

## 봇 참조 지침
- **앞으로 모든 P08 후속 작업은 v0.2 extracted.md 를 1차 인용.**
- v0.1 extracted.md 는 변경 이력 확인용으로만 참조 (supersedes 관계).
- 로직 공식은 반드시 v0.2 의 `AS = On-hand − Reserved + Upcoming` 을 사용.

## 선행 ADR
- [ADR-0421-CHARTER-V2-ADOPTED](ADR-0421-CHARTER-V2-ADOPTED.md) — 킥오프 PPT
- [ADR-0421-BRD-V0.1-INTAKE](ADR-0421-BRD-V0.1-INTAKE.md) — v0.1 박제 (본 ADR로 supersede)

## TBU (여전히 대기)
- Target Launching Date, PO, Tech Lead
- Research/Data, Policy 섹션
- Figma UI/UX 링크
- TRD
- Addon Bundle / Package deal 범위 확정