KArtSell.Aegis/docs/DECISIONS/ADR-WBS-001-slice-renumbering.md

# ADR-WBS-001: Resolve VS-03/04/12/14 numbering collision

**Date:** 2026-08-08
**Status:** ACCEPTED (partial — see "Not resolved by this ADR" below)
**Decision owner:** 김재현 (per session 2026-08-08 direction: "실제 구현 트래커 유지, WBS_MASTER 갱신" + "구현된 슬라이스를 새 번호로 재배정")

## Context

`docs/CURRENT/CATALOGS/WBS_PROGRESS_TRACKER.csv` and `docs/CURRENT/SLICE_SPECS/` independently
assigned VS-03, VS-04, VS-12, and VS-14 to four slices implemented in 2026-08-07 (PR #23, #24, #28):

| Number used by tracker/specs | Actual slice |
|---|---|
| VS-03 | Model Approval Workflow (Maker-Checker Governance) |
| VS-04 | Immutable Audit Trail (GDPR/Compliance) |
| VS-12 | Trade Execution System (KIS Integration) |
| VS-14 | Portfolio Reconciliation |

These numbers were never checked against `docs/CURRENT/CATALOGS/WBS_MASTER.csv`, the original
666-row plan, which had already assigned the same four numbers to unrelated, still-unimplemented
slices:

| Number in WBS_MASTER.csv | Original planned slice |
|---|---|
| VS-03 | IngestMarketDataPIT (market data PIT ingestion) |
| VS-04 | ApplyCorporateActions (corporate actions processing) |
| VS-12 | RankBuyCandidates (buy candidate ranking) |
| VS-14 | GenerateDailyRecommendations (daily client recommendation packages) |

Separately, `src/KArtSell.Host/Features/MarketData/VS03_*.cs` and
`src/KArtSell.Host/Features/Portfolio/VS04_*.cs` / `VS05_*.cs` / `VS08_*.cs` are a **third**,
already-implemented-and-tested body of work (commits `2bc2b1e`, `32b49a4`, `14c5e4f`, `2eee44d`)
that also uses VS-03/04/05/08, for yet another set of features (Market Data Ingestion Dashboard,
Portfolio Rebalance, Risk Metrics, Dashboard). This body of work is not referenced anywhere in
`WBS_PROGRESS_TRACKER.csv` at all. This ADR does not resolve that — see "Not resolved" below.

## Decision

Renumber the four 2026-08-07 slices to previously-unused numbers, leaving `WBS_MASTER.csv`'s
original VS-03/04/12/14 rows (and the separate `Features/MarketData`/`Features/Portfolio`
VS-03/04/05/08 code) untouched:

| Old number | New number | Slice | Code location |
|---|---|---|---|
| VS-03 | **VS-26** | Model Approval Workflow | `src/KArtSell.Modules.ModelOperations/ApprovalWorkflow/` and `Features/ApprovalWorkflow/` (see DEBT-017 below) |
| VS-04 | **VS-27** | Immutable Audit Trail / GDPR | `src/KArtSell.Modules.ModelOperations/Compliance/` |
| VS-12 | **VS-28** | Trade Execution (KIS) | `src/KArtSell.Modules.ModelOperations/TradeExecution/` |
| VS-14 | **VS-29** | Portfolio Reconciliation | `src/KArtSell.Modules.ModelOperations/PortfolioReconciliation/` |

VS-26 through VS-29 were free (highest number previously used in `WBS_MASTER.csv` was VS-25).

## Why renumber the new slices rather than renumber WBS_MASTER's originals

`WBS_MASTER.csv`'s VS-03/04/12/14 rows are referenced by ID from dozens of other rows across the
666-row file (dependency chains, addendum sections `AEG22-*`, `AEG-V15-*`, `AEG-V16-*` all use
VS-03 to mean "MarketData" consistently throughout). Renumbering those in place would touch 50+
rows with a high chance of missing a cross-reference. The four 2026-08-07 slices have a much
smaller footprint (2 SLICE_SPEC files each side, 2 README.md files, a handful of tracker rows) and
were not yet referenced by ID anywhere else, so moving them was the lower-risk edit.

## What changed

- `docs/CURRENT/SLICE_SPECS/VS-03-SLICE_SPEC.md` → `VS-26-SLICE_SPEC.md` (content updated)
- `docs/CURRENT/SLICE_SPECS/VS-04-SLICE_SPEC.md` → `VS-27-SLICE_SPEC.md` (content updated)
- `docs/CURRENT/SLICE_SPECS/VS-12-SLICE_SPEC.md` → `VS-28-SLICE_SPEC.md` (content updated)
- `docs/CURRENT/SLICE_SPECS/VS-14-SLICE_SPEC.md` → `VS-29-SLICE_SPEC.md` (content updated)
- `src/KArtSell.Modules.ModelOperations/ApprovalWorkflow/README.md` (VS-03→26, VS-04→27 refs updated)
- `src/KArtSell.Modules.ModelOperations/TradeExecution/README.md` (VS-03→26, VS-04→27, VS-12→28, VS-14→29 refs updated)
- `docs/CURRENT/CATALOGS/WBS_PROGRESS_TRACKER.csv` rows `AEG-VS-03-01`/`04-01`/`12-01`/`14-01` renamed to `AEG-VS-26-01`/`27-01`/`28-01`/`29-01`
- `docs/CURRENT/CATALOGS/WBS_MASTER.csv` — 4 summary rows appended (VS-26/27/28/29), original rows untouched
- `CURRENT_ROADMAP.md` updated to reflect the resolution

## Not resolved by this ADR (still needs an explicit decision)

1. **DEBT-017 (duplicate ApprovalWorkflow implementation).** While investigating this
   renumbering, discovered that the VS-26 (formerly VS-03) tracker row credits
   `ApprovalWorkflow/` (Workstream H) with "20/20 tests PASS", but that implementation's
   endpoints are all `[DontRegister]`'d in FastEndpoints — i.e. dead, unreachable code. The
   implementation actually wired into `Program.cs` and reachable over HTTP is
   `Features/ApprovalWorkflow/` (Workstream G), which has no dedicated test file found. This
   ADR does **not** pick a winner between the two. `AEG-VS-26-01`'s status has been changed from
   `COMPLETED` to `BLOCKED` in the tracker pending that decision — see the row's Notes column and
   `TECH_DEBT_REGISTER.md` DEBT-017.
2. **`Features/MarketData`/`Features/Portfolio` (VS-03/04/05/08 Market Data Ingestion Dashboard,
   Portfolio Rebalance, Risk Metrics, Dashboard).** This is real, committed, tested code
   (commits `2bc2b1e`, `32b49a4`, `14c5e4f`, `2eee44d`, `fed750f`, `e0d58ac`) that is completely
   absent from `WBS_PROGRESS_TRACKER.csv`. It is not renumbered by this ADR because it appears to
   be a genuine (if structurally divergent — it lives under `Features/` rather than as its own
   module) implementation attempt at `WBS_MASTER.csv`'s original VS-03/04/05/08 definitions,
   not a new collision. It needs to be added to the tracker with real evidence (test results,
   whether it is wired into `Program.cs`, whether a frontend exists) rather than silently
   inherited into this renumbering. Flagged in `CURRENT_ROADMAP.md` as a follow-up.