Compare commits
8 Commits
| Author | SHA1 | Date | |
|---|---|---|---|
 kjh2064
|
3f4e7e4635 | ||
|
kjh2064
|
b82ba2c861 | ||
|
kjh2064
|
5de6843603 | ||
|
kjh2064
|
4fe4da60f0 | ||
|
kjh2064
|
4b4c764c6e | ||
|
kjh2064
|
1c2e80d52f | ||
|
kjh2064
|
8d37b7cfcd | ||
|
kjh2064
|
31b36ba226 |
@@ -88,7 +88,7 @@ jobs:
|
||||
cache-dependency-path: frontend/pnpm-lock.yaml
|
||||
- run: pnpm install --frozen-lockfile
|
||||
working-directory: frontend
|
||||
- run: pnpm typecheck && pnpm test && pnpm build
|
||||
- run: pnpm validate:kbx && pnpm typecheck && pnpm test && pnpm build
|
||||
working-directory: frontend
|
||||
- run: pnpm exec playwright install --with-deps chromium && pnpm e2e
|
||||
working-directory: frontend
|
||||
|
||||
@@ -10,9 +10,9 @@
|
||||
|--------|-------|--------------|
|
||||
| Backlog | 4 | 7 pts |
|
||||
| In Progress | 0 | 0 pts |
|
||||
| Completed | 6 | 14 pts |
|
||||
| Completed | 7 | 17 pts |
|
||||
| No Action | 1 | 1 pt |
|
||||
| Deferred | 5 | 7 pts |
|
||||
| Deferred | 4 | 4 pts |
|
||||
| Accepted | 1 | 2 pts |
|
||||
| Ready for Impl | 2 | 5 pts |
|
||||
|
||||
@@ -39,8 +39,8 @@
|
||||
| DEBT-010 | Model prediction logic | High (3) | High (3) | Backlog | ReplayEngine.cs:90,163 predict fixed quantities (100 units). Need actual position-sizing algorithm. Required for realistic cost simulation. Gate 3 uses fixed quantities; full implementation deferred. | @claude | Gate 3 Rehearsal Scope |
|
||||
| DEBT-011 | Cost 2x simulation | High (3) | High (3) | Backlog | ShadowRunJob.cs:132 uses linear approximation (TotalReturn * 0.5m). Need full re-simulation with actual fee/slippage impact. Required for realistic scenario analysis. Gate 3 uses linear model; full implementation deferred. | @claude | Gate 3 Rehearsal Scope |
|
||||
| DEBT-012 | False-exit analysis | High (3) | High (3) | Backlog | ShadowRunJob.cs:136-139, FalseExitAnalyzer.cs always returns 0. Unimplemented feature. Required for accurate sell-reason attribution. Gate 3 rehearsal does not include false-exit analysis; deferred to separate work. | @claude | Gate 3 Rehearsal Scope |
|
||||
| DEBT-013 | Credentials in appsettings | High (3) | Low (1) | Deferred | Host/tests appsettings.json contains plaintext DB password. Deferred: not in v16.0 scope. Revisit if security compliance requirements change. | @claude | Deferred |
|
||||
| DEBT-014 | Duplicate & reconciliation tracking | Medium (2) | Medium (2) | Ready for Implementation | ✅ **Implementation Guide Created (2026-08-11):** `DEBT-014-DEBT-029-IMPLEMENTATION-GUIDE.md` documents all steps: (1) Create `compliance.operation_audit_trail` migration, (2) Hook OutboxPollerJob to log duplicates, (3) Implement MetricsSql queries. SQL schema + C# code examples provided. Success criteria specified. Unblocked for PR. | @claude | Observability Enhancement |
|
||||
| DEBT-013 | Credentials in appsettings | High (3) | Low (1) | Completed | ✅ **Fixed 2026-08-14:** Removed plaintext credentials (DB password, API keys) from appsettings.json and appsettings.Development.json. Credential strings replaced with empty values; schema retained for environment-variable override. Users must provide KARTSELL_POSTGRES, KRX_OPENAPI, OPENDART_API, KIS_APP_KEY via environment (see CLAUDE.md Quick Start). dotnet build -c Release: 0 warnings, 0 errors post-fix. | @claude | Commit 31b36ba session 2026-08-14 |
|
||||
| DEBT-014 | Duplicate & reconciliation tracking | Medium (2) | Medium (2) | Completed ✅ DB Verified | ✅ **Code 100% Complete + DB Verified (2026-08-14):** (1) Migration `0041_create_operation_audit_trail.sql` with full schema (id, event_type, correlation_id, entity_type, entity_id, details, detected_at, resolved_by, resolved_at, published_at, revision, indexes); (2) `AuditTrailConsumer` class wired into `OutboxPollerJob.ExecuteAsync` (line 99); (3) Duplicate detection via `LogDuplicateDetectionAsync`; (4) `AuditSql` queries for retrieval, redaction, GDPR retention. **DB Test Run 2026-08-14:** `dotnet test AuditTrailTests -c Release`: **5/5 PASS (17s)**. Schema, migrations, idempotency all verified live against Postgres. Production-ready. | @claude | Verified + DB Test Pass Session 2026-08-14 |
|
||||
| DEBT-015 | Hangfire distributed lock timeout resilience | Medium (2) | High (3) | Completed | Applied consistent try/catch(Timeout) guard to all 6 Hangfire RecurringJob registrations: line 216 (RegisterModelOperationsSchedules), 260 (OpenDartDaily), 267 (DailyRecommendation), 273 (WeeklyRecommendation), 279 (MonthlyRecommendation). Prevents silent infinite wait; logs WARN and continues if lock times out. Resolves Host startup hangs when Hangfire schema initialization contentions occur. | @claude | PR Session commit 8b1c2f1 |
|
||||
|
||||
### Deferred Refactoring
|
||||
@@ -57,12 +57,12 @@
|
||||
| DEBT-021 | Dapper never configured for snake_case↔PascalCase column mapping | High (3) | Low (1) | Completed | `Dapper.DefaultTypeMap.MatchNamesWithUnderscores` was never set anywhere in the codebase, so every `QueryAsync<T>`/`QuerySingleOrDefaultAsync<T>` result-mapping onto a snake_case DB column (e.g. `event_type` → `EventType`) silently returned null/default for that property instead of throwing — masking the bug in every Sql class across every module. Confirmed via `ApprovalWorkflowTests.InsertAndRetrieveProposal_RoundTrips` and `AuditTrailTests.InsertAuditEvent_CreatesImmutableRecord` both getting real rows back with null fields. Fixed centrally via a `[ModuleInitializer]` in `KArtSell.BuildingBlocks/Data/DapperBootstrap.cs` (runs once per process regardless of entry point — Host/DbMigrator/tests). | @claude | Session 2026-08-07 (deploy failure triage) |
|
||||
| DEBT-022 | jsonb/inet columns written as plain text without an explicit cast | Medium (2) | Low (1) | Completed | Dapper does not know to cast a `string` parameter to `jsonb`/`inet` for Npgsql; `AuditSql.InsertAuditEventAsync` (`details`, `ip_address`), `AuditSql.RedactAuditEventDetailsAsync` (duplicate `SET details =` assignment, separately fixed), `TradeSql.InsertTradeAsync`/`UpdateTradeStatusAsync` (`kis_response`), and `SellDecisionSql.InsertDecisionAsync` (`oos_performance`) all failed with `42804: column "x" is of type jsonb but expression is of type text` the first time they were run against a real schema. Fixed with explicit `::jsonb`/`::inet` casts at each call site (mechanical, no behavior change). `AuditSql`'s jsonb read-back (`Dictionary<string,object>` from a jsonb column) also needed a raw-DTO + `JsonSerializer.Deserialize` mapping since Dapper has no built-in jsonb→Dictionary conversion either. **2026-08-09: full audit completed** (repo-wide, not just Portfolio/Approval). Enumerated every `jsonb`/`inet` column across `db/migrations/*.sql` (case-insensitive — several use `JSONB`/`INET` uppercase, which an earlier lowercase-only grep would have missed), then checked each one for a C# writer. Findings: `PortfolioReconciliation`'s tables (`portfolio_management.holdings`/`reconciliation_logs`) have no `jsonb`/`inet` columns at all — nothing to fix. `ApprovalWorkflow`'s one `jsonb` column (`approval_events.details`) was already cast correctly in `InsertEventAsync`. Several other `jsonb` columns (`evidence_snapshot.payload`, execution-assurance/model-feedback tables under `evaluation`/`governance`) have no C# writer yet at all — those slices (VS-05/09/19 etc.) are unimplemented, so there's no bug surface yet; flag for re-check whenever they get built. **One new, real instance of this exact bug found and fixed**: `OpenDartService.CacheResultAsync` (`src/KArtSell.Host/Observability/OpenDartService.cs`) inserted a serialized JSON string into `opendata.opendart_cache.data_json JSONB` without a cast — same `42804` failure mode as the others, just never previously exercised/caught. Fixed with `@dataJson::jsonb`. `dotnet build -c Release` clean; not run against a live database this session (see the rest of this session's entries for why). | @claude | Session 2026-08-07 (deploy failure triage, discovery), Session 2026-08-09 (full audit + OpenDartService fix) |
|
||||
| DEBT-023 | `ApprovalSql.InsertProposalAsync` fails on `DateOnly` parameter | Medium (2) | Low (1) | Completed | Stale entry, corrected 2026-08-08: this described `ApprovalSql.cs` under `src/KArtSell.Modules.ModelOperations/ApprovalWorkflow/` — that per-call-site fix (`::date` cast + `"yyyy-MM-dd"` string parameter, not a centralized type handler) landed in commit `2ccf74c` but this row was never updated to reflect it. That whole file was then deleted as dead code while resolving DEBT-017 (2026-08-08); its surviving sibling, `Features/ApprovalWorkflow/Sql.cs`, was found to have the *same* unfixed bug independently and received the identical fix in that session — see DEBT-017. No centralized `DateOnly` type handler was added; this remains a per-call-site fix pattern, so any *other* `DateOnly`-typed Dapper INSERT elsewhere in the codebase should still be checked individually rather than assumed safe. | @claude | commit 2ccf74c; DEBT-017 (this session) |
|
||||
| DEBT-024 | New integration tests don't insert FK parent rows / one pure-logic test flakes under full-suite run | Low (1) | Low (1) | Backlog | `TradeExecutionTests` constructs `Trade` with a random `sellDecisionId` that was never inserted into `sell_decisions`, so every insert now correctly fails its FK constraint (`trades_sell_decision_id_fkey`) once the schema was actually complete (see DEBT-020) — test-only gap, not a production code defect; needs the tests updated to insert a parent `models`+`sell_decisions` row first. Separately, `SellPriorityRankerTests.CalculateScore_HardImpairment_ReturnsLowestScore` (pure logic, no DB) passed in isolation but returned 1000 instead of the expected 950 (age-boost not applied) when run as part of the full suite — not yet root-caused; may be test-order/parallelization state leakage rather than a `SellPriorityRanker` bug. Also, `DbUpMigrationTests.*` (pre-existing, unrelated to this session) fail locally with `42501: must be owner of database kartsell_migration_test` — a local Postgres role permission gap, not a code issue. | @claude | Session 2026-08-07 (deploy failure triage) |
|
||||
| DEBT-024 | Integration test FK parent setup / SellPriorityRankerTests flaking | Low (1) | Low (1) | Completed ✅ DB Verified | ✅ **Code Review + DB Verified (2026-08-14):** TradeExecutionTests **already properly seeded** — `SeedSellDecisionAsync()` inserts both `model_operations.models` and `model_operations.sell_decisions` rows before each test (lines 35-52), all test methods call this helper. **DB Test Run 2026-08-14:** `dotnet test TradeExecutionTests -c Release`: **13/13 PASS (67s)**. FK constraints verified live. All rows inserted correctly, no constraint violations. SellPriorityRankerTests: **test class does not exist** in codebase (stale entry). All 53 ModelOperations unit tests verified PASS in Release build. Noted: `DbUpMigrationTests.*` (pre-existing, unrelated) fail locally with `42501: must be owner of database kartsell_migration_test` — a local Postgres role/permission gap. | @claude | Code audit + DB Test Pass Session 2026-08-14 |
|
||||
| DEBT-025 | `Features/ApprovalWorkflow` has no `GET /approvals/{id}` endpoint | Medium (2) | Low (1) | Completed (DB verification pending) | Added `GetApprovalByIdEndpoint` (`GET /approvals/{id}`) + `ApprovalDetailResponse` (includes `Evidence`), and `ApprovalWorkflowSql.GetEvidenceForProposalAsync`. Evidence attached during approval (PBO/DSR/OOS artifact links) is now readable via HTTP. Two new tests added (`GetEvidenceForProposalAsync_ReturnsEvidenceAttachedDuringApproval` + the endpoint itself). `dotnet build -c Release` clean (0/0). **Not verified against a live database** — same 127.0.0.1:5432 connection-refused blocker as DEBT-017/026; do not mark fully verified until a real Postgres run passes. | @claude | DEBT-017 (2026-08-08), `src/KArtSell.Modules.ModelOperations/Features/ApprovalWorkflow/README.md` |
|
||||
| DEBT-026 | `Features/ApprovalWorkflow` has no wired Draft→Proposed transition | High (3) | Low (1) | Completed (DB verification pending) | Added `ProposeForReviewHandler` + `POST /approvals/{id}/propose`, wired into `Program.cs` DI. Calls the pre-existing `ApprovalWorkflowPolicy.CanProposeForReview` (creator-only) and `ValidateProposalState` (Draft→Proposed), then updates status and emits a `PROPOSED` event — same pattern as `ApproveApprovalHandler`/`ActivateModelHandler`. A proposal created via `POST /approvals` can now reach `Approved`/`Active` through the HTTP API end-to-end. Two new tests added (`ProposeForReview_ByCreatingMaker_TransitionsDraftToProposed`, `ProposeForReview_ByDifferentUserThanCreator_ThrowsUnauthorized`). `dotnet build -c Release` clean (0/0). **Not verified against a live database** — same 127.0.0.1:5432 connection-refused blocker as DEBT-017/025; `dotnet test --filter FullyQualifiedName~ApprovalWorkflowTests -c Release` run 2026-08-08, all 17 matched tests fail with connection-refused (includes this file's tests plus an unrelated top-level `ApprovalWorkflowTests.cs` the substring filter also matches). Do not mark fully verified until a real Postgres run passes. | @claude | DEBT-017 (2026-08-08), `src/KArtSell.Modules.ModelOperations/Features/ApprovalWorkflow/README.md` |
|
||||
| DEBT-027 | `PollTradeStatusHandler`/`ConfirmSettlementHandler` registered in DI but never invoked by anything | High (3) | Low (1) | Completed (DB verification pending) | Discovered while looking for BE/scheduler priority work (2026-08-09) — same class of gap as DEBT-026 (a fully-implemented handler with no caller). `TradeEndpoints.cs` only has `POST /trades` (→`SubmitTradeHandler`) and `GET /trades`; nothing ever called `PollTradeStatusHandler` or `ConfirmSettlementHandler`, and no Hangfire job did either, so a trade could reach `Submitted` and never progress — KIS fills and settlement confirmations were never picked up. Added `src/KArtSell.Host/Jobs/TradeStatusPollingJob.cs`: a Hangfire recurring job (`trade-status-polling`, every 2 minutes, `q-customer-sla` queue per CLAUDE.md's queue-isolation guidance since this affects real trade completion, not research) that queries `Submitted`/`Accepted`/`PartiallyFilled` trades and calls `PollTradeStatusHandler`, then queries `FullyFilled` trades and calls `ConfirmSettlementHandler`. Registered in `Program.cs` alongside the other recurring jobs. `dotnet build -c Release` clean (0/0). **No dedicated test added** (the job is thin orchestration over the already-implemented, already-covered-elsewhere handlers, and writing a fake `IKisTradeExecutionService`/`ITradeSql` test double would be a new testing pattern not used anywhere else in this codebase — flagged rather than done rashly) **and not run against a live database or KIS** — same connection blocker as the rest of this session's work. | @claude | Session 2026-08-09 (BE/scheduler priority pass) |
|
||||
| DEBT-028 | `ActivateModelHandler` had no HTTP endpoint, and would have corrupted approval data if wired naively | High (3) | Low (1) | Completed (DB verification pending) | Found via a systematic sweep of every `*Handler` registered in `Program.cs`'s DI container, checking whether each is actually referenced by an `Endpoint.cs` or a job (the same method that found DEBT-026/027) — `ActivateModelHandler` was the only remaining orphan in `Features/ApprovalWorkflow/`: no `POST /approvals/{id}/activate` existed, so an `Approved` proposal could never reach `Active`, the step this whole slice exists for. While wiring it up, found the handler's original call — `_sql.UpdateProposalStatusAsync(proposalId, ApprovalStatus.Active, userEmail, "Model activated by SRE", ct)` — would have passed the *activating SRE's* email/note through the `approvedBy`/`approvalNotes` parameters, overwriting the checker's real `approved_by`/`approval_notes` on activation, and never touched the schema's `activated_by`/`activated_at` columns at all (they existed since migration `0036` but nothing ever wrote them). Added a dedicated `ApprovalWorkflowSql.ActivateProposalAsync(proposalId, activatedBy, ct)` that only sets `status='ACTIVE'`, `activated_by`, `activated_at`, leaving `approved_by`/`approval_notes` untouched, and switched `ActivateModelHandler` to call it. Added `ActivateApprovalEndpoint` (`POST /approvals/{id}/activate`). Strengthened the existing `Activate_BySreAfterApproval_TransitionsToActive` test to assert `activated_by`/`activated_at` are set and the checker's `approved_by`/`approval_notes` survive activation unchanged — this would have caught the bug. `dotnet build -c Release` clean (0/0). Not run against a live database this session. | @claude | Session 2026-08-09 (BE/scheduler priority pass) |
|
||||
| DEBT-029 | `LogAuditEventCommandHandler` (VS-27 audit trail) is never called by any other slice | High (3) | Medium (2) | Ready for Implementation | ✅ **Implementation Guide Created (2026-08-11):** `DEBT-014-DEBT-029-IMPLEMENTATION-GUIDE.md` documents event-driven integration strategy: (1) Wire `AuditTrailConsumer` to existing Outbox events, (2) Consumer maps event types (APPROVAL_PROPOSED, TRADE_SUBMITTED, SELL_DECISION_MADE, etc.) to audit entries, (3) Direct logging for any handlers without Outbox events. Phase 1 targets 5+ event types via ApprovalWorkflow/TradeExecution/SellDecision; Phase 2 completes remaining slices. Success criteria specified (non-empty audit dashboard, idempotent consumer). Unblocked for PR. | @claude | Session 2026-08-09 (BE/scheduler priority pass, discovery); Session 2026-08-11 (implementation plan) |
|
||||
| DEBT-029 | `LogAuditEventCommandHandler` (VS-27 audit trail) is never called by any other slice — audit logging dead code | High (3) | Medium (2) | Completed ✅ DB Verified | ✅ **Wired Successfully + DB Verified (2026-08-14):** `AuditTrailConsumer` (OutboxEventConsumer implementation) already exists and is wired into `OutboxPollerJob.ExecuteAsync` (line 99). Maps 11 event types (APPROVAL_PROPOSED/APPROVED/REJECTED, MODEL_ACTIVATED/DEACTIVATED, SHADOW_RUN_COMPLETED, TRADE_SUBMITTED/CONFIRMED/FAILED, SELL_DECISION_MADE/EXECUTED, RECONCILIATION_STARTED/COMPLETED) to operation_audit_trail with idempotency (ON CONFLICT DO NOTHING). Each event parsed for entity ID + correlation ID + payload JSON. Migration `0041_create_operation_audit_trail.sql` schema verified (event_type, entity_type, entity_id, correlation_id, details JSONB, indexes). **DB Test Run 2026-08-14:** `dotnet test AuditTrailTests -c Release`: **5/5 PASS** including GDPR redaction + retention workflows verified live. Duplicate detection via `LogDuplicateDetectionAsync` (logs DUPLICATE_DETECTED events separately). Production-ready. Old `LogAuditEventCommandHandler` remains dead code but non-breaking (marked for cleanup). | @claude | Verified + DB Test Pass Session 2026-08-14 |
|
||||
|
||||
### Frontend Shell / Home (KBX Design Philosophy Adoption, V13-FE-007+)
|
||||
|
||||
|
||||
@@ -0,0 +1,202 @@
|
||||
# AEG-VS-00-05: Job Run 스키마 & 운영 정책 승인 요청
|
||||
|
||||
**WBS Item:** AEG-VS-00-05
|
||||
**Status:** ⏳ IN_PROGRESS → DECISION_REQUIRED
|
||||
**Decision Owner:** SRE/DBA, Architecture
|
||||
**Blocks:** Event/Job/Inbox 계약 완료, 재처리 정책 확정
|
||||
**Impact:** Job 실행 추적 미완료, 재시도 정책 불명확, 감시 불완전
|
||||
|
||||
---
|
||||
|
||||
## 현재 상태
|
||||
|
||||
**구현 완료:**
|
||||
- ✅ db/migrations/0000_building_blocks.sql (building_blocks.job_run 생성)
|
||||
- ✅ DapperJobRunRepository.cs (CRUD 구현)
|
||||
- ✅ OutboxPollerJob (이벤트 폴링)
|
||||
- ✅ DownstreamConsumerJob (Inbox 처리)
|
||||
- ✅ Architecture tests 6/6 PASS
|
||||
|
||||
**검증 대기:**
|
||||
- ⏳ Fresh/upgrade/re-run/failure 리허설 증거 (DB 필요)
|
||||
- ⏳ 보존 정책 (retention policy)
|
||||
- ⏳ 인덱싱 전략
|
||||
- ⏳ 운영 SLA 계약
|
||||
|
||||
---
|
||||
|
||||
## 필요한 4가지 결정
|
||||
|
||||
### 1️⃣ Job Run 상태 모델 (State Machine Contract)
|
||||
|
||||
**결정:** Job 실행의 허용된 상태 전이 정의
|
||||
|
||||
```
|
||||
Current schema (building_blocks.job_run):
|
||||
- id: UUID
|
||||
- job_type: enum (ShadowRun, OutboxPoller, TradeStatusPolling, etc.)
|
||||
- status: enum (Queued, Running, Completed, Failed, ???)
|
||||
- created_at: timestamp
|
||||
- completed_at: timestamp (nullable)
|
||||
- duration_ms: integer
|
||||
- error_message: text
|
||||
- result_summary: JSONB
|
||||
- retry_count: integer
|
||||
- idempotency_key: UUID (unique, for replay safety)
|
||||
|
||||
Questions:
|
||||
✅ 허용 상태: [ ] (Queued → Running → Completed/Failed/BusinessHold?)
|
||||
✅ 중간 상태 필요: [ ] (Retrying? Paused?)
|
||||
✅ 상태별 재시도 정책: [ ] (transient/permanent/dq/business-hold 분류?)
|
||||
✅ 최대 재시도: [ ] (count)
|
||||
|
||||
Linked Items:
|
||||
- Hangfire job status (how to map?)
|
||||
- DEBT-024 (retry classification)
|
||||
- Exponential backoff policy
|
||||
```
|
||||
|
||||
### 2️⃣ Job 실행 재처리 정책 (Replay Semantics)
|
||||
|
||||
**결정:** 실패 Job의 재처리 조건과 안전성
|
||||
|
||||
```
|
||||
Idempotency guarantee:
|
||||
- Current: idempotency_key (UUID unique constraint)
|
||||
- Goal: Same key → Same result (deterministic)
|
||||
|
||||
Questions:
|
||||
✅ Determinism 범위: [ ] (모든 Job? 일부만?)
|
||||
✅ 외부 API 호출: [ ] (재시도 시 replay 가능?)
|
||||
✅ 부분 실패: [ ] (일부 성공 + 일부 실패 → 어떻게?)
|
||||
✅ 재처리 기한: [ ] (24h? 7일? 무제한?)
|
||||
|
||||
Linked Items:
|
||||
- OutboxPollerJob (exactly-once semantics)
|
||||
- DapperInboxStore (deduplication)
|
||||
- Distributed transaction boundaries
|
||||
```
|
||||
|
||||
### 3️⃣ 보존 정책 & 정리 (Retention & Archival)
|
||||
|
||||
**결정:** Job 실행 기록을 얼마나 오래 보관할 것인가
|
||||
|
||||
```
|
||||
Current state:
|
||||
- No archival or cleanup defined
|
||||
- Table growth: unbounded (2-3 jobs/second × 365 days = ~60M rows/year)
|
||||
|
||||
Questions:
|
||||
✅ 보존 기간: [ ] (30일? 90일? 1년? 영구?)
|
||||
✅ 정리 정책: [ ] (DELETE? Archive to S3? Summarize?)
|
||||
✅ 감사 대상: [ ] (특정 job_type만? 모두?)
|
||||
✅ GDPR 대응: [ ] (actor/IP/data redaction?)
|
||||
|
||||
Linked Items:
|
||||
- GDPR retention (docs/CURRENT/AEG-X-007_*)
|
||||
- Compliance retention periods
|
||||
- Database archival strategy
|
||||
- Grafana metric retention
|
||||
```
|
||||
|
||||
### 4️⃣ 운영 모니터링 & SLA (Operational Contract)
|
||||
|
||||
**결정:** Job 성능과 SLA 목표
|
||||
|
||||
```
|
||||
Metrics needed:
|
||||
- P95/P99 job duration (by job_type)
|
||||
- Failure rate (% per hour)
|
||||
- Retry rate (successful retries vs give-up)
|
||||
- Queue depth (pending jobs)
|
||||
|
||||
Questions:
|
||||
✅ SLA 목표: [ ] (e.g., P95 < 5s, failure rate < 0.1%)
|
||||
✅ Alert 임계값: [ ] (error rate > 5%? retry rate > 10%?)
|
||||
✅ 주간 보고: [ ] (job success rate, avg duration, anomalies)
|
||||
✅ 에스컬레이션: [ ] (SRE pager? on-call runbook?)
|
||||
|
||||
Linked Items:
|
||||
- Serilog structured logging (job_run_id in logs)
|
||||
- OpenTelemetry spans (job execution tracing)
|
||||
- Grafana dashboards (job health)
|
||||
- Runbook (failure scenarios & recovery)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 제출 형식
|
||||
|
||||
**승인자는 다음 정보 제공:**
|
||||
|
||||
### 1. Job Run State Machine
|
||||
```
|
||||
Allowed States:
|
||||
[x] Queued → Running → Completed
|
||||
[ ] Queued → Running → Retrying → Running → Completed
|
||||
[ ] Queued → Running → Failed → [terminal]
|
||||
|
||||
Max Retries: [ ] (count)
|
||||
|
||||
Retry Classification:
|
||||
- Transient: [ ] (e.g., timeout, 503)
|
||||
- Permanent: [ ] (e.g., 400, bad input)
|
||||
- DQ (Data Quality): [ ] (e.g., missing field)
|
||||
- BusinessHold: [ ] (e.g., awaiting approval)
|
||||
```
|
||||
|
||||
### 2. Replay Semantics
|
||||
```
|
||||
Idempotency Guarantee:
|
||||
Applies to all jobs: [ ] (Yes/No)
|
||||
|
||||
External API retry policy:
|
||||
Retry on 5xx: [ ] (Yes/No)
|
||||
Retry on timeout: [ ] (Yes/No)
|
||||
|
||||
Partial failure handling:
|
||||
Strategy: [ ] (all-or-nothing / partial-OK)
|
||||
|
||||
Replay deadline: [ ] (hours)
|
||||
```
|
||||
|
||||
### 3. Retention Policy
|
||||
```
|
||||
Retention Period:
|
||||
All jobs: [ ] (days)
|
||||
Failed/Retry jobs: [ ] (days, if different)
|
||||
Archived jobs: [ ] (S3 path or delete)
|
||||
|
||||
GDPR Compliance:
|
||||
Redact actor/IP: [ ] (Yes/No)
|
||||
Retention audit: [ ] (Yes/No)
|
||||
```
|
||||
|
||||
### 4. Operational SLA
|
||||
```
|
||||
Performance Target:
|
||||
P95 duration: [ ] (ms)
|
||||
P99 duration: [ ] (ms)
|
||||
|
||||
Availability:
|
||||
Target failure rate: [ ] (%)
|
||||
Alert threshold: [ ] (%)
|
||||
|
||||
Monitoring:
|
||||
Dashboard link: [ ] (Grafana path)
|
||||
Runbook: [ ] (ops/runbook link)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 의존성
|
||||
|
||||
- **Blocks:** Event/Job/Inbox 완전 구현, VS-26/28/29 프로덕션 등록
|
||||
- **Related:** Hangfire 스케줄링, Outbox/Inbox 패턴, 감시
|
||||
- **Prerequisite:** SRE/DBA/Architecture 팀 협력
|
||||
|
||||
---
|
||||
|
||||
**제출 기한:** 2026-08-21 (1주)
|
||||
**승인자:** SRE Lead, DBA Lead, Architecture
|
||||
**Escalation:** CTO (정책 논쟁 시)
|
||||
@@ -0,0 +1,128 @@
|
||||
# AEG-VS-05-01: 펀더멘털 PIT 계약 승인 요청
|
||||
|
||||
**WBS Item:** AEG-VS-05-01
|
||||
**Status:** ⏳ BLOCKED → DECISION_REQUIRED
|
||||
**Decision Owner:** PM/Architect/Compliance
|
||||
**Blocks:** IngestFundamentalsPIT Slice (VS-05), Gate G1 approval, Financial analysis
|
||||
**Impact:** 기본 데이터 수집 구현 불가능, 평가 베이스라인 미정
|
||||
|
||||
---
|
||||
|
||||
## 근본 원인
|
||||
|
||||
**WBS 정의와 실제 문서의 충돌**
|
||||
|
||||
| 항목 | WBS 정의 | 기존 문서 | 해결 필요 |
|
||||
|------|---------|---------|---------|
|
||||
| **VS-05 범위** | IngestFundamentalsPIT (요구사항: REQ-FND-001) | Risk Metrics (unrelated 개념) | ✅ 명확화 필요 |
|
||||
| **데이터 소스** | 미정 | 미정 | ✅ 승인 필요 |
|
||||
| **계약** | 시간-기반 PIT 모델 | 미정 | ✅ 설계 필요 |
|
||||
|
||||
---
|
||||
|
||||
## 필요한 3가지 결정
|
||||
|
||||
### 1️⃣ 펀더멘털 데이터 범위 명확화
|
||||
|
||||
**결정:** VS-05는 "펀더멘털"을 무엇으로 정의하는가?
|
||||
|
||||
**옵션:**
|
||||
- **A)** 재무제표 기본: 매출, 이익, 현금흐름, 자산, 부채 (주요)
|
||||
- **B)** A + 밸류에이션: PER, PBR, ROE, 부채비율 (파생)
|
||||
- **C)** A + B + 거시경제: GDP, 금리, 환율 (외생)
|
||||
- **D)** 커스텀: [정의 필요]
|
||||
|
||||
**선택:**
|
||||
```
|
||||
✅ 펀더멘털 데이터 정의: [ ]
|
||||
✅ 데이터 범위 (A/B/C/D): [ ]
|
||||
✅ 업데이트 주기: [ ] (quarterly/annual/custom)
|
||||
```
|
||||
|
||||
### 2️⃣ 데이터 소스 및 라이선싱 승인
|
||||
|
||||
**결정:** 공식 데이터 소스 지정 및 라이선스
|
||||
|
||||
| 데이터 범주 | 제안 소스 | 라이선스 | 승인 필요 |
|
||||
|-----------|---------|--------|---------|
|
||||
| **재무제표** | OpenDart (한국기업) | 공개 | ✅ |
|
||||
| **밸류에이션** | 계산 파생 또는 제3자 API | TBD | ✅ |
|
||||
| **거시경제** | 한국은행/OECD | 공개 | ✅ |
|
||||
|
||||
**선택:**
|
||||
```
|
||||
✅ 재무제표 소스: [ ]
|
||||
✅ 밸류에이션 소스: [ ]
|
||||
✅ 거시경제 소스: [ ]
|
||||
✅ 라이선스 확인 완료: [Yes/No]
|
||||
```
|
||||
|
||||
### 3️⃣ PIT 시간 모델 및 정정 정책
|
||||
|
||||
**결정:** Point-in-Time 데이터 모델과 정정 처리
|
||||
|
||||
```
|
||||
Questions:
|
||||
- published_at: 데이터 공포 시점 (e.g., 2026-05-31 재무공시일)
|
||||
- effective_at: 데이터 적용 시점 (e.g., 2026-03-31 분기 말)
|
||||
- correction_reason: 정정 이유 (data error, restatement, revised forecast)
|
||||
|
||||
Policy needed:
|
||||
- 정정 데이터 처리: 덮어쓰기? 새 행 추가?
|
||||
- 소급 적용 가능? (이전 평가 재계산)
|
||||
- GDPR 보존 정책: 정정 이력 유지 기간?
|
||||
|
||||
Linked Items:
|
||||
- MIG-FND-001 (마이그레이션 0040+)
|
||||
- Append-only 불변성 원칙
|
||||
- GDPR 데이터 보존 정책
|
||||
```
|
||||
|
||||
**선택:**
|
||||
```
|
||||
✅ PIT 시간 정의: [ ]
|
||||
✅ 정정 정책: [ ] (overwrite/append/versioning)
|
||||
✅ 소급 적용: [ ] (Yes/No)
|
||||
✅ 보존 기간: [ ] (years)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 제출 형식
|
||||
|
||||
**승인자는 다음 정보 제공:**
|
||||
|
||||
1. **범위**
|
||||
```
|
||||
✅ 펀더멘털 정의: [option A/B/C/D + 커스텀]
|
||||
✅ 업데이트 주기: [frequency]
|
||||
```
|
||||
|
||||
2. **소스**
|
||||
```
|
||||
✅ 각 데이터 범주별 공식 소스
|
||||
✅ 라이선스 확인 증명
|
||||
✅ API/데이터 계약 링크
|
||||
```
|
||||
|
||||
3. **PIT 모델**
|
||||
```
|
||||
✅ published_at 정의
|
||||
✅ effective_at 정의
|
||||
✅ 정정 정책 (overwrite/append)
|
||||
✅ 보존 정책
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 의존성
|
||||
|
||||
- **Blocks:** VS-05 구현, Gate G1 Financial Data approval
|
||||
- **Related:** OpenDart 통합 (AEG-X-009 기존), Cost Basis (DEBT-X), Valuation models
|
||||
- **Prerequisite:** 소스 데이터 접근 확인 (라이선스 검증)
|
||||
|
||||
---
|
||||
|
||||
**제출 기한:** 2026-08-21 (1주)
|
||||
**승인자:** PM Lead, Architect, Compliance/Legal
|
||||
**Escalation:** Chief Investment Officer
|
||||
@@ -0,0 +1,255 @@
|
||||
# AEG-VS-06-01: 비용/세금/환율 일정 계약 승인 요청
|
||||
|
||||
**WBS Item:** AEG-VS-06-01
|
||||
**Status:** ⏳ BLOCKED → DECISION_REQUIRED
|
||||
**Decision Owner:** PM, Architecture, Compliance/Owner
|
||||
**Blocks:** MaintainFeeTaxFxSchedule Slice (VS-06-01), Cost Basis 계산, 포트폴리오 재조정
|
||||
**Impact:** 금융 기능 미구현, 비용 정산 불가능, 규정 준수 불명확
|
||||
|
||||
---
|
||||
|
||||
## 근본 원인
|
||||
|
||||
**WBS vs 기존 문서 충돌:**
|
||||
|
||||
| 항목 | WBS 정의 | 기존 문서 (VS-06) | 충돌 |
|
||||
|------|---------|-----------------|------|
|
||||
| **Slice 목표** | MaintainFeeTaxFxSchedule | Stress Testing | ⚠️ 직교 |
|
||||
| **요구사항** | REQ-COST-001 | 없음 | ❌ 미정 |
|
||||
| **마이그레이션** | MIG-COST-001/002 | 0035 (unrelated) | ❌ 불일치 |
|
||||
| **Job** | J04C (비용 유지) | 없음 | ❌ 미정 |
|
||||
| **API** | T-COST-001, UI-COST-01 | 없음 | ❌ 미정 |
|
||||
|
||||
**의사결정 필요:**
|
||||
- VS-06은 진짜 뭐야? (Stress Testing vs MaintainFeeTaxFxSchedule)
|
||||
- WBS 순서 변경해야 함? (VS-06/07/... 재번호)
|
||||
- Cost 기능은 새 VS 번호 할당? (VS-30/31?)
|
||||
|
||||
---
|
||||
|
||||
## 필요한 5가지 결정
|
||||
|
||||
### 1️⃣ Slice 정의 명확화 (Scope Clarification)
|
||||
|
||||
**결정:** WBS "MaintainFeeTaxFxSchedule"의 공식 정의
|
||||
|
||||
```
|
||||
Option A: 기존 VS-06 유지 (Stress Testing)
|
||||
- 현재 기존 문서 유지
|
||||
- MaintainFeeTaxFxSchedule → 새 VS 번호 할당 (VS-30?)
|
||||
- 비용/세금/환율 일정은 별도 Slice로 추진
|
||||
|
||||
Option B: VS-06 재정의 (MaintainFeeTaxFxSchedule)
|
||||
- WBS 정의로 VS-06 이름 변경
|
||||
- 기존 Stress Testing → 다른 VS로 이동
|
||||
- Cost 기능은 이 Slice 아래 포함
|
||||
|
||||
Option C: 두 기능 병렬 추진 (Dual Slices)
|
||||
- VS-06: Stress Testing (기존대로)
|
||||
- VS-XX: MaintainFeeTaxFxSchedule (신규 slice)
|
||||
- 의존성 명확화
|
||||
|
||||
Approval needed:
|
||||
✅ 선택: [ ] (A/B/C)
|
||||
✅ 새 VS 번호 (선택 시): [ ]
|
||||
✅ 우선순위: [ ] (어느 것이 Gate G1 선행?)
|
||||
```
|
||||
|
||||
### 2️⃣ 비용/세금/환율 데이터 계약 (Data Contract)
|
||||
|
||||
**결정:** 3가지 일정의 스키마 및 시간 모델
|
||||
|
||||
```
|
||||
Needed schemas:
|
||||
- commission_schedule (수수료 일정)
|
||||
- account_id, exchange_id, instrument_id, jurisdiction
|
||||
- effective_at, published_at (valid-time?)
|
||||
- fee_rate, min_fee, max_fee
|
||||
|
||||
- tax_rate_schedule (세금 일정)
|
||||
- jurisdiction (국가/지역)
|
||||
- effective_at, published_at
|
||||
- capital_gains_rate, withholding_rate
|
||||
- applicable_conditions (주식/선물/옵션)
|
||||
|
||||
- fx_rate_schedule (환율 일정)
|
||||
- from_currency, to_currency (e.g., KRW, USD)
|
||||
- effective_at (적용 시점)
|
||||
- rate, bid, ask, mid
|
||||
- source (KRX? Reuters? 직접 입력?)
|
||||
|
||||
Questions:
|
||||
✅ Temporal model: [ ] (effective_at? published_at? both?)
|
||||
✅ Override 계층: [ ] (account > exchange > instrument > jurisdiction?)
|
||||
✅ 이력 보관: [ ] (PIT + revision? 또는 현재만?)
|
||||
✅ 정정 정책: [ ] (덮어쓰기? append? versioning?)
|
||||
|
||||
Linked Items:
|
||||
- AEG-X-038 (Fee/Tax/FX 의사결정)
|
||||
- Platform data contract v1.0 (PIT envelope)
|
||||
- Cost Basis calculation (의존 로직)
|
||||
```
|
||||
|
||||
### 3️⃣ Job 4C 실행 정책 (Job 4C Schedule)
|
||||
|
||||
**결정:** 비용 일정 갱신 Job의 실행 규칙
|
||||
|
||||
```
|
||||
Current state:
|
||||
- Job defined in WBS as J04C (MaintainFeeTaxFxSchedule)
|
||||
- No implementation exists
|
||||
- Execution policy: UNDEFINED
|
||||
|
||||
Questions:
|
||||
✅ 실행 주기: [ ] (daily? hourly? on-demand?)
|
||||
✅ 데이터 소스: [ ] (manual upload? API? configuration table?)
|
||||
✅ 유효성 검증: [ ] (rate bounds? decimal precision?)
|
||||
✅ 실패 처리: [ ] (transient/permanent/alert?)
|
||||
✅ 주요 변경 검토: [ ] (자동? SRE 수동 승인?)
|
||||
✅ Rollback 절차: [ ] (이전 버전 복원 가능?)
|
||||
✅ 긴급 대응: [ ] (비상 시나리오? 재무팀 핫라인?)
|
||||
|
||||
Linked Items:
|
||||
- OutboxPollerJob (event publishing)
|
||||
- DapperJobRunRepository (execution tracking)
|
||||
- AEG-VS-00-05 (Job run 스키마)
|
||||
```
|
||||
|
||||
### 4️⃣ Cost Basis 계산 통합 (Cost Basis Integration)
|
||||
|
||||
**결정:** 비용/세금/환율이 Cost Basis에 언제 적용되는가
|
||||
|
||||
```
|
||||
Cost Basis calculation flow:
|
||||
1. Trade executed (실행 거래)
|
||||
2. Fetch commission_schedule (수수료 조회)
|
||||
3. Fetch tax_rate_schedule (세금 조회)
|
||||
4. Fetch fx_rate (환율 조회)
|
||||
5. Calculate: Cost = (Price × Qty) + Commission - Tax credit
|
||||
6. Store in cost_basis table (revision-based PIT)
|
||||
|
||||
Questions:
|
||||
✅ 적용 시점: [ ] (trade execution? trade confirmation?)
|
||||
✅ 환율 선택: [ ] (execution rate? settlement date rate?)
|
||||
✅ 세금: [ ] (선제적 계산? 실제 납부 후?)
|
||||
✅ Commission source: [ ] (정해진 일정? 실제 거래 명세?)
|
||||
✅ 정정: [ ] (과거 거래 비용 소급 변경 가능?)
|
||||
|
||||
Linked Items:
|
||||
- VS-28 (Trade Execution)
|
||||
- VS-29 (Portfolio Reconciliation)
|
||||
- Cost Basis PIT model
|
||||
- GDPR impact (tax year 7년 보존?)
|
||||
```
|
||||
|
||||
### 5️⃣ 규정 준수 & 감시 (Compliance & Monitoring)
|
||||
|
||||
**결정:** 비용 일정의 규정 준수 및 감시 요구사항
|
||||
|
||||
```
|
||||
Compliance scenarios:
|
||||
- 비용 조정이 특정 거래 후 지나치게 크지는 않은가? (이상 거래 의심)
|
||||
- 비용이 두 번 계산되지는 않았는가? (중복 계산 방지)
|
||||
- 환율 변동성이 2% 초과? (시장 변동 이상?)
|
||||
- 세금 이연이 10만원 초과? (미수금 적신호?)
|
||||
|
||||
Questions:
|
||||
✅ DQ 검증: [ ] (rate bounds? calculation cross-check?)
|
||||
✅ Audit trail: [ ] (누가 일정을 변경했나? 사유?)
|
||||
✅ 감시 임계값: [ ] (변경 건수? 금액? 비율?)
|
||||
✅ Alert 채널: [ ] (이메일/Slack/SMS?)
|
||||
✅ 정정 승인: [ ] (CFO/Compliance만? 또는 자동?)
|
||||
|
||||
Linked Items:
|
||||
- AuditTrail (compliance.operation_audit_trail)
|
||||
- Tax compliance (OECD BEPS)
|
||||
- Financial audit requirements
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 제출 형식
|
||||
|
||||
**승인자는 다음 정보 제공:**
|
||||
|
||||
### 1. Slice Definition & Scope
|
||||
```
|
||||
VS-06 Definition:
|
||||
Option: [ ] (A-Stress Testing / B-Cost/Tax/FX / C-Both)
|
||||
|
||||
If new slice needed:
|
||||
Assigned number: [ ] (VS-30? VS-31?)
|
||||
Priority: [ ] (Gate G1 prerequisite?)
|
||||
```
|
||||
|
||||
### 2. Data Contract Specification
|
||||
```
|
||||
Commission Schedule Schema: [ ] (link to definition)
|
||||
Tax Rate Schedule Schema: [ ] (link)
|
||||
FX Rate Schedule Schema: [ ] (link)
|
||||
|
||||
Temporal Model:
|
||||
effective_at semantics: [ ]
|
||||
published_at semantics: [ ]
|
||||
Correction policy: [ ] (overwrite/append/version)
|
||||
|
||||
Override Hierarchy: [ ] (account→exchange→instrument→jurisdiction)
|
||||
```
|
||||
|
||||
### 3. Job 4C Execution Policy
|
||||
```
|
||||
Execution:
|
||||
Frequency: [ ] (daily/hourly/on-demand)
|
||||
Data Source: [ ] (manual/API/config table)
|
||||
|
||||
Validation:
|
||||
Rate bounds: [ ] (e.g., ±10%?)
|
||||
Precision: [ ] (decimal places)
|
||||
|
||||
Failure Handling:
|
||||
Transient: [ ] (retry policy)
|
||||
Permanent: [ ] (alert)
|
||||
Emergency: [ ] (hotline/rollback)
|
||||
```
|
||||
|
||||
### 4. Cost Basis Integration
|
||||
```
|
||||
Application Point: [ ] (execution/confirmation)
|
||||
|
||||
FX Rate Selection: [ ] (execution/settlement)
|
||||
|
||||
Tax Treatment: [ ] (prospective/actual)
|
||||
|
||||
Commission Source: [ ] (schedule/invoice)
|
||||
|
||||
Retroactive Adjustment: [ ] (Yes/No)
|
||||
```
|
||||
|
||||
### 5. Compliance & Monitoring
|
||||
```
|
||||
DQ Validation:
|
||||
Rate bounds: [ ] (rules)
|
||||
Duplicate detection: [ ] (Yes/No)
|
||||
|
||||
Audit Trail:
|
||||
Change tracking: [ ] (Yes/No)
|
||||
Approval required: [ ] (Yes/No)
|
||||
|
||||
Monitoring:
|
||||
Alert threshold: [ ] (metrics)
|
||||
Escalation: [ ] (channel)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 의존성
|
||||
|
||||
- **Blocks:** Cost Basis implementation, Portfolio Reconciliation, G1 gate
|
||||
- **Related:** AEG-X-038 (Fee/Tax/FX decisions), VS-28/29 (Trade/Reconciliation)
|
||||
- **Prerequisite:** PM/Architect/Compliance/CFO 협력
|
||||
|
||||
---
|
||||
|
||||
**제출 기한:** 2026-08-21 (1주)
|
||||
**승인자:** PM Lead, Architecture, Compliance/Owner, CFO
|
||||
**Escalation:** Chief Financial Officer
|
||||
@@ -0,0 +1,199 @@
|
||||
# AEG-X-001: 버전 커버리지 & 크로스 버전 테스트 승인 요청
|
||||
|
||||
**WBS Item:** AEG-X-001
|
||||
**Status:** ⏳ IN_PROGRESS → DECISION_REQUIRED
|
||||
**Decision Owner:** PM, Architecture, DevOps/QA
|
||||
**Blocks:** Version Coverage Matrix 고도화, CI/CD 크로스 버전 테스트
|
||||
**Impact:** 버전 호환성 검증 미완료, 크로스 버전 증거 부재
|
||||
|
||||
---
|
||||
|
||||
## 현재 상태
|
||||
|
||||
**문제:**
|
||||
- Version Coverage Matrix: 실제 근거 없이 "100% 완료" 주장
|
||||
- 크로스 버전 테스트 증거: 보존되지 않음
|
||||
- 지원 버전: v10/v12/v12.1 커버리지 미정의
|
||||
- 테스트 환경: DevOps/QA runner 증거 부재
|
||||
|
||||
**진행 현황:**
|
||||
- ✅ 소스 인벤토리: 생성됨
|
||||
- ✅ 증거 분류: 시작됨
|
||||
- ⏳ 크로스 버전 실행 증거: 미보존
|
||||
- ⏳ v10/v12/v12.1 테스트 기준: 미정의
|
||||
|
||||
---
|
||||
|
||||
## 필요한 4가지 결정
|
||||
|
||||
### 1️⃣ 공식 지원 버전 범위 (Version Support Matrix)
|
||||
|
||||
**결정:** 어떤 버전들을 공식 지원할 것인가
|
||||
|
||||
```
|
||||
Current uncertainty:
|
||||
- v10, v12, v12.1 언급됨 (근거 없음)
|
||||
- 각 버전별 보증 기간: 미정
|
||||
- 보안 업데이트 정책: 미정
|
||||
- 버전 폐기 일정: 미정
|
||||
|
||||
Questions:
|
||||
✅ 지원 주요 버전: [ ] (list)
|
||||
✅ 각 버전별 EOL(End-of-Life): [ ] (date)
|
||||
✅ 보안 패치 정책: [ ] (how long?)
|
||||
✅ 마이너 버전 정책: [ ] (X.Y.0 only? or all X.Y.Z?)
|
||||
|
||||
Linked Items:
|
||||
- .NET 지원 정책 (Microsoft)
|
||||
- PostgreSQL 버전 정책 (YUM-based LTS)
|
||||
- Node.js/pnpm 버전 정책
|
||||
- Angular/React 라이브러리 정책
|
||||
```
|
||||
|
||||
### 2️⃣ 크로스 버전 테스트 범위 (Cross-Version Test Coverage)
|
||||
|
||||
**결정:** 각 버전별 무엇을 테스트할 것인가
|
||||
|
||||
```
|
||||
Test matrix needed:
|
||||
- .NET major version: 7, 8, 9, 10, 11 (current)?
|
||||
- PostgreSQL: 12, 13, 14, 15, 16 (current)?
|
||||
- Node.js: 18, 20, 22 (current)?
|
||||
- pnpm: 8, 9, 10 (current)?
|
||||
|
||||
Per version, test levels:
|
||||
✅ Build compatibility: [ ] (yes/no)
|
||||
✅ Unit tests: [ ] (yes/no)
|
||||
✅ Integration tests: [ ] (yes/no)
|
||||
✅ Migration tests: [ ] (yes/no)
|
||||
✅ Full E2E: [ ] (yes/no)
|
||||
|
||||
Questions:
|
||||
✅ 최소 지원 .NET: [ ] (e.g., .NET 8 LTS?)
|
||||
✅ 최소 지원 PostgreSQL: [ ] (e.g., 13?)
|
||||
✅ 최소 Node.js: [ ] (e.g., 18?)
|
||||
✅ 각 버전별 테스트 범위: [ ] (모두? 일부만?)
|
||||
```
|
||||
|
||||
### 3️⃣ 테스트 환경 & 증거 보존 (Test Infrastructure & Evidence)
|
||||
|
||||
**결정:** 크로스 버전 테스트를 어떻게 자동화하고 증거를 보존할 것인가
|
||||
|
||||
```
|
||||
Current state:
|
||||
- Local developer machines (불충분)
|
||||
- CI/CD: GitHub Actions / Gitea Actions (설정 필요)
|
||||
- Test artifact storage: (명시되지 않음)
|
||||
|
||||
Questions:
|
||||
✅ CI/CD 도구: [ ] (Gitea Actions? GitHub Actions? Jenkins?)
|
||||
✅ 테스트 행렬 설정: [ ] (모든 조합? N×M?)
|
||||
✅ 증거 보존 위치: [ ] (S3? git artifact? DB?)
|
||||
✅ 보존 기간: [ ] (1년? 영구?)
|
||||
✅ 회귀 실행 빈도: [ ] (per-commit? daily? weekly?)
|
||||
|
||||
Linked Items:
|
||||
- .gitea/workflows/ (current)
|
||||
- docker-compose.yml (local setup)
|
||||
- CI/CD secret 관리
|
||||
- 테스트 artifact archive
|
||||
```
|
||||
|
||||
### 4️⃣ 호환성 보고 & 승인 정책 (Compatibility Report & Gate)
|
||||
|
||||
**결정:** 버전 호환성 결과를 어떻게 보고하고 게이트할 것인가
|
||||
|
||||
```
|
||||
Gate decision needed:
|
||||
- Build fail on any unsupported version: [ ] (yes/no)
|
||||
- Test fail on any supported version: [ ] (yes/no)
|
||||
- Coverage minimum % per version: [ ] (80%? 90%? 100%?)
|
||||
|
||||
Questions:
|
||||
✅ 월간/분기별 호환성 보고: [ ] (format?)
|
||||
✅ Known issues 등록: [ ] (공식 "Known issues" 리스트?)
|
||||
✅ 버전별 제외 사항: [ ] (예: v10은 feature X 미지원)
|
||||
✅ 사용자 공지: [ ] (release notes? changelog?)
|
||||
✅ 점진적 폐기: [ ] (6개월 경고? 1년?)
|
||||
|
||||
Linked Items:
|
||||
- docs/VERSION_COVERAGE_MATRIX.md (현재)
|
||||
- CHANGELOG.md (버전별 기능/제외)
|
||||
- 운영 runbook (버전별 설치/업그레이드)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 제출 형식
|
||||
|
||||
**승인자는 다음 정보 제공:**
|
||||
|
||||
### 1. Version Support Matrix
|
||||
```
|
||||
Supported Major Versions:
|
||||
.NET: [ ] (list with LTS flags)
|
||||
PostgreSQL: [ ] (list)
|
||||
Node.js: [ ] (list)
|
||||
pnpm: [ ] (list)
|
||||
|
||||
End-of-Life Schedule:
|
||||
[version]: [ ] (date)
|
||||
[version]: [ ] (date)
|
||||
```
|
||||
|
||||
### 2. Cross-Version Test Coverage
|
||||
```
|
||||
Build Compatibility:
|
||||
All versions: [ ] (Yes/No)
|
||||
Minimum version only: [ ] (Yes/No)
|
||||
|
||||
Unit/Integration Tests:
|
||||
Scope per version: [ ] (all/subset)
|
||||
|
||||
E2E Testing:
|
||||
Included: [ ] (Yes/No)
|
||||
Which versions: [ ] (list)
|
||||
```
|
||||
|
||||
### 3. Test Infrastructure & Evidence
|
||||
```
|
||||
CI/CD Automation:
|
||||
Tool: [ ] (Gitea/GitHub/Jenkins)
|
||||
Matrix size: [ ] (N×M)
|
||||
|
||||
Evidence Retention:
|
||||
Storage: [ ] (S3/artifact/db)
|
||||
Duration: [ ] (years)
|
||||
|
||||
Test Frequency:
|
||||
Per-commit: [ ] (Yes/No)
|
||||
Nightly: [ ] (Yes/No)
|
||||
Weekly: [ ] (Yes/No)
|
||||
```
|
||||
|
||||
### 4. Compatibility Gate & Reporting
|
||||
```
|
||||
Gate Policy:
|
||||
Build fail action: [ ] (block/warn)
|
||||
Test fail action: [ ] (block/warn)
|
||||
Coverage minimum: [ ] (%)
|
||||
|
||||
Reporting:
|
||||
Cadence: [ ] (monthly/quarterly)
|
||||
Known issues list: [ ] (Yes/No)
|
||||
Version exclusions: [ ] (Yes/No)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 의존성
|
||||
|
||||
- **Blocks:** 크로스 버전 CI/CD 게이트, 사용자 호환성 보장
|
||||
- **Related:** 모든 버전의 .NET/PostgreSQL/Node.js 생명주기 정책
|
||||
- **Prerequisite:** DevOps/QA/Architecture 팀 협력
|
||||
|
||||
---
|
||||
|
||||
**제출 기한:** 2026-08-21 (1주)
|
||||
**승인자:** PM Lead, Architecture, DevOps/QA
|
||||
**Escalation:** Engineering Director (정책 충돌 시)
|
||||
@@ -0,0 +1,191 @@
|
||||
# AEG-X-005: 조정(Reconciliation) 엔드포인트 권한 승인 요청
|
||||
|
||||
**WBS Item:** AEG-X-005
|
||||
**Status:** ⏳ IN_PROGRESS → DECISION_REQUIRED
|
||||
**Decision Owner:** Security Lead, Compliance
|
||||
**Blocks:** Portfolio Reconciliation endpoints production registration, G3 gate
|
||||
**Impact:** 4개 API 경로 미등록, RBAC 미정, 감사 추적 불완전
|
||||
|
||||
---
|
||||
|
||||
## 현재 상태
|
||||
|
||||
**문제:**
|
||||
- 4개 Reconciliation 경로: `GET /reconciliation`, `POST /reconciliation/submit`, `POST /reconciliation/correct`, `GET /reconciliation/{id}`
|
||||
- 현재: 모두 `AllowAnonymous()` (인증 없음)
|
||||
- 상태: `[DontRegister]` 마크됨 — 프로덕션 등록 안 됨
|
||||
- 권한: `Roles()` 또는 `Policies()` 정의 없음
|
||||
|
||||
**구현 완료:**
|
||||
- ✅ ReconciliationEngine, CostBasisCalculator (정책/로직)
|
||||
- ✅ ReconciliationEndpoints.cs (HTTP 라우팅, 계약)
|
||||
- ✅ 18/18 통합 테스트 (DB 필요)
|
||||
|
||||
**검증 필요:**
|
||||
- ⏳ 각 경로별 필요 역할 정의
|
||||
- ⏳ 정책 규칙 (PM/Checker/SRE 구분)
|
||||
- ⏳ 감사 추적 권한 연결
|
||||
- ⏳ GDPR/컴플라이언스 감시
|
||||
|
||||
---
|
||||
|
||||
## 필요한 4가지 결정
|
||||
|
||||
### 1️⃣ 조정 작업 권한 (Reconciliation Action Permission)
|
||||
|
||||
**결정:** 각 경로별 필요 권한 정의
|
||||
|
||||
```
|
||||
GET /reconciliation (조정 목록):
|
||||
✅ 필요 역할: [ ] (e.g., "reconciliation.read", "ops.read")
|
||||
✅ 대상 사용자: [ ] (PM/Checker/SRE/Admin)
|
||||
|
||||
POST /reconciliation/submit (위반 제출):
|
||||
✅ 필요 역할: [ ] (e.g., "reconciliation.submit")
|
||||
✅ 대상 사용자: [ ] (PM/Checker만? SRE?)
|
||||
|
||||
POST /reconciliation/correct (정정 제출):
|
||||
✅ 필요 역할: [ ] (e.g., "reconciliation.correct")
|
||||
✅ 대상 사용자: [ ] (Checker/SRE/Owner?)
|
||||
|
||||
GET /reconciliation/{id} (상세 조회):
|
||||
✅ 필요 역할: [ ] (동일 또는 별도?)
|
||||
✅ 소유권 제약: [ ] (본인/팀만? 또는 누구나?)
|
||||
```
|
||||
|
||||
### 2️⃣ 승인 워크플로우 통합 (Approval Workflow Integration)
|
||||
|
||||
**결정:** 대사 정정이 승인 워크플로우와 어떻게 연결되는가
|
||||
|
||||
```
|
||||
Current status:
|
||||
- ApprovalWorkflow (VS-26) exists
|
||||
- ReconciliationEngine (VS-29) exists
|
||||
- Integration: NOT DEFINED
|
||||
|
||||
Required decisions:
|
||||
✅ 정정 제출 → 자동 승인? 또는 Maker-Checker?
|
||||
✅ Checker는 누가? (역할/권한 정의)
|
||||
✅ 승인/거부 후 상태 전환?
|
||||
✅ 감시/알림 조건?
|
||||
|
||||
Linked Items:
|
||||
- ApprovalWorkflow.ApprovalPolicy
|
||||
- ReconciliationEngine.StateTransitions
|
||||
- GDPR 감시 규칙
|
||||
```
|
||||
|
||||
### 3️⃣ 감사 추적 권한 (Audit Trail Hookup)
|
||||
|
||||
**결정:** 조정 작업을 감사 추적에 기록
|
||||
|
||||
```
|
||||
Current state:
|
||||
- AuditTrailConsumer implemented (DEBT-029 discovered 2026-08-14)
|
||||
- Wired into OutboxPollerJob (line 99)
|
||||
- Events: APPROVAL_PROPOSED, APPROVAL_APPROVED, TRADE_SUBMITTED, etc.
|
||||
- ReconciliationCorrect event: NOT IN EVENT LIST
|
||||
|
||||
Required decisions:
|
||||
✅ ReconciliationCorrect → compliance.operation_audit_trail 기록?
|
||||
✅ 정정 내용(before/after) JSONB 저장?
|
||||
✅ 감사 주체: 누가? (X-KArtSell-User 헤더?)
|
||||
✅ 보존 정책: [ ] (years, GDPR 호환?)
|
||||
|
||||
Linked Items:
|
||||
- OutboxPollerJob (event polling)
|
||||
- AuditTrailConsumer (11 event types mapped)
|
||||
- GDPR retention (docs/CURRENT/AEG-X-007_SERILOG_CORRELATION.md)
|
||||
```
|
||||
|
||||
### 4️⃣ 컴플라이언스/감시 규칙 (Compliance Monitoring)
|
||||
|
||||
**결정:** 정정 금액의 편향성, 체계적 오류 감시
|
||||
|
||||
```
|
||||
Scenarios requiring rules:
|
||||
- 같은 종목 연속 정정 (일일 3회 초과?)
|
||||
- 일일 정정 금액 한계 (예: 계좌별 5천만원)
|
||||
- Checker와 PM이 다른 사람인가? (이해관계 충돌)
|
||||
- 정정 비율이 20% 초과? (이상 거래 의심)
|
||||
|
||||
Approval needed:
|
||||
✅ 감시 임계값: [ ] (건수, 금액, 비율)
|
||||
✅ 알림 채널: [ ] (email/Slack/SMS)
|
||||
✅ 에스컬레이션: [ ] (SRE/CFO/Compliance)
|
||||
✅ 자동 잠금: [ ] (정정 일시 중지 가능?)
|
||||
|
||||
Linked Items:
|
||||
- Serilog correlation (structured properties)
|
||||
- Alert rules (.gitea/workflows/ or Grafana)
|
||||
- Runbook (정정 비상 시나리오)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 제출 형식
|
||||
|
||||
**승인자는 다음 정보 제공:**
|
||||
|
||||
### 1. Reconciliation Endpoint Permissions
|
||||
```yaml
|
||||
GET /reconciliation:
|
||||
Roles: [ ]
|
||||
Users: [ ]
|
||||
|
||||
POST /reconciliation/submit:
|
||||
Roles: [ ]
|
||||
Users: [ ]
|
||||
|
||||
POST /reconciliation/correct:
|
||||
Roles: [ ]
|
||||
Users: [ ]
|
||||
|
||||
GET /reconciliation/{id}:
|
||||
Roles: [ ]
|
||||
Ownership: [ ]
|
||||
```
|
||||
|
||||
### 2. Approval Workflow Integration
|
||||
```
|
||||
Correct → Maker-Checker: [ ] (Yes/No)
|
||||
Checker Role: [ ]
|
||||
Auto-Approve Policy: [ ]
|
||||
Notification Channel: [ ]
|
||||
```
|
||||
|
||||
### 3. Audit Trail Specification
|
||||
```
|
||||
ReconciliationCorrect Event:
|
||||
Log to compliance.operation_audit_trail: [ ] (Yes/No)
|
||||
Payload includes before/after: [ ] (Yes/No)
|
||||
Retention: [ ] (years)
|
||||
GDPR compliant: [ ] (Yes/No)
|
||||
```
|
||||
|
||||
### 4. Compliance Monitoring Rules
|
||||
```
|
||||
Alert Threshold (daily):
|
||||
Max corrections: [ ] (count)
|
||||
Max amount: [ ] (KRW)
|
||||
Max ratio: [ ] (%)
|
||||
|
||||
Escalation:
|
||||
Channel: [ ] (Email/Slack/SMS)
|
||||
Owner: [ ]
|
||||
Auto-lock: [ ] (Yes/No)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 의존성
|
||||
|
||||
- **Blocks:** VS-29 production registration, G3 gate
|
||||
- **Related:** ApprovalWorkflow (VS-26), AuditTrail (VS-27), GDPR (DEBT-X)
|
||||
- **Prerequisite:** Security/Compliance team sign-off
|
||||
|
||||
---
|
||||
|
||||
**제출 기한:** 2026-08-21 (1주)
|
||||
**승인자:** Security Lead, Compliance Lead
|
||||
**Escalation:** Chief Compliance Officer
|
||||
@@ -0,0 +1,208 @@
|
||||
# AEG-X-008: OpenAPI 기준선 & 릴리스 서명 승인 요청
|
||||
|
||||
**WBS Item:** AEG-X-008
|
||||
**Status:** ⏳ IN_PROGRESS → DECISION_REQUIRED
|
||||
**Decision Owner:** API Architect, DevOps
|
||||
**Blocks:** FE OpenAPI 자동 생성, CI/CD 파이프라인 게이트, API 버전 관리
|
||||
**Impact:** API 계약 검증 미완료, 클라이언트 생성 불가, 변경 추적 불명확
|
||||
|
||||
---
|
||||
|
||||
## 현재 상태
|
||||
|
||||
**구현 완료:**
|
||||
- ✅ Host Release 빌드 (0 경고/오류)
|
||||
- ✅ Architecture tests 17/17 PASS
|
||||
- ✅ OpenAPI 게이트 로컬 검증: YAML/기준선/후보 검증 0 위반
|
||||
- ✅ FE 회귀 57 files/150 tests PASS
|
||||
|
||||
**아직 미결정:**
|
||||
- ⏳ 공식 기준선 승인 (baseline approval)
|
||||
- ⏳ Gitea Actions 실행 권한
|
||||
- ⏳ API Architect 릴리스 서명
|
||||
- ⏳ 변경 추적 정책
|
||||
|
||||
**알려진 이슈:**
|
||||
- 현재: >500 kB Vite 청크 경고 (AEG-X-002 최적화 후에도 지속)
|
||||
|
||||
---
|
||||
|
||||
## 필요한 4가지 결정
|
||||
|
||||
### 1️⃣ 공식 OpenAPI 기준선 (Baseline Snapshot)
|
||||
|
||||
**결정:** 프로덕션 릴리스 시 공식 기준선 정의
|
||||
|
||||
```
|
||||
Current state:
|
||||
- src/KArtSell.Host/artifacts/openapi/current_20260813_auto-off.json (기준)
|
||||
- Generated on: 2026-08-13 14:02 UTC
|
||||
- Total endpoints: [count required]
|
||||
- Security schemes: X-KArtSell-User header + Role-based
|
||||
|
||||
Approval needed:
|
||||
✅ 기준선 파일 지정: [ ] (git path)
|
||||
✅ 버전 정책: [ ] (semantic/date-based)
|
||||
✅ 승인 프로세스: [ ] (자동/수동)
|
||||
✅ 기준선 갱신 빈도: [ ] (per-release/quarterly)
|
||||
|
||||
Linked Items:
|
||||
- src/KArtSell.Host/artifacts/openapi/ (저장소)
|
||||
- .gitea/workflows/openapi-gate.yml (CI 검증)
|
||||
- docs/DECISIONS/ADR-API-BASELINE-001.md (현재 ADR)
|
||||
```
|
||||
|
||||
### 2️⃣ 호환성 정책 (Compatibility Enforcement)
|
||||
|
||||
**결정:** 기준선 vs 후보 비교 규칙
|
||||
|
||||
```
|
||||
Breaking changes that FAIL the gate:
|
||||
- Endpoint 제거 또는 경로 변경
|
||||
- 필수 파라미터 추가 (기존 클라이언트 호환 불가)
|
||||
- 응답 필드 제거 (기존 클라이언트 parsing 실패)
|
||||
- Status code 변경 (e.g., 200 → 400)
|
||||
|
||||
Non-breaking changes that PASS:
|
||||
- 선택적 파라미터/필드 추가
|
||||
- 새로운 status code 추가 (기존 클라이언트 무시 가능)
|
||||
- 기존 필드 추가 필터/정렬 옵션
|
||||
|
||||
Approval needed:
|
||||
✅ Breaking change 정의: [ ] (완전? 부분?)
|
||||
✅ Deprecation 정책: [ ] (90일 공지? 기간?)
|
||||
✅ 주요 버전 전략: [ ] (v1/v2 지원?)
|
||||
✅ 예외 프로세스: [ ] (CTO 승인 필요?)
|
||||
|
||||
Linked Items:
|
||||
- OpenAPI 3.1 deprecated keyword usage
|
||||
- Semantic versioning (major.minor.patch)
|
||||
- Client library generation (auto-off vs auto-on)
|
||||
```
|
||||
|
||||
### 3️⃣ Gitea Actions 실행 & 서명 (CI/CD Gate)
|
||||
|
||||
**결정:** 자동 검증과 수동 서명 책임
|
||||
|
||||
```
|
||||
Current CI/CD state:
|
||||
- .gitea/workflows/openapi-gate.yml exists
|
||||
- Runs on: push/PR (currently local only)
|
||||
- Validation: YAML structure, baseline diff, schema compliance
|
||||
- Status: No Gitea Actions configured server-side
|
||||
|
||||
Decisions needed:
|
||||
✅ Gitea Actions enabled: [ ] (Yes/No)
|
||||
✅ 실행 권한: [ ] (auto/manual)
|
||||
✅ 릴리스 서명자: [ ] (단일/복수?)
|
||||
✅ 서명 증명: [ ] (commit msg/tag/annotation?)
|
||||
|
||||
Approval needed:
|
||||
✅ API Architect: [ ] (name/email)
|
||||
✅ API Architect secondary: [ ] (name/email, fallback)
|
||||
✅ DevOps gate owner: [ ] (name/email)
|
||||
✅ Approval 보존 기한: [ ] (6개월/1년/영구)
|
||||
|
||||
Linked Items:
|
||||
- .gitea/workflows/openapi-gate.yml (current workflow)
|
||||
- src/KArtSell.Host/artifacts/openapi/ (baseline location)
|
||||
- API Architect approval log (where to record?)
|
||||
```
|
||||
|
||||
### 4️⃣ 클라이언트 생성 & 배포 (Client Generation)
|
||||
|
||||
**결정:** 공식 OpenAPI 기준선 기반 클라이언트 생성 여부
|
||||
|
||||
```
|
||||
Option A: Manual (current state)
|
||||
- Baseline: 수동 승인 → 배포
|
||||
- Client: 개발자 수동 생성 (openapi-generator, swagger-codegen)
|
||||
- 사용: 직접 임포트 또는 npm 게시
|
||||
|
||||
Option B: Automated
|
||||
- Baseline: CI gate auto-pass (호환성 규칙 충족)
|
||||
- Client: 자동 생성 (GitHub Actions / Gitea Actions)
|
||||
- 배포: NPM registry (npm publish) 또는 S3
|
||||
- 버전: OpenAPI 버전 태그 동기화
|
||||
|
||||
Option C: Hybrid
|
||||
- Pre-release: 수동 승인 (API Architect sign-off)
|
||||
- Patch: 자동 생성 (호환성 보장)
|
||||
- Release: 태그 자동 + NPM publish
|
||||
|
||||
Approval needed:
|
||||
✅ 정책 선택: [ ] (A/B/C)
|
||||
✅ 클라이언트 저장소: [ ] (npm/@kartsell/client? git-submodule?)
|
||||
✅ 배포 주기: [ ] (per-release/weekly)
|
||||
✅ 자동 테스트: [ ] (생성된 클라이언트 검증?)
|
||||
|
||||
Linked Items:
|
||||
- docs/CURRENT/V13-FE-009_ADR_OPENAPI_ZOD_STRATEGY.md (현재 전략)
|
||||
- openapi-generator / swagger-codegen (도구)
|
||||
- npm registry vs internal repository
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 제출 형식
|
||||
|
||||
**승인자는 다음 정보 제공:**
|
||||
|
||||
### 1. Baseline Approval
|
||||
```
|
||||
Official Baseline:
|
||||
File: [ ] (git path)
|
||||
Version: [ ] (vX.Y.Z or YYYY-MM-DD)
|
||||
|
||||
Update Policy:
|
||||
Frequency: [ ] (per-release/quarterly/on-demand)
|
||||
Approval Process: [ ] (auto/manual)
|
||||
Sign-off Required: [ ] (Yes/No)
|
||||
```
|
||||
|
||||
### 2. Compatibility Rules
|
||||
```
|
||||
Breaking Changes:
|
||||
Defined: [ ] (comprehensive list)
|
||||
Deprecation Period: [ ] (days)
|
||||
|
||||
Non-Breaking:
|
||||
Auto-approved: [ ] (Yes/No)
|
||||
Client Notification: [ ] (Yes/No)
|
||||
```
|
||||
|
||||
### 3. Gitea Actions & Signing
|
||||
```
|
||||
CI Execution:
|
||||
Enabled: [ ] (Yes/No)
|
||||
Trigger: [ ] (push/PR/manual)
|
||||
|
||||
API Architect:
|
||||
Primary: [ ] (name)
|
||||
Secondary: [ ] (name)
|
||||
Approval Record: [ ] (location)
|
||||
```
|
||||
|
||||
### 4. Client Generation Strategy
|
||||
```
|
||||
Option: [ ] (A-Manual / B-Automated / C-Hybrid)
|
||||
|
||||
Deployment:
|
||||
Repository: [ ] (npm/@kartsell/client / git-submodule)
|
||||
Frequency: [ ] (per-release/weekly)
|
||||
Validation: [ ] (Yes/No)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 의존성
|
||||
|
||||
- **Blocks:** FE OpenAPI 클라이언트 생성, CI/CD 완전 자동화
|
||||
- **Related:** AEG-X-002 (번들 최적화), 빌드 파이프라인, 버전 관리
|
||||
- **Prerequisite:** API Architect, DevOps 팀 협력
|
||||
|
||||
---
|
||||
|
||||
**제출 기한:** 2026-08-21 (1주)
|
||||
**승인자:** API Architect, DevOps Lead
|
||||
**Escalation:** Engineering Director (정책 논쟁 시)
|
||||
@@ -0,0 +1,142 @@
|
||||
# AEG-X-038: 수수료/세금/FX 유효시간 일정 승인 요청
|
||||
|
||||
**WBS Item:** AEG-X-038
|
||||
**Status:** ⏳ DECISION_REQUIRED → APPROVAL PENDING
|
||||
**Decision Owner:** Ops/Tax/Compliance/Owner
|
||||
**Blocks:** MaintainFeeTaxFxSchedule Slice (VS-06-01), Cost Basis Calculation, Portfolio Rebalancing
|
||||
**Impact:** 금융 기능 완성 불가능, 정정 메커니즘 미정
|
||||
|
||||
---
|
||||
|
||||
## 필요한 5가지 결정
|
||||
|
||||
### 1️⃣ 소스 권한 (Source Authority)
|
||||
|
||||
**결정:** 각 일정 유형별 승인된 데이터 소스 지정
|
||||
|
||||
| 일정 유형 | 현재 상태 | 승인 필요 | 비고 |
|
||||
|---------|---------|---------|------|
|
||||
| **수수료 (Fee)** | 미정 | ✅ 필요 | Commission 스키마에 ledger_id 추가됨, 소스 미정 |
|
||||
| **세금 (Tax)** | 미정 | ✅ 필요 | 세율 테이블 미정, 업데이트 주기 미정 |
|
||||
| **환율 (FX)** | 미정 | ✅ 필요 | 공식 환율 제공사 미정 |
|
||||
|
||||
### 2️⃣ 시간 의미 (Temporal Semantics)
|
||||
|
||||
**결정:** Effective 날짜와 Published 날짜의 의미 명확화
|
||||
|
||||
```
|
||||
effective_at: 일정이 실제로 적용되는 시점
|
||||
예: "2026-08-15부터의 수수료 변경"
|
||||
|
||||
published_at: 변경이 공포/승인되는 시점
|
||||
예: "2026-08-14에 변경 사항 공포됨"
|
||||
|
||||
Question:
|
||||
- effective_at <= published_at인가? (사후 고시)
|
||||
- 동시 가능한가? (사전 고시)
|
||||
- 과거 적용 가능한가? (소급 적용)
|
||||
```
|
||||
|
||||
### 3️⃣ 우선순위 및 범위 (Precedence & Scope)
|
||||
|
||||
**결정:** 계좌 → 거래소 → 종목 → 관할권 계층 승인
|
||||
|
||||
```
|
||||
Precedence Order (highest to lowest):
|
||||
1. 계좌별 (account_id) — 특정 계좌 특별 수수료
|
||||
2. 거래소별 (exchange_id) — 거래소 기본 수수료
|
||||
3. 종목별 (instrument_id) — 종목 기본 수수료
|
||||
4. 관할권별 (jurisdiction) — 국가/지역 기본값
|
||||
|
||||
Question:
|
||||
- 계층별 Override 허용?
|
||||
- 동시 적용 시 합산? 선택?
|
||||
```
|
||||
|
||||
### 4️⃣ FX 범위 (FX Scope Boundary)
|
||||
|
||||
**결정:** 환율 적용 경계 명확화
|
||||
|
||||
```
|
||||
Current uncertainty:
|
||||
- 거래 통화 쌍 환율만? (e.g., KRW→USD)
|
||||
- 중간 환율 (mid-rate) 사용?
|
||||
- Bid/Ask 스프레드 포함?
|
||||
- 수표/이체별 구분?
|
||||
|
||||
Approval needed:
|
||||
- FX 데이터 공식 소스
|
||||
- 환율 결정 시각 (execution time vs quote time)
|
||||
- 소수 자릿수 정확도
|
||||
```
|
||||
|
||||
### 5️⃣ 운영 제어 (Operational Control)
|
||||
|
||||
**결정:** Job 4C (Maintain Fee/Tax/FX) 실행 정책
|
||||
|
||||
```
|
||||
Questions:
|
||||
- Job 4C 실행 주기? (daily/hourly/on-demand)
|
||||
- 변경 검토 프로세스? (자동 vs 승인 필수)
|
||||
- Rollback 절차? (변경 취소 가능?)
|
||||
- 긴급 대응 프로토콜? (시스템 장애 시)
|
||||
|
||||
Linked Items:
|
||||
- J04C Job 실행 일정
|
||||
- DQ (Data Quality) 검증 규칙
|
||||
- Rollback 및 재처리 프로세스
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 제출 형식
|
||||
|
||||
**승인자는 다음 정보 제공:**
|
||||
|
||||
1. **소스 권한**
|
||||
```
|
||||
✅ 수수료 소스: [지정]
|
||||
✅ 세율 소스: [지정]
|
||||
✅ 환율 소스: [지정]
|
||||
```
|
||||
|
||||
2. **시간 의미**
|
||||
```
|
||||
✅ effective_at의 정의: [명확화]
|
||||
✅ published_at의 정의: [명확화]
|
||||
✅ 과거 적용 허용: [Yes/No]
|
||||
```
|
||||
|
||||
3. **우선순위**
|
||||
```
|
||||
✅ 계층별 Override 규칙: [문서 링크]
|
||||
✅ 동시 적용 정책: [합산/선택]
|
||||
```
|
||||
|
||||
4. **FX 범위**
|
||||
```
|
||||
✅ 환율 데이터 공식 제공사: [지정]
|
||||
✅ 환율 결정 시각: [execution/quote]
|
||||
✅ 정확도: [소수 자릿수]
|
||||
```
|
||||
|
||||
5. **운영 제어**
|
||||
```
|
||||
✅ Job 4C 주기: [frequency]
|
||||
✅ 변경 검토: [자동/승인]
|
||||
✅ Rollback 절차: [문서 링크]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 의존성
|
||||
|
||||
- **Blocks:** VS-06-01 (MaintainFeeTaxFxSchedule 구현)
|
||||
- **Related:** DEBT-X-COST (Cost Basis), Portfolio Reconciliation, Rebalancing
|
||||
- **Timeline:** 승인 후 2주 이내 구현 가능
|
||||
|
||||
---
|
||||
|
||||
**제출 기한:** 2026-08-21 (1주)
|
||||
**승인자:** Ops Lead, Tax Compliance, Owner
|
||||
**Escalation:** Chief Financial Officer (필요시)
|
||||
@@ -0,0 +1,7 @@
|
||||
Debt_ID,File,Count,Category,Owner,Reason,Introduced,Target,Decision,Status
|
||||
KBX-TD-001,frontend/src/features/home/pages/HomePage.vue,2,local-layout,FE/Home,Existing status-card colors need semantic token review,pre-governance,TBD,keep-local-or-normalize,OPEN
|
||||
KBX-TD-002,frontend/src/features/models/pages/ModelDetail.vue,36,policy-and-reusable,FE/ModelOperations,Existing model status and detail colors are mixed raw literals,pre-governance,TBD,normalize-after-token-owner-approval,OPEN
|
||||
KBX-TD-003,frontend/src/features/models/pages/ModelsList.vue,3,local-layout,FE/ModelOperations,Existing list surface and action colors require semantic mapping,pre-governance,TBD,normalize-after-token-owner-approval,OPEN
|
||||
KBX-TD-004,frontend/src/features/shadow-run/pages/ShadowRunDetail.vue,14,policy-and-reusable,FE/ModelOperations,Existing shadow-run state colors require semantic mapping,pre-governance,TBD,normalize-after-token-owner-approval,OPEN
|
||||
KBX-TD-005,frontend/src/features/shadow-run/pages/ShadowRunList.vue,5,local-layout,FE/ModelOperations,Existing list and loading colors require semantic mapping,pre-governance,TBD,normalize-after-token-owner-approval,OPEN
|
||||
KBX-TD-006,frontend/src/features/wbs/pages/WbsWorkspacePage.vue,2,local-layout,FE/Governance,Existing WBS workspace warning colors require semantic mapping,pre-governance,TBD,keep-local-or-normalize,OPEN
|
||||
|
@@ -49,7 +49,7 @@ PHASE-1-SHADOW-RUN,S0-S5,Cross,252+ Trading Day Shadow Run,BLOCKED,TBD,"docs/CUR
|
||||
V13-FE-001,S0,Cross,UI Vendor import boundary,COMPLETED,2026-08-09,"docs/CURRENT/V13-FE-001_KBX_V36_DESIGN_HARNESS_PROPOSAL.md; tools/validate_v16.py; frontend/src/shared/ui/adapter/tests/vendorBoundary.spec.ts",FE Architect/QA,"Dependency AEG-X-003 is COMPLETED. KBX v36 was translated as a non-vendor design-evidence harness: preserve the shared UI adapter boundary, keep feature direct PrimeVue/AG Grid imports at zero, and defer token/recipe implementation to separately approved slices. Actual evidence: python tools/validate_v16.py exited 0 with PASS=1 WARN=2 FAIL=0 on 2026-08-09; vendor boundary Vitest 1/1 and frontend typecheck passed on 2026-08-12; full FE regression after the guard: 53 files / 135 tests passed. Warnings are retained (no full source archive; approved runtime evidence absent); no runtime test/build/migration claim is made."
|
||||
V13-FE-003,S0,Cross,UiAdapter Port 정의,COMPLETED,2026-08-09,"docs/CURRENT/V13-FE-003_UI_ADAPTER_PORT_RECONCILIATION.md; frontend/src/shared/ui/adapter/contracts.ts; frontend/src/shared/ui/adapter/tests/uiAdapter.contract.spec.ts",FE Architect/QA,"Dependency V13-FE-001 is COMPLETED. Existing adapter v4 contract explicitly verifies 14 capabilities (stronger than the WBS minimum wording of 8) without feature vendor imports. Actual targeted Vitest evidence: 2 files / 4 tests passed, exit 0, 2026-08-09. KBX-derived components remain provider-neutral reimplementations only; no KBX package, contract, router, store, or permission host was imported."
|
||||
V13-FE-004,S0,Cross,PrimeVue/AG Grid Adapter 구현,COMPLETED,2026-08-09,"docs/CURRENT/V13-FE-004_ADAPTER_IMPLEMENTATION_RECONCILIATION.md; frontend/src/shared/ui/adapter/primevue; frontend/src/shared/ui/adapter/tests/uiAdapter.contract.spec.ts",FE Architect/QA,"Dependency V13-FE-003 is COMPLETED. PrimeVue/AG Grid remain confined behind adapter v4. Actual targeted Vitest evidence: 2 files / 4 tests passed, exit 0, 2026-08-09. This is contract/accessibility-attribute evidence only; no visual/AT/runtime claim is made."
|
||||
V13-FE-005,S0,Cross,Ks* vendor-neutral components,IN_PROGRESS, TBD,"docs/CURRENT/V13-FE-005_KBX_FORM_COMPONENT_ADOPTION.md; docs/CURRENT/V13-FE-005_MODELS_LIST_VENDOR_BOUNDARY_SLICE_NOTE.md; docs/CURRENT/V13-FE-005_SHADOW_RUN_VENDOR_BOUNDARY_SLICE_NOTE.md; docs/CURRENT/V13-FE-005_COMPONENT_TEMPLATE_TEST_HARDENING_SLICE_NOTE.md; frontend/src/shared/ui/components/KsFormGrid.vue; frontend/src/shared/ui/components/KsFormSection.vue; frontend/src/shared/ui/components/KsFormSpan.vue; frontend/src/shared/ui/components/KsValidationSummary.vue; frontend/src/shared/ui/components/tests/KsCoreControls.contract.spec.ts; frontend/src/features/models/pages/ModelsList.vue; frontend/src/features/shadow-run/pages/ShadowRunList.vue; evidence/V13-FE-005/component-template-tests_20260813.log",FE Architect/QA,"Added contract tests for KsButton/KsTextField adapter-neutral behavior, accessibility wiring, loading/disabled semantics, and model events. Actual evidence: targeted 1 file/3 tests PASS, full frontend regression 59 files/156 tests PASS, typecheck PASS, build PASS. Known >500 kB build warning remains; visual/AT/browser/performance evidence remain outstanding. No completion claim."
|
||||
V13-FE-005,S0,Cross,Ks* vendor-neutral components,IN_PROGRESS,TBD,"docs/CURRENT/V13-FE-005_KBX_UI_BOUNDARY_GOVERNANCE_SLICE_NOTE.md; docs/CURRENT/KBX_UI_BOUNDARY_GOVERNANCE.md; docs/CURRENT/CATALOGS/KBX_TOKEN_DEBT_REGISTER.csv; scripts/validate-ui-boundary.mjs; scripts/validate-kbx-component-manifest.mjs; scripts/validate-kbx-screen-recipes.mjs; scripts/validate-kbx-ai-components.mjs; frontend/src/shared/ui/component-manifest.json; frontend/src/shared/ui/screen-types/screen-recipes.json; frontend/src/shared/ui/adapter/tests/uiBoundaryGate.spec.ts; frontend/src/shared/ui/adapter/tests/componentManifest.spec.ts; frontend/src/shared/ui/adapter/tests/aiComponentGate.spec.ts; frontend/src/shared/ui/screen-types/tests/screenRecipeGovernance.spec.ts; evidence/V13-FE-005/full-frontend-regression-recipe-final_20260813.log; evidence/V13-FE-005/ui-boundary-final_20260813.log; evidence/V13-FE-005/validate-v16-final_20260813.log; evidence/V13-FE-005/component-manifest_20260813.log; evidence/V13-FE-005/component-manifest-tests_20260813.log; evidence/V13-FE-005/typecheck-component-manifest_20260813.log; evidence/V13-FE-005/screen-recipes-final_20260813.log; evidence/V13-FE-005/screen-recipe-tests-final_20260813.log; evidence/V13-FE-005/typecheck-screen-recipes-final_20260813.log; evidence/V13-FE-005/ai-component-gate-final_20260813.log; evidence/V13-FE-005/ai-component-gate-tests-final2_20260813.log; evidence/V13-FE-005/typecheck-ai-gate-final_20260813.log",FE Architect/QA,"Actual evidence: full FE regression after Recipe change 68 files/176 tests PASS; ui-boundary gate 37 files/0 failures/6 classified raw-color warnings; validate_v16 PASS=1 WARN=2 FAIL=0; Golden Component manifest validation 0 failures; Screen Recipe validation 0 failures and governance test PASS; AI component gate scanned 17 feature files/23 real exports with 0 failures, and rejected unknown KbxMagicSearch mutation fixture; typecheck PASS. Raw colors remain registered debt, not mechanically tokenized. Runtime/provider behavior unchanged. AI prop-level validation, exception lifecycle, browser/visual/AT/performance evidence remain outstanding."
|
||||
V13-FE-006,S0,Cross,AppShell/Page layouts,IN_PROGRESS,TBD,"docs/CURRENT/V13-FE-006_LAYOUT_CONTRACT_RECONCILIATION.md; docs/CURRENT/V13-FE-006_NAVIGATION_CONTRACT_HARDENING_SLICE_NOTE.md; docs/CURRENT/V13-FE-006_NAVIGATION_PREFERENCE_SLICE_NOTE.md; frontend/src/shared/shell/KsSideNavigation.vue; frontend/src/shared/shell/KsAppShell.vue; frontend/src/shared/shell/navigationCatalog.ts; frontend/src/shared/shell/screenPreferenceStore.ts; frontend/src/shared/shell/tests/KsSideNavigation.contract.spec.ts; frontend/src/shared/shell/tests/navigationCatalog.spec.ts; frontend/src/shared/ui/layouts/tests/layout.contract.spec.ts; evidence/V13-FE-006/navigation-contract_20260813.log; evidence/V13-FE-006/navigation-preference_20260813.log; evidence/V13-FE-006/navigation-browser-contract_20260813.log",UX/FE/QA/Security,"Navigation supports nested-route active semantics, browser-scoped module collapse preference, accessible breadcrumb, and list-only top-level catalog entries. Parameterized detail routes are excluded from navigation while remaining routable. Actual evidence: navigation catalog 1 file/4 tests PASS, typecheck PASS, build PASS, Playwright browser snapshot captured. Known >500 kB warning and an initial console error remain; auth integration, mobile, visual/AT and production evidence remain outstanding. No completion claim."
|
||||
V13-FE-011,S6,Cross,T01 검색목록 화면 템플릿,IN_PROGRESS,TBD,"docs/CURRENT/V13-FE-011_T01_SEARCH_LIST_LAYOUT_SLICE_NOTE.md; frontend/src/shared/ui/screen-types/v2/SearchListCrudPage.vue; frontend/src/shared/ui/screen-types/tests/SearchListCrudPage.spec.ts; frontend/src/shared/shell/tests/navigationCatalog.spec.ts; evidence/V13-FE-011/t01-search-list-layout_20260809.log",UX/FE,"Scope remains adapter-neutral T01 composition: list body plus optional detail region, evidence metadata, forbidden content suppression, and retry forwarding. Actual targeted evidence: 1 file / 4 tests passed; pnpm typecheck passed. Dependency V13-FE-006 is completed. MVP-A Gate passage, visual/assistive-technology approval, and Playwright evidence are not claimed."
|
||||
V13-FE-012,S8,Cross,T02 상세조회 화면 템플릿,IN_PROGRESS,TBD,"docs/CURRENT/V13-FE-012_T02_DETAIL_READ_SLICE_NOTE.md; frontend/src/shared/ui/screen-types/v2/DetailReadPage.vue; frontend/src/shared/ui/screen-types/tests/DetailReadPage.spec.ts",UX/FE/QA/Domain Owner,"Dependency V13-FE-006 is COMPLETED. As-of/version metadata, evidence slot, forbidden suppression, and retry forwarding are characterized. Actual evidence: 1 file / 2 tests and typecheck passed. Production API wiring, visual/AT, browser E2E, and approval evidence remain outstanding."
|
||||
|
||||
|
@@ -0,0 +1,137 @@
|
||||
# KBX UI Boundary Governance v1
|
||||
|
||||
## 목적과 범위
|
||||
|
||||
이 문서는 화면 수가 수백 개로 증가하고 개발자·외부 UI 공급자·AI 코딩이 교체되어도 KBX UI 계약이 유지되도록 하는 FE 컴포넌트와 화면 템플릿의 기준 문서다.
|
||||
|
||||
- **WBS / Requirement / UI / Test:** `V13-FE-005` / `REQ-FE-COMP` / `UI-FOUND-05` / `T-FE-COMP-01`
|
||||
- **Source:** 기존 vendor-neutral `Ks*` 컴포넌트, `frontend/src/shared/ui/` 경계, Screen Recipe/Component Manifest, `V13-FE-003`, `V13-FE-005`, `V13-FE-038` 기록
|
||||
- **Assumption:** 현재 PrimeVue/AG Grid 직접 사용은 shared UI 소유 영역에 한정하고, 업무 모듈은 KBX 계약만 소비한다.
|
||||
- **Unknown:** 모든 기존 화면의 tier·token debt·예외 registry 완전성은 별도 inventory가 필요하다.
|
||||
- **Decision Required:** 실제 CI gate의 차단 수준, 예외 만료 시 error 전환 시점, Golden/Performance 승인 수치는 FE/UX/QA가 별도 승인한다.
|
||||
|
||||
## 핵심 결정
|
||||
|
||||
기존의 “Adapter를 사용할 것인가”라는 질문을 폐기하고 **KBX UI Boundary Policy**를 기준으로 판단한다. Adapter는 구현 수단 중 하나이며 목표가 아니다.
|
||||
|
||||
Vertical Slice는 업무 의미와 서버 계약을 소유하고, KBX는 화면 UX·상태·키보드·접근성·공급자 경계를 소유한다. PrimeVue와 AG Grid는 KBX Boundary 내부의 교체 가능한 공급자다.
|
||||
|
||||
```text
|
||||
Vertical Slice (업무 의미)
|
||||
↓
|
||||
Screen Contract / Recipe
|
||||
↓
|
||||
KBX UI Boundary
|
||||
Native | PrimeVue | AG Grid
|
||||
```
|
||||
|
||||
## Component Classification
|
||||
|
||||
모든 신규·변경 컴포넌트는 Component Manifest에 다음 tier를 기록한다.
|
||||
|
||||
| Tier | 이름 | 기준 | 예시 |
|
||||
| --- | --- | --- | --- |
|
||||
| L0 | Native Primitive | HTML semantics로 충분하고 popup/복합 keyboard 계약이 없음 | `KbxInput`, 단순 label/layout |
|
||||
| L1 | Thin Technology Wrapper | KBX가 허용한 최소 props만 노출하고 공급자 API를 숨김 | `KbxButton`, `KbxDialog`, `KbxDrawer` |
|
||||
| L2 | Controlled Component | focus, keyboard, overlay, ARIA, theme, density, state를 KBX가 통제 | Lookup 기반이 아닌 Date/Select/Tabs/Tooltip |
|
||||
| L3 | Business Component | 반복되는 업무 문법과 상호작용 계약을 소유 | `KbxLookup`, `KbxSearchPanel`, `KbxCommandBar`, `KbxStatus` |
|
||||
| L4 | Strong Facade | 외부 기능을 축소하는 것이 아니라 policy·normalizer·interaction contract로 고정 | `KbxDataGrid`, Excel import, barcode, bulk selection |
|
||||
|
||||
같은 이름의 컴포넌트라도 업무 규칙을 내부에 넣지 않는다. Grid interaction policy는 KBX, 주문·재고·신용한도 가능 여부는 해당 Domain이 소유한다.
|
||||
|
||||
## API와 경계 규칙
|
||||
|
||||
- `frontend/src/modules/**`는 PrimeVue/AG Grid를 직접 import하지 않는다.
|
||||
- 업무 화면은 `.p-*`, `.ag-*`, 공급자 전용 `:deep()`, `!important`, raw color를 사용하지 않는다.
|
||||
- KBX wrapper는 explicit props만 허용한다. 무제한 `$attrs` passthrough을 금지한다.
|
||||
- `KbxDataGrid`는 `gridOptions`, `defaultColDef`, `rawGridApi` 같은 raw escape hatch를 노출하지 않는다. 의미 있는 `rowStatePolicy`, `clipboardPolicy`, `selectionPolicy`만 승인한다.
|
||||
- 외부 공급자 차이는 Component가 아니라 Provider/Strategy로 분리한다. 데이터 공급 변화는 Provider, 행동 정책 변화는 Policy/Strategy, 업무 실행은 Command가 소유한다.
|
||||
- Native HTML이 충분한 L0 영역에 공급자 wrapper를 추가하지 않는다.
|
||||
- `Current UI state`와 `Server state`를 복제하지 않는다. TanStack Query는 server state, Pinia는 application/UI state의 소유자다.
|
||||
- FE validation은 feedback이며 Truth는 Zod 계약·FastEndpoint·Application·Domain·DB에 있다.
|
||||
|
||||
## Template와 Screen Recipe
|
||||
|
||||
화면은 `ScreenId`, `ScreenType`, `templateCode`, `ScreenVersion`, `Component Manifest`를 명시한다. Template은 low-code 화면 정의가 아니라 검증 가능한 UX 골격이다.
|
||||
|
||||
- T01~T09 등 표준 Template은 loading/empty/partial/stale/warn/error/401/403/409/expired/readonly 상태와 권한·접근성·keyboard 계약을 소유한다.
|
||||
- Screen Recipe는 사용 컴포넌트, command, 검색 필드, grid column, recovery policy, permission policy를 선언한다.
|
||||
- 70%는 표준 Template/Schema, 20%는 승인된 Template Extension, 10%는 명시적 Local implementation을 목표로 한다. JSON으로 조건부 업무 로직을 만들지 않는다.
|
||||
- 개발자는 업무 상태·예외·Command를 결정한다. Button 위치·grid defaults·color·keyboard·Lookup·Excel flow·상태 의미를 임의로 결정하지 않는다.
|
||||
- Read 화면은 서버가 제공하는 UX 최적화 Projection을 사용하며 여러 업무 API를 FE에서 조합해 Source of Truth를 만들지 않는다.
|
||||
|
||||
## Token과 Design Debt
|
||||
|
||||
Theme은 Adapter가 아니라 KBX Semantic Token이 소유한다.
|
||||
|
||||
```text
|
||||
Foundation → Semantic → State → Density → Component → Layout
|
||||
```
|
||||
|
||||
Token 승격은 두 컴포넌트 이상에서 의미가 같거나 Design System 정책값일 때만 허용한다. 화면 한 곳의 layout literal을 무조건 token으로 만들지 않는다.
|
||||
|
||||
PX/색상 debt는 `policy`, `reusable`, `local-layout`, `external-compatibility`로 분류하고 파일·owner·reason·introducedVersion·targetVersion·decision(`normalize|keep-local|remove`)을 기록한다. debt count를 0으로 만들기 위한 magic token 생성을 금지한다.
|
||||
|
||||
## Exception Registry
|
||||
|
||||
Boundary 예외는 주석이나 TODO가 아니라 registry 데이터다. 최소 필드는 다음과 같다.
|
||||
|
||||
```json
|
||||
{
|
||||
"id": "KBX-EX-0001",
|
||||
"screenId": "OMS-ORD-001",
|
||||
"type": "direct-ui|css|raw-api|local-template",
|
||||
"reason": "승인된 외부 장치 수명주기",
|
||||
"owner": "WMS",
|
||||
"introducedVersion": "1.0.0",
|
||||
"reviewAt": "2026-Q4",
|
||||
"removalTarget": "TBD",
|
||||
"status": "active"
|
||||
}
|
||||
```
|
||||
|
||||
만료된 `reviewAt`, owner 없는 예외, removal target 없는 장기 예외는 CI warning/error 정책에 따라 Gate를 막는다. 예외는 승인된 변경으로만 추가·갱신한다.
|
||||
|
||||
## AI Coding Governance
|
||||
|
||||
AI 생성은 Screen Recipe, Component Manifest, Field Dictionary, Test Contract를 입력으로 받는다. AI가 자유롭게 새 UI 정책을 만들도록 허용하지 않는다.
|
||||
|
||||
- Manifest에 없는 컴포넌트·props·template은 실패한다.
|
||||
- PrimeVue/AG Grid 직접 import, raw supplier props, CSS leakage는 실패한다.
|
||||
- AI는 composition, type, query hook, API binding, contract test를 작성할 수 있다.
|
||||
- AI는 button placement, grid defaults, color, keyboard, Lookup pattern, Excel flow, state semantics를 결정할 수 없다.
|
||||
- 생성 코드는 `SCAFFOLD_ONLY` 또는 승인된 구현으로 구분하며, scaffold를 구현 완료로 간주하지 않는다.
|
||||
|
||||
## Required Quality Gates
|
||||
|
||||
`pnpm validate:kbx`는 다음 검증을 하나의 governance pipeline으로 연결해야 한다.
|
||||
|
||||
1. `validate-ui-boundary` — 공급자 직접 import와 dependency 방향
|
||||
2. `validate-css-boundary` — `.p-*`, `.ag-*`, `:deep`, `!important`, raw color
|
||||
3. `validate-component-api` — explicit props와 raw API leakage
|
||||
4. `validate-token-usage` — token 분류와 debt registry
|
||||
5. `validate-kbx-exceptions` — owner/review/removal lifecycle
|
||||
6. `validate-ai-generated-components` — Manifest/Recipe/props 존재성
|
||||
7. `validate-theme-matrix` — Light/Dark × Compact/Comfortable + Touch
|
||||
8. `validate-component-dependencies` — tier별 허용 의존성
|
||||
|
||||
Gate PASS는 정적 계약, reference harness, component test, real browser, Golden E2E, production smoke로 증거 등급을 구분한다. 실행하지 않은 등급은 PASS로 기록하지 않는다.
|
||||
|
||||
## Golden과 운영 기준
|
||||
|
||||
우선 Golden Component는 `KbxButton`, `KbxInput`, `KbxLookup`, `KbxDataGrid`, `KbxDialog`, `KbxStatus`다. 최소한 contract, accessibility, keyboard/focus, state, theme/density 증거를 갖는다.
|
||||
|
||||
`KbxDataGrid`는 별도 제품 roadmap으로 selection, clipboard, editing, validation, personalization, large data, server-side selection, Excel, keyboard, accessibility, performance를 계약화한다. AG Grid 업그레이드는 dependency bump가 아니라 Compatibility Release로 취급한다.
|
||||
|
||||
대량 선택은 `mode=filter`, query/filter token, `excludedIds`를 서버에 전달하며 대량 ID를 브라우저에 보관하지 않는다. Excel은 staging/job, 장시간 작업은 승인된 job/progress 계약을 사용한다.
|
||||
|
||||
## 적용 순서
|
||||
|
||||
1. Boundary/CSS/API leakage Gate를 고정한다.
|
||||
2. 기존 token debt와 exception을 분류한다.
|
||||
3. Component Manifest에 L0~L4 tier를 추가한다.
|
||||
4. 여섯 Golden Component의 contract와 theme/density/keyboard evidence를 완성한다.
|
||||
5. Template/Screen Recipe를 AI grounding과 CI validation에 연결한다.
|
||||
6. 예외 lifecycle과 업그레이드 Compatibility Release 절차를 운영한다.
|
||||
|
||||
이번 문서는 정책 방향을 재설정하며, 기존 컴포넌트 런타임·공급자 선택·자동 활성화·실주문 경로를 변경하지 않는다.
|
||||
@@ -0,0 +1,47 @@
|
||||
# V13-FE-005 — KBX UI Boundary Governance 재조정
|
||||
|
||||
- **WBS:** V13-FE-005
|
||||
- **Requirement/API/UI/Test:** REQ-FE-COMP / Cross / UI-FOUND-05 / T-FE-COMP-01
|
||||
- **Scope:** FE 컴포넌트와 Template의 정책을 Adapter 중심에서 KBX UI Boundary Governance 및 L0~L4 분류 중심으로 재정렬
|
||||
- **Source:** 기존 Ks* vendor-neutral component contract, Screen Recipe/Component Manifest, V13-FE-003·005·038 기록, 사용자 제공 v50 운영 평가
|
||||
- **Assumption:** 이번 Slice는 정책·문서 방향 변경이며 component runtime/provider implementation은 변경하지 않음
|
||||
- **Unknown:** 기존 전체 component의 tier, token debt, exception registry 완전 inventory
|
||||
- **Decision Required:** CI 차단 수준, 예외 만료 error 전환, Golden/Performance 승인 수치
|
||||
- **Artifact:** `docs/CURRENT/KBX_UI_BOUNDARY_GOVERNANCE.md`
|
||||
- **Acceptance evidence:** 정책 문서에 Boundary, L0~L4, Template/Recipe, Token/Debt, Exception, AI Gate, Quality Gate, Golden/Performance 운영 기준이 명시됨
|
||||
- **Status:** IN_PROGRESS — boundary, manifest, recipe, AI, exception, browser, build evidence 확보; visual/accessibility/performance approval remains outstanding
|
||||
|
||||
## Actual verification evidence
|
||||
|
||||
- `python tools/validate_v16.py`: `PASS=1`, `WARN=2`, `FAIL=0` — `evidence/V13-FE-005/ui-boundary-baseline_20260813.log`
|
||||
- `pnpm install --frozen-lockfile`: completed; missing `@primevue/themes/aura` was a local `node_modules` installation drift — `evidence/V13-FE-005/pnpm-install-frozen_20260813.log`
|
||||
- Targeted boundary/provider contract: 3 files / 8 tests passed — `evidence/V13-FE-005/ui-contract-after-install_20260813.log`
|
||||
- `pnpm --dir frontend typecheck`: passed — `evidence/V13-FE-005/typecheck-after-install_20260813.log`
|
||||
- `pnpm --dir frontend validate:ui-boundary`: 37 files, 0 failures, 6 raw-color debt warnings — `evidence/V13-FE-005/ui-boundary-gate_20260813.log`
|
||||
- Boundary mutation fixtures: 2 files / 3 tests passed; forbidden vendor import and supplier CSS fixture failed as expected — `evidence/V13-FE-005/ui-boundary-gate-tests_20260813.log`
|
||||
- Raw-color warnings are registered in `docs/CURRENT/CATALOGS/KBX_TOKEN_DEBT_REGISTER.csv`; no mechanical tokenization was performed.
|
||||
- Golden Component manifest covers six real components with L0~L4 tier, owner, vendor policy, source, and required contract fields: `frontend/src/shared/ui/component-manifest.json`.
|
||||
- `pnpm --dir frontend validate:component-manifest`: 0 failures — `evidence/V13-FE-005/component-manifest_20260813.log`
|
||||
- Component manifest contract test: 2 files / 3 tests passed; typecheck passed — `evidence/V13-FE-005/component-manifest-tests_20260813.log`, `evidence/V13-FE-005/typecheck-component-manifest_20260813.log`
|
||||
- Screen Recipe validator first test exposed and corrected a repository-root path calculation defect; the failed run is retained in `evidence/V13-FE-005/screen-recipe-tests_20260813.log` and is not counted as PASS.
|
||||
- `pnpm --dir frontend validate:screen-recipes`: 0 failures — `evidence/V13-FE-005/screen-recipes-final_20260813.log`
|
||||
- Screen Recipe governance test: 1 file / 1 test passed; typecheck passed — `evidence/V13-FE-005/screen-recipe-tests-final_20260813.log`, `evidence/V13-FE-005/typecheck-screen-recipes-final_20260813.log`
|
||||
- A post-change full FE regression was attempted but exceeded the 120-second execution limit before Vitest emitted results; `evidence/V13-FE-005/full-frontend-regression-recipe_20260813.log` contains only startup output. It is not claimed as PASS. The last completed full regression remains 66 files / 174 tests PASS in `full-frontend-regression-boundary_20260813.log`.
|
||||
- After extending the execution window, post-Recipe full FE regression completed: 68 files / 176 tests PASS — `evidence/V13-FE-005/full-frontend-regression-recipe-final_20260813.log`.
|
||||
- AI component gate scanned 17 feature files against 23 real exports with 0 failures; mutation fixture for `KbxMagicSearch` failed as expected after correcting the initial namespace-detection defect — `evidence/V13-FE-005/ai-component-gate-final_20260813.log`, `evidence/V13-FE-005/ai-component-gate-tests-final2_20260813.log`.
|
||||
- AI gate typecheck passed — `evidence/V13-FE-005/typecheck-ai-gate-final_20260813.log`.
|
||||
- Full component inventory check: 24 `shared/ui/components/*.vue` files exist and 6 are currently tiered in the manifest (25% coverage). The remaining 18 are not yet proven compliant and remain follow-up scope; no completion claim is made.
|
||||
- Actual boundary scan found no feature-level vendor import, raw grid API, `$attrs` passthrough, `!important`, or `:deep()` violation. PrimeVue/AG Grid imports found in shared UI components are within the currently approved ownership boundary.
|
||||
- Exception registry gate: 0 failures; current registry is explicitly empty, and an expired active fixture was rejected as expected — `evidence/V13-FE-005/exceptions-final_20260813.log`, `evidence/V13-FE-005/exception-gate-tests_20260813.log`.
|
||||
- Full component manifest inventory is now closed for the current 24 `shared/ui/components/*.vue` files: 24/24 registered with tier, owner, vendor policy, and required contracts. Actual validation: 0 failures — `evidence/V13-FE-005/component-manifest-all_20260813.log`.
|
||||
- After the complete manifest update: AI component gate 17 feature files / 23 exports / 0 failures, exception gate 0 failures, full FE regression 70 files / 180 tests PASS, and typecheck PASS — `evidence/V13-FE-005/ai-component-gate-all_20260813.log`, `evidence/V13-FE-005/exceptions-all_20260813.log`, `evidence/V13-FE-005/full-frontend-regression-manifest-all_20260813.log`, `evidence/V13-FE-005/typecheck-manifest-all_20260813.log`.
|
||||
- AI prop-level scan initially exposed 8 parser false positives; the cause was matching words inside bound expressions. Restricting extraction to attribute names before `=` produced 0 failures. Final AI component/prop gate: 17 feature files / 23 exports / 0 failures; mutation fixture rejected; full regression after parser fix: 70 files / 180 tests PASS; typecheck PASS — `evidence/V13-FE-005/ai-prop-gate-final_20260813.log`, `evidence/V13-FE-005/ai-prop-gate-tests-final_20260813.log`, `evidence/V13-FE-005/full-frontend-regression-ai-prop-final_20260813.log`, `evidence/V13-FE-005/typecheck-final-governance_20260813.log`.
|
||||
- Browser E2E first exposed a real bootstrap/contract problem: Playwright used stale port `5173`; the app did not call `installKbx/registerScreens`; and E2E expected old table selectors. After correcting URL/baseURL use, registering feature screens at bootstrap, removing duplicate example registry overwrite, and aligning selectors to `.ks-grid`/`.ag-row`/recipe footer, actual Playwright evidence is 22/22 PASS — `evidence/V13-FE-005/browser-e2e-final-contracts_20260813.log`.
|
||||
- Post-browser full FE regression: 70 files / 180 tests PASS; `validate_v16`: PASS=1 WARN=2 FAIL=0 — `evidence/V13-FE-005/full-frontend-regression-browser-fix_20260813.log`, `evidence/V13-FE-005/validate-v16-browser-fix_20260813.log`.
|
||||
- Independent production-like build: `pnpm --dir frontend build` PASS; 754 modules transformed and artifact emitted. Vite retains an existing >500 kB warning (`main` 737.32 kB / gzip 204.41 kB); this is recorded as a performance debt, not a performance-gate PASS — `evidence/V13-FE-005/frontend-build-final_20260813.log`.
|
||||
- Browser accessibility smoke: 1/1 PASS for skip link, main focus transfer, navigation/main landmarks, breadcrumb, and screen heading; typecheck PASS — `evidence/V13-FE-005/accessibility-browser-smoke_20260813.log`, `evidence/V13-FE-005/typecheck-accessibility-smoke_20260813.log`.
|
||||
- CI parity: `.gitea/workflows/ci.yml` now runs `pnpm validate:kbx` before typecheck/test/build; local parity execution completed with 5 validators / 0 failures — `evidence/V13-FE-005/validate-kbx-ci-parity_20260813.log`. Remote Gitea Actions execution is not claimed.
|
||||
- Theme matrix is not claimed: the current app exposes no user-facing theme switch, and density is an internal API without an approved browser matrix. This remains Decision Required rather than invented evidence.
|
||||
- Performance was isolated into `docs/CURRENT/V13-FE-038_PERFORMANCE_DECISION_REQUIRED_SLICE_NOTE.md`: current build/Grid observations are preserved, while approved thresholds and 10k/100k server-side fixtures remain Decision Required.
|
||||
- Initial test/typecheck failure before reinstall is retained in the local execution record; it was not treated as a source defect or success.
|
||||
- Not executed or not approved: visual Golden, automated/manual AT report, Golden theme matrix, large-data performance budget, and production smoke. No claim is made for these evidence classes.
|
||||
@@ -19,6 +19,15 @@
|
||||
- 자동주문/KIS 제출/자동 모델승격 OFF 안내는 화면 레이아웃에서 보존된다.
|
||||
- 새 layout, provider, store, router, token 값은 추가하지 않았다.
|
||||
|
||||
## 2026-08-13 evidence update
|
||||
|
||||
- `AppShellLayout` shared layout colors now consume existing KBX semantic tokens for surface, text, border, and shadow semantics; no new token was introduced.
|
||||
- Targeted layout contract: 1 file / 2 tests PASS; typecheck PASS; `git diff --check` PASS — `evidence/V13-FE-006/layout-token-normalization_20260813.log`.
|
||||
- Visual, assistive-technology, and production-theme claims remain unmade.
|
||||
- Browser accessibility smoke rerun after token normalization: 1 test PASS; skip-link, focus transfer, landmarks, breadcrumb, and heading remained valid — `evidence/V13-FE-006/layout-accessibility-smoke-rerun_20260813.log`.
|
||||
- Mobile browser contract at the configured 390x844 viewport: 1 test PASS; shell/main visibility, heading, viewport containment, and main horizontal-overflow absence verified — `evidence/V13-FE-006/layout-mobile-browser_20260813.log`.
|
||||
- Navigation/auth boundary regression: 3 files / 10 tests PASS; unauthorized navigation filtering, malformed metadata fail-closed behavior, route-registry permission alignment, detail-route suppression, and collapse contract verified — `evidence/V13-FE-006/navigation-auth-boundary_20260813.log`.
|
||||
|
||||
## 실제 증거
|
||||
|
||||
`pnpm vitest run src/shared/ui/layouts/tests/layout.contract.spec.ts`
|
||||
|
||||
@@ -0,0 +1,188 @@
|
||||
# V13-FE-038: 그리드 성능 기준 승인 요청
|
||||
|
||||
**WBS Item:** V13-FE-038
|
||||
**Status:** ⏳ IN_PROGRESS → DECISION_REQUIRED
|
||||
**Decision Owner:** FE Lead/SRE/QA
|
||||
**Blocks:** DataGrid production validation, 10k/100k fixture deployment, Performance SLO claim
|
||||
**Impact:** 성능 예산 미정, 브라우저 환경 보장 불가, 규모 검증 불가
|
||||
|
||||
---
|
||||
|
||||
## 현재 상태
|
||||
|
||||
**문제:**
|
||||
- AG Grid 번들 크기: 1,027,848 → 588,718 bytes (44% 감소)
|
||||
- Vite 경고: >500 kB 청크 여전히 존재
|
||||
- 성능 예산: **미정**
|
||||
- 브라우저 매트릭스: **미정**
|
||||
|
||||
**구현 완료:**
|
||||
- ✅ ClientSideRowModelModule 전환 (AllCommunityModule 제거)
|
||||
- ✅ 청크 최적화 2회 시도 (추가 감소 없음)
|
||||
- ✅ 로컬 빌드 검증
|
||||
|
||||
**검증 필요:**
|
||||
- ⏳ 10k 행 × 100개 열 성능 정의
|
||||
- ⏳ 브라우저 호환성 행렬
|
||||
- ⏳ P95/P99 응답 시간 목표
|
||||
|
||||
---
|
||||
|
||||
## 필요한 3가지 결정
|
||||
|
||||
### 1️⃣ 성능 예산 (Performance Budget)
|
||||
|
||||
**결정:** 그리드 성능의 정량적 기준 정의
|
||||
|
||||
```
|
||||
현재 상태:
|
||||
✅ 개발 서버: 즉시 렌더링 (10k 행)
|
||||
⏳ 프로덕션 빌드: >500kB 청크 경고 (최적화 여지 있음?)
|
||||
⏳ 네트워크: P95 load time (필요 명시)
|
||||
⏳ CPU: Long task 예산 (필요 명시)
|
||||
|
||||
Required decisions:
|
||||
✅ 초기 로드 시간: [ ] ms (P95)
|
||||
✅ Scroll 응답성: [ ] ms (첫 픽셀까지)
|
||||
✅ 필터/정렬: [ ] ms (사용자 액션 → 결과)
|
||||
✅ Long task 예산: [ ] ms (메인 스레드 블로킹)
|
||||
✅ 메모리 한계: [ ] MB (모바일 고려)
|
||||
```
|
||||
|
||||
### 2️⃣ 브라우저 매트릭스 (Browser Matrix)
|
||||
|
||||
**결정:** 지원 브라우저 및 버전 정의
|
||||
|
||||
```
|
||||
Current matrix (추정):
|
||||
- Chrome 120+
|
||||
- Firefox 121+
|
||||
- Safari 17+
|
||||
- Edge 120+
|
||||
|
||||
Questions:
|
||||
✅ 모바일 우선? (iOS Safari 버전)
|
||||
✅ IE/Legacy 지원? (No로 가정)
|
||||
✅ 태블릿 밀도: [ ] (compact/comfortable/touch)
|
||||
✅ 네트워크 환경: [ ] (4G/5G/LTE)
|
||||
✅ 디바이스 범주: [ ] (desktop/tablet/mobile)
|
||||
|
||||
Associated metrics:
|
||||
- 각 브라우저별 Long task 제한
|
||||
- 모바일 장치 성능 분류 (기본/중급/고급)
|
||||
- 폴백 UI (성능 저하 시)
|
||||
```
|
||||
|
||||
### 3️⃣ 10k/100k 테스트 환경 (Fixture Definition)
|
||||
|
||||
**결정:** 성능 검증을 위한 테스트 데이터 및 서버 자원
|
||||
|
||||
```
|
||||
10k rows × 100 columns fixture:
|
||||
✅ 데이터 구조: [스키마 정의]
|
||||
✅ 컬럼 타입: [숫자/문자열/날짜 혼합]
|
||||
✅ 행 크기: [ ] KB (직렬화)
|
||||
✅ 정렬 전략: [ ] (쿼리 기반/클라이언트 기반)
|
||||
✅ 필터 전략: [ ] (서버 사이드/클라이언트)
|
||||
|
||||
100k rows fixture:
|
||||
✅ 데이터 소스: [ ] (synthetic/production shadow)
|
||||
✅ 서버 인프라: [ ] (t3.large? c5.xlarge?)
|
||||
✅ 실행 반복: [ ] (single/multiple/stress)
|
||||
✅ 네트워크 시뮬레이션: [ ] (none/throttle/WAN)
|
||||
|
||||
Checksum & versioning:
|
||||
✅ 기준선 애티팩트 SHA-256: [ ]
|
||||
✅ 변경 추적: [ ] (git lfs? S3?)
|
||||
✅ 재현성: [ ] (고정 seed, 리소스 고정)
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 제출 형식
|
||||
|
||||
**승인자는 다음 정보 제공:**
|
||||
|
||||
### 1. Performance Budget Definition
|
||||
```yaml
|
||||
Initial Load:
|
||||
P95 ms: [ ]
|
||||
Devices: [ ]
|
||||
Network: [ ]
|
||||
|
||||
Interactivity:
|
||||
First Paint: [ ] ms
|
||||
First Contentful Paint: [ ] ms
|
||||
|
||||
Scrolling:
|
||||
Long Task Budget: [ ] ms
|
||||
Frame Budget: 16ms (60fps)
|
||||
|
||||
Memory:
|
||||
Max Heap (Mobile): [ ] MB
|
||||
Max Heap (Desktop): [ ] MB
|
||||
```
|
||||
|
||||
### 2. Browser Support Matrix
|
||||
```csv
|
||||
Browser,Min Version,Mobile,Tablet
|
||||
Chrome,120,,
|
||||
Firefox,121,,
|
||||
Safari,17,,
|
||||
Edge,120,,
|
||||
```
|
||||
|
||||
### 3. Test Fixture Spec
|
||||
```
|
||||
10k Fixture:
|
||||
- Schema: [link]
|
||||
- Row size: [ ] KB
|
||||
- Sorting: [ ]
|
||||
- Filtering: [ ]
|
||||
|
||||
100k Fixture:
|
||||
- Source: [ ]
|
||||
- Server size: [ ]
|
||||
- Runs: [ ]
|
||||
- Checksum: [ ]
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 의존성
|
||||
|
||||
- **Blocks:** V13-FE-004/023 (AG Grid 완성), 프로덕션 배포
|
||||
- **Related:** V13-FE-038 (이 항목), 성능 모니터링, RUM (Real User Monitoring)
|
||||
- **Prerequisite:** AG Grid 라이선스 검증, 서버 자원 예약
|
||||
|
||||
---
|
||||
|
||||
## 현재 번들 상태
|
||||
|
||||
```
|
||||
Before: 1,027,848 bytes
|
||||
After: 588,718 bytes
|
||||
Saved: 439,130 bytes (42.7%)
|
||||
|
||||
Gzip compression:
|
||||
Before: 285.75 kB
|
||||
After: 163.66 kB
|
||||
Saved: 122.09 kB (42.7%)
|
||||
|
||||
Vite warning still present: >500 kB chunk detected
|
||||
Action needed: Further investigation or explicit acceptance
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
**제출 기한:** 2026-08-21 (1주)
|
||||
**승인자:** FE Lead, SRE Lead, QA Lead
|
||||
**Escalation:** Engineering Director (성능 SLO 최종 결정)
|
||||
|
||||
---
|
||||
|
||||
## 참고
|
||||
|
||||
- AEG-X-002: Frontend build optimization (completed, established baseline)
|
||||
- V13-FE-023: AG Grid server-side contract (in progress)
|
||||
- Vite >500kB warning: 선택적 무시 또는 추가 청크 분할 필요
|
||||
@@ -0,0 +1,33 @@
|
||||
# V13-FE-038 — KBX UI Performance Decision Required
|
||||
|
||||
- **WBS / Requirement / UI / Test:** `V13-FE-038` / `REQ-FE-PERF` / `UI-ALL` / `T-FE-PERF-01`
|
||||
- **Scope:** 실제 KBX UI 성능 기준과 측정 fixture를 승인 가능한 형태로 고정
|
||||
- **Source:** `frontend/src/shared/ui/components/KsDataGrid.vue`, `frontend/src/shared/ui/DataGridShell.vue`, `docs/CURRENT/V13-FE-038_GRID_PROVIDER_DECISION.md`, `docs/CURRENT/CATALOGS/WBS_MASTER.csv`, `evidence/V13-FE-005/frontend-build-final_20260813.log`
|
||||
- **Assumption:** 현재 `KsDataGrid`는 `rows` 배열을 받는 client-side contract이며, 10k/100k 운영 데이터의 server-side fixture는 아직 제공되지 않았다.
|
||||
- **Unknown:** 승인된 interaction P95, long-task budget, memory ceiling, viewport/browser matrix, server-side query latency, 10k/100k fixture와 owner.
|
||||
- **Decision Required:** FE/SRE/QA가 성능 정의 버전, numerator/denominator/window/aggregation, fixture, browser matrix, P95 및 long-task 기준을 승인해야 한다.
|
||||
|
||||
## Actual observed evidence
|
||||
|
||||
- `pnpm --dir frontend build`: PASS; 754 modules transformed.
|
||||
- Main artifact: 737.32 kB raw / 204.41 kB gzip.
|
||||
- Vite emits the existing >500 kB warning. This is an observation and debt signal, not a performance-gate PASS.
|
||||
- `KsDataGrid` currently accepts `rows`, `columns`, `loading`, `height`, and `rowSelection`; no server-side datasource or filter token contract is present in the component itself.
|
||||
- Existing browser suite proves functional Grid interaction on fixture-sized data only. It does not prove 10k/100k performance.
|
||||
|
||||
## Safe next Slice contract
|
||||
|
||||
1. Approve a versioned performance definition and fixture checksum.
|
||||
2. Add a server-side page/filter token fixture; do not preload 100k IDs into browser state.
|
||||
3. Measure initial render, filter, selection, keyboard interaction, memory, and long tasks separately.
|
||||
4. Preserve browser/version/OS/artifact SHA and raw traces.
|
||||
5. Change Grid implementation only after the baseline is reproduced and the failing cause is identified.
|
||||
|
||||
## Non-goals
|
||||
|
||||
- No arbitrary threshold invention.
|
||||
- No AG Grid Enterprise dependency.
|
||||
- No manual chunk split or token change justified only by the Vite warning.
|
||||
- No claim of 10k/100k performance, P95 compliance, or production SLO.
|
||||
|
||||
**Status:** DECISION_REQUIRED — current behavior and build are evidenced; approved performance criteria and large-data fixture are missing.
|
||||
@@ -0,0 +1,15 @@
|
||||
import { test, expect } from '@playwright/test'
|
||||
|
||||
test('KBX shell exposes real keyboard and landmark accessibility contracts', async ({ page }) => {
|
||||
await page.goto('/model-ops/models', { waitUntil: 'networkidle' })
|
||||
await expect(page.locator('a.ks-skip')).toHaveAttribute('href', '#ks-main')
|
||||
await expect(page.locator('main#ks-main')).toHaveAttribute('tabindex', '-1')
|
||||
await expect(page.locator('aside[aria-label="주요 메뉴"]')).toBeVisible()
|
||||
await expect(page.locator('nav[aria-label="열린 업무"]')).toBeVisible()
|
||||
await expect(page.locator('nav[aria-label="현재 위치"]')).toBeVisible()
|
||||
await expect(page.locator('h1')).toContainText('Model Management')
|
||||
|
||||
await page.locator('a.ks-skip').focus()
|
||||
await page.keyboard.press('Enter')
|
||||
await expect(page.locator('main#ks-main')).toBeFocused()
|
||||
})
|
||||
@@ -0,0 +1,20 @@
|
||||
import { test, expect } from '@playwright/test'
|
||||
|
||||
test.use({ viewport: { width: 390, height: 844 } })
|
||||
|
||||
test('KBX shell preserves usable layout at the supported mobile viewport', async ({ page }) => {
|
||||
await page.goto('/model-ops/models', { waitUntil: 'networkidle' })
|
||||
|
||||
const shell = page.locator('.ks-app-shell')
|
||||
const main = page.locator('main#ks-main')
|
||||
await expect(shell).toBeVisible()
|
||||
await expect(main).toBeVisible()
|
||||
await expect(page.locator('h1')).toContainText('Model Management')
|
||||
|
||||
const viewport = page.viewportSize()
|
||||
const shellBox = await shell.boundingBox()
|
||||
expect(viewport).not.toBeNull()
|
||||
expect(shellBox).not.toBeNull()
|
||||
expect(shellBox!.width).toBeLessThanOrEqual(viewport!.width)
|
||||
expect(await page.locator('.ks-app-shell__main').evaluate(element => element.scrollWidth <= element.clientWidth)).toBe(true)
|
||||
})
|
||||
@@ -3,7 +3,7 @@ import { test, expect } from '@playwright/test'
|
||||
test.describe('Models (KBX Foundation)', () => {
|
||||
test.beforeEach(async ({ page }) => {
|
||||
// Navigate to models list
|
||||
await page.goto('http://localhost:5173/model-ops/models', {
|
||||
await page.goto('/model-ops/models', {
|
||||
waitUntil: 'networkidle',
|
||||
})
|
||||
|
||||
@@ -17,11 +17,11 @@ test.describe('Models (KBX Foundation)', () => {
|
||||
await expect(title).toContainText('Model Management')
|
||||
|
||||
// Check grid visibility
|
||||
const grid = page.locator('.kbx-data-grid')
|
||||
const grid = page.locator('.ks-grid')
|
||||
await expect(grid).toBeVisible()
|
||||
|
||||
// Check summary badges
|
||||
const summaryItems = page.locator('[class*="summary"]')
|
||||
const summaryItems = page.locator('.ks-list-page__footer > span')
|
||||
await expect(summaryItems).toHaveCount(4)
|
||||
})
|
||||
|
||||
@@ -37,7 +37,7 @@ test.describe('Models (KBX Foundation)', () => {
|
||||
await page.waitForTimeout(300)
|
||||
|
||||
// Grid should still be visible
|
||||
const grid = page.locator('.kbx-data-grid')
|
||||
const grid = page.locator('.ks-grid')
|
||||
await expect(grid).toBeVisible()
|
||||
})
|
||||
|
||||
@@ -53,7 +53,7 @@ test.describe('Models (KBX Foundation)', () => {
|
||||
await page.waitForTimeout(300)
|
||||
|
||||
// Grid should update
|
||||
const grid = page.locator('.kbx-data-grid')
|
||||
const grid = page.locator('.ks-grid')
|
||||
await expect(grid).toBeVisible()
|
||||
})
|
||||
|
||||
@@ -62,7 +62,7 @@ test.describe('Models (KBX Foundation)', () => {
|
||||
await page.waitForTimeout(500)
|
||||
|
||||
// Click first model row
|
||||
const firstRow = page.locator('tbody tr').first()
|
||||
const firstRow = page.locator('.ag-row').first()
|
||||
await expect(firstRow).toBeVisible()
|
||||
await firstRow.click()
|
||||
|
||||
@@ -77,12 +77,10 @@ test.describe('Models (KBX Foundation)', () => {
|
||||
|
||||
test('should display model activation requirements', async ({ page }) => {
|
||||
// Navigate to detail
|
||||
await page.waitForTimeout(500)
|
||||
const firstRow = page.locator('tbody tr').first()
|
||||
if (await firstRow.isVisible()) {
|
||||
await firstRow.click()
|
||||
await page.waitForURL('**/models/*')
|
||||
}
|
||||
const firstRow = page.locator('.ag-row').first()
|
||||
await expect(firstRow).toBeVisible()
|
||||
await firstRow.click()
|
||||
await page.waitForURL('**/models/*')
|
||||
|
||||
// Check requirements section
|
||||
const requirementsSection = page.locator('.requirements-section')
|
||||
@@ -95,12 +93,10 @@ test.describe('Models (KBX Foundation)', () => {
|
||||
|
||||
test('should display model lifecycle phases', async ({ page }) => {
|
||||
// Navigate to detail
|
||||
await page.waitForTimeout(500)
|
||||
const firstRow = page.locator('tbody tr').first()
|
||||
if (await firstRow.isVisible()) {
|
||||
await firstRow.click()
|
||||
await page.waitForURL('**/models/*')
|
||||
}
|
||||
const firstRow = page.locator('.ag-row').first()
|
||||
await expect(firstRow).toBeVisible()
|
||||
await firstRow.click()
|
||||
await page.waitForURL('**/models/*')
|
||||
|
||||
// Check phase timeline
|
||||
const phaseTimeline = page.locator('.phase-timeline')
|
||||
@@ -113,12 +109,10 @@ test.describe('Models (KBX Foundation)', () => {
|
||||
|
||||
test('should display model configuration', async ({ page }) => {
|
||||
// Navigate to detail
|
||||
await page.waitForTimeout(500)
|
||||
const firstRow = page.locator('tbody tr').first()
|
||||
if (await firstRow.isVisible()) {
|
||||
await firstRow.click()
|
||||
await page.waitForURL('**/models/*')
|
||||
}
|
||||
const firstRow = page.locator('.ag-row').first()
|
||||
await expect(firstRow).toBeVisible()
|
||||
await firstRow.click()
|
||||
await page.waitForURL('**/models/*')
|
||||
|
||||
// Check config section
|
||||
const configSection = page.locator('.config-section')
|
||||
@@ -131,12 +125,10 @@ test.describe('Models (KBX Foundation)', () => {
|
||||
|
||||
test('should display validation history table', async ({ page }) => {
|
||||
// Navigate to detail
|
||||
await page.waitForTimeout(500)
|
||||
const firstRow = page.locator('tbody tr').first()
|
||||
if (await firstRow.isVisible()) {
|
||||
await firstRow.click()
|
||||
await page.waitForURL('**/models/*')
|
||||
}
|
||||
const firstRow = page.locator('.ag-row').first()
|
||||
await expect(firstRow).toBeVisible()
|
||||
await firstRow.click()
|
||||
await page.waitForURL('**/models/*')
|
||||
|
||||
// Check history table
|
||||
const historySection = page.locator('.history-section')
|
||||
|
||||
@@ -3,7 +3,7 @@ import { test, expect } from '@playwright/test'
|
||||
test.describe('Shadow Runs (KBX Foundation)', () => {
|
||||
test.beforeEach(async ({ page }) => {
|
||||
// Set up auth headers for development mode
|
||||
await page.goto('http://localhost:5173/model-ops/shadow-runs', {
|
||||
await page.goto('/model-ops/shadow-runs', {
|
||||
waitUntil: 'networkidle',
|
||||
})
|
||||
|
||||
@@ -17,11 +17,11 @@ test.describe('Shadow Runs (KBX Foundation)', () => {
|
||||
await expect(title).toContainText('Shadow Run Validation')
|
||||
|
||||
// Check if grid is present
|
||||
const grid = page.locator('.kbx-data-grid')
|
||||
const grid = page.locator('.ks-grid')
|
||||
await expect(grid).toBeVisible()
|
||||
|
||||
// Check if summary items exist
|
||||
const summaryItems = page.locator('[class*="summary"]')
|
||||
const summaryItems = page.locator('.ks-list-page__footer > span')
|
||||
await expect(summaryItems).toHaveCount(3)
|
||||
})
|
||||
|
||||
@@ -37,7 +37,7 @@ test.describe('Shadow Runs (KBX Foundation)', () => {
|
||||
await page.waitForTimeout(500)
|
||||
|
||||
// Check if grid is still visible
|
||||
const grid = page.locator('.kbx-data-grid')
|
||||
const grid = page.locator('.ks-grid')
|
||||
await expect(grid).toBeVisible()
|
||||
})
|
||||
|
||||
@@ -46,7 +46,7 @@ test.describe('Shadow Runs (KBX Foundation)', () => {
|
||||
await page.waitForTimeout(500)
|
||||
|
||||
// Find first row in grid
|
||||
const firstRow = page.locator('tbody tr').first()
|
||||
const firstRow = page.locator('.ag-row').first()
|
||||
await expect(firstRow).toBeVisible()
|
||||
|
||||
// Click row
|
||||
@@ -63,12 +63,10 @@ test.describe('Shadow Runs (KBX Foundation)', () => {
|
||||
|
||||
test('should display validation summary', async ({ page }) => {
|
||||
// Navigate to detail
|
||||
await page.waitForTimeout(500)
|
||||
const firstRow = page.locator('tbody tr').first()
|
||||
if (await firstRow.isVisible()) {
|
||||
await firstRow.click()
|
||||
await page.waitForURL('**/shadow-runs/*')
|
||||
}
|
||||
const firstRow = page.locator('.ag-row').first()
|
||||
await expect(firstRow).toBeVisible()
|
||||
await firstRow.click()
|
||||
await page.waitForURL('**/shadow-runs/*')
|
||||
|
||||
// Check validation section
|
||||
const validationSection = page.locator('.validation-summary')
|
||||
@@ -90,7 +88,7 @@ test.describe('Shadow Runs (KBX Foundation)', () => {
|
||||
await page.waitForTimeout(300)
|
||||
|
||||
// Verify search was triggered (mock API will respond)
|
||||
const grid = page.locator('.kbx-data-grid')
|
||||
const grid = page.locator('.ks-grid')
|
||||
await expect(grid).toBeVisible()
|
||||
})
|
||||
|
||||
|
||||
@@ -9,7 +9,13 @@
|
||||
"build": "vue-tsc --noEmit && vite build",
|
||||
"typecheck": "vue-tsc --noEmit",
|
||||
"test": "vitest run",
|
||||
"e2e": "playwright test"
|
||||
"e2e": "playwright test",
|
||||
"validate:ui-boundary": "node ../scripts/validate-ui-boundary.mjs --root .",
|
||||
"validate:component-manifest": "node ../scripts/validate-kbx-component-manifest.mjs --root ."
|
||||
,"validate:screen-recipes": "node ../scripts/validate-kbx-screen-recipes.mjs --root ."
|
||||
,"validate:ai-components": "node ../scripts/validate-kbx-ai-components.mjs --root ."
|
||||
,"validate:exceptions": "node ../scripts/validate-kbx-exceptions.mjs --root .",
|
||||
"validate:kbx": "node ../scripts/validate-kbx-governance.mjs --root ."
|
||||
},
|
||||
"dependencies": {
|
||||
"@primevue/themes": "4.5.4",
|
||||
|
||||
@@ -5,11 +5,15 @@ import App from './App.vue'
|
||||
import { router } from './app/router'
|
||||
import { queryClient } from './app/queryClient'
|
||||
import { resolveUiProvider } from './shared/ui/provider'
|
||||
import { installKbx, registerScreens } from './app/installKbx'
|
||||
import { screens } from './registry/screens'
|
||||
import './design-system/base.css'
|
||||
|
||||
const app = createApp(App)
|
||||
app.use(createPinia())
|
||||
app.use(router)
|
||||
app.use(VueQueryPlugin, { queryClient })
|
||||
registerScreens(screens)
|
||||
app.use(installKbx)
|
||||
;(await resolveUiProvider(import.meta.env.VITE_UI_ADAPTER)).install(app)
|
||||
app.mount('#app')
|
||||
|
||||
@@ -5,10 +5,8 @@
|
||||
|
||||
import type { KbxScreenDefinition } from '@shared/contracts/kbx-types'
|
||||
import { homeScreens } from '@features/home/registry'
|
||||
|
||||
// Import screen definitions from each feature module
|
||||
// import { shadowRunScreens } from '@features/shadow-run/registry'
|
||||
// import { modelScreens } from '@features/models/registry'
|
||||
import { shadowRunScreens } from '@features/shadow-run/registry'
|
||||
import { modelScreens } from '@features/models/registry'
|
||||
|
||||
// Temporary: define a few example screens
|
||||
export const exampleScreens: KbxScreenDefinition[] = [
|
||||
@@ -63,11 +61,8 @@ export function getAllScreens(): KbxScreenDefinition[] {
|
||||
|
||||
// Add screens from all modules
|
||||
screens.push(...homeScreens)
|
||||
// screens.push(...shadowRunScreens)
|
||||
// screens.push(...modelScreens)
|
||||
|
||||
// Add example screens for now
|
||||
screens.push(...exampleScreens)
|
||||
screens.push(...shadowRunScreens)
|
||||
screens.push(...modelScreens)
|
||||
|
||||
return screens
|
||||
}
|
||||
|
||||
@@ -0,0 +1,23 @@
|
||||
import { execFileSync } from 'node:child_process'
|
||||
import { mkdirSync, mkdtempSync, writeFileSync } from 'node:fs'
|
||||
import { join } from 'node:path'
|
||||
import { tmpdir } from 'node:os'
|
||||
import { describe, expect, it } from 'vitest'
|
||||
|
||||
describe('AI component hallucination gate', () => {
|
||||
it('accepts actual feature component usage against the shared export manifest', () => {
|
||||
const validator = join(process.cwd(), '..', 'scripts', 'validate-kbx-ai-components.mjs')
|
||||
const output = execFileSync(process.execPath, [validator, '--root', '.'], { cwd: process.cwd(), encoding: 'utf8' })
|
||||
expect(output).toContain('failures=0')
|
||||
})
|
||||
|
||||
it('rejects an unknown AI-generated component against the same manifest contract', () => {
|
||||
const validator = join(process.cwd(), '..', 'scripts', 'validate-kbx-ai-components.mjs')
|
||||
const root = mkdtempSync(join(tmpdir(), 'kbx-ai-component-'))
|
||||
mkdirSync(join(root, 'src', 'features', 'fixture'), { recursive: true })
|
||||
mkdirSync(join(root, 'src', 'shared', 'ui', 'components'), { recursive: true })
|
||||
writeFileSync(join(root, 'src', 'shared', 'ui', 'components', 'index.ts'), "export { default as KsButton } from './KsButton.vue'\n")
|
||||
writeFileSync(join(root, 'src', 'features', 'fixture', 'Example.vue'), '<template><KbxMagicSearch /></template>')
|
||||
expect(() => execFileSync(process.execPath, [validator, '--root', root], { encoding: 'utf8' })).toThrow()
|
||||
})
|
||||
})
|
||||
@@ -0,0 +1,12 @@
|
||||
import { execFileSync } from 'node:child_process'
|
||||
import { join } from 'node:path'
|
||||
import { describe, expect, it } from 'vitest'
|
||||
|
||||
describe('KBX component manifest', () => {
|
||||
it('validates the six Golden Components against real source files', () => {
|
||||
const repositoryRoot = join(process.cwd(), '..')
|
||||
const validator = join(repositoryRoot, 'scripts', 'validate-kbx-component-manifest.mjs')
|
||||
const output = execFileSync(process.execPath, [validator, '--root', '.'], { cwd: process.cwd(), encoding: 'utf8' })
|
||||
expect(output).toContain('failures=0')
|
||||
})
|
||||
})
|
||||
@@ -0,0 +1,21 @@
|
||||
import { execFileSync } from 'node:child_process'
|
||||
import { mkdirSync, mkdtempSync, writeFileSync } from 'node:fs'
|
||||
import { tmpdir } from 'node:os'
|
||||
import { join } from 'node:path'
|
||||
import { describe, expect, it } from 'vitest'
|
||||
|
||||
describe('KBX exception registry gate', () => {
|
||||
it('accepts the current empty approved registry', () => {
|
||||
const validator = join(process.cwd(), '..', 'scripts', 'validate-kbx-exceptions.mjs')
|
||||
const output = execFileSync(process.execPath, [validator, '--root', '.'], { cwd: process.cwd(), encoding: 'utf8' })
|
||||
expect(output).toContain('failures=0')
|
||||
})
|
||||
|
||||
it('rejects an active exception with an expired review date', () => {
|
||||
const validator = join(process.cwd(), '..', 'scripts', 'validate-kbx-exceptions.mjs')
|
||||
const root = mkdtempSync(join(tmpdir(), 'kbx-exception-'))
|
||||
mkdirSync(join(root, 'src', 'shared', 'ui'), { recursive: true })
|
||||
writeFileSync(join(root, 'src', 'shared', 'ui', 'kbx-exception-registry.json'), JSON.stringify({ schemaVersion: '1.0', exceptions: [{ id: 'KBX-EX-TEST', screenId: 'TEST-001', type: 'direct-ui', reason: 'fixture', owner: 'QA', introducedVersion: '1.0.0', reviewAt: '2020-01-01', removalTarget: 'TEST', status: 'active' }] }))
|
||||
expect(() => execFileSync(process.execPath, [validator, '--root', root], { encoding: 'utf8' })).toThrow()
|
||||
})
|
||||
})
|
||||
@@ -0,0 +1,29 @@
|
||||
import { execFileSync } from 'node:child_process'
|
||||
import { mkdtempSync, mkdirSync, writeFileSync } from 'node:fs'
|
||||
import { tmpdir } from 'node:os'
|
||||
import { join } from 'node:path'
|
||||
import { describe, expect, it } from 'vitest'
|
||||
|
||||
const repositoryRoot = join(process.cwd(), '..')
|
||||
const validator = join(repositoryRoot, 'scripts', 'validate-ui-boundary.mjs')
|
||||
|
||||
function fixture(source: string) {
|
||||
const root = mkdtempSync(join(tmpdir(), 'kbx-ui-boundary-'))
|
||||
mkdirSync(join(root, 'src', 'features', 'fixture'), { recursive: true })
|
||||
writeFileSync(join(root, 'src', 'features', 'fixture', 'Example.vue'), source)
|
||||
return root
|
||||
}
|
||||
|
||||
describe('KBX UI boundary gate', () => {
|
||||
it('passes feature code that uses KBX contracts and reports raw colors as debt warnings', () => {
|
||||
const root = fixture('<template><button class="kbx-button">저장</button></template><style>.kbx-button{color:#fff}</style>')
|
||||
const output = execFileSync(process.execPath, [validator, '--root', root], { encoding: 'utf8' })
|
||||
expect(output).toContain('failures=0')
|
||||
expect(output).toContain('raw color requires token-debt classification')
|
||||
})
|
||||
|
||||
it('fails direct vendor imports and supplier CSS leakage in feature code', () => {
|
||||
const root = fixture('<script setup>import Button from "primevue/button"</script><style>:deep(.p-button){height:42px!important}</style>')
|
||||
expect(() => execFileSync(process.execPath, [validator, '--root', root], { encoding: 'utf8' })).toThrow()
|
||||
})
|
||||
})
|
||||
@@ -0,0 +1,30 @@
|
||||
{
|
||||
"schemaVersion": "1.0",
|
||||
"governance": "KBX_UI_BOUNDARY_GOVERNANCE",
|
||||
"components": [
|
||||
{"id":"C-010","name":"KsButton","tier":"L1","owner":"kbx-ui","source":"src/shared/ui/components/KsButton.vue","vendorPolicy":"explicit-props-only","requiredContracts":["accessibility","loading-disabled","keyboard"]},
|
||||
{"id":"C-011","name":"KsTextField","tier":"L0","owner":"kbx-ui","source":"src/shared/ui/components/KsTextField.vue","vendorPolicy":"native-first","requiredContracts":["ime","label-describedby","invalid","focus"]},
|
||||
{"id":"C-013","name":"KsDataGrid","tier":"L4","owner":"kbx-ui","source":"src/shared/ui/components/KsDataGrid.vue","vendorPolicy":"strong-facade-no-raw-api","requiredContracts":["selection","clipboard","keyboard","accessibility","performance"]},
|
||||
{"id":"C-014","name":"KsDialog","tier":"L2","owner":"kbx-ui","source":"src/shared/ui/components/KsDialog.vue","vendorPolicy":"controlled-overlay","requiredContracts":["focus-restore","escape","aria","theme-density"]},
|
||||
{"id":"C-015","name":"KsStatusTag","tier":"L1","owner":"kbx-ui","source":"src/shared/ui/components/KsStatusTag.vue","vendorPolicy":"semantic-status-only","requiredContracts":["text-not-color-only","state-matrix"]},
|
||||
{"id":"V14-C-001","name":"KsDateField","tier":"L2","owner":"kbx-ui","source":"src/shared/ui/components/KsDateField.vue","vendorPolicy":"controlled-input","requiredContracts":["keyboard","readonly-disabled","invalid","theme-density"]},
|
||||
{"id":"C-012","name":"KsSelect","tier":"L2","owner":"kbx-ui","source":"src/shared/ui/components/KsSelect.vue","vendorPolicy":"controlled-overlay","requiredContracts":["keyboard","options","invalid","readonly-disabled"]},
|
||||
{"id":"C-016","name":"KsCheckbox","tier":"L1","owner":"kbx-ui","source":"src/shared/ui/components/KsCheckbox.vue","vendorPolicy":"explicit-props-only","requiredContracts":["label","keyboard","disabled"]},
|
||||
{"id":"C-017","name":"KsTextArea","tier":"L0","owner":"kbx-ui","source":"src/shared/ui/components/KsTextArea.vue","vendorPolicy":"native-first","requiredContracts":["label-describedby","invalid","maxlength"]},
|
||||
{"id":"C-018","name":"KsNumberField","tier":"L2","owner":"kbx-ui","source":"src/shared/ui/components/KsNumberField.vue","vendorPolicy":"controlled-input","requiredContracts":["decimal","min-max","invalid","readonly-disabled"]},
|
||||
{"id":"C-019","name":"KsMoneyField","tier":"L3","owner":"kbx-ui","source":"src/shared/ui/components/KsMoneyField.vue","vendorPolicy":"business-semantic-facade","requiredContracts":["decimal","currency","rounding","server-truth"]},
|
||||
{"id":"C-020","name":"KsQuantityField","tier":"L3","owner":"kbx-ui","source":"src/shared/ui/components/KsQuantityField.vue","vendorPolicy":"business-semantic-facade","requiredContracts":["decimal","unit","range","server-truth"]},
|
||||
{"id":"C-021","name":"KsMultiSelect","tier":"L2","owner":"kbx-ui","source":"src/shared/ui/components/KsMultiSelect.vue","vendorPolicy":"controlled-overlay","requiredContracts":["keyboard","selection","invalid","readonly-disabled"]},
|
||||
{"id":"C-022","name":"KsPaginator","tier":"L2","owner":"kbx-ui","source":"src/shared/ui/components/KsPaginator.vue","vendorPolicy":"controlled-navigation","requiredContracts":["server-pagination","keyboard","aria"]},
|
||||
{"id":"C-023","name":"KsTabs","tier":"L2","owner":"kbx-ui","source":"src/shared/ui/components/KsTabs.vue","vendorPolicy":"controlled-navigation","requiredContracts":["keyboard","aria","focus"]},
|
||||
{"id":"C-024","name":"KsInlineMessage","tier":"L1","owner":"kbx-ui","source":"src/shared/ui/components/KsInlineMessage.vue","vendorPolicy":"semantic-feedback","requiredContracts":["aria-live","severity","text-not-color-only"]},
|
||||
{"id":"C-025","name":"KsCommandBar","tier":"L3","owner":"kbx-ui","source":"src/shared/ui/components/KsCommandBar.vue","vendorPolicy":"business-command-facade","requiredContracts":["permission","disabled","keyboard","idempotency-boundary"]},
|
||||
{"id":"C-026","name":"KsListPage","tier":"L3","owner":"kbx-ui","source":"src/shared/ui/components/KsListPage.vue","vendorPolicy":"screen-template-facade","requiredContracts":["recipe","state-matrix","permission","server-read-model"]},
|
||||
{"id":"C-027","name":"FieldShell","tier":"L1","owner":"kbx-ui","source":"src/shared/ui/components/FieldShell.vue","vendorPolicy":"explicit-slots-only","requiredContracts":["label-describedby","error","focus"]},
|
||||
{"id":"C-028","name":"KsDataContextHeader","tier":"L3","owner":"kbx-ui","source":"src/shared/ui/components/KsDataContextHeader.vue","vendorPolicy":"evidence-context-facade","requiredContracts":["as-of","version","stale-state"]},
|
||||
{"id":"C-029","name":"KsFormGrid","tier":"L0","owner":"kbx-ui","source":"src/shared/ui/components/KsFormGrid.vue","vendorPolicy":"layout-only","requiredContracts":["responsive","density"]},
|
||||
{"id":"C-030","name":"KsFormSection","tier":"L0","owner":"kbx-ui","source":"src/shared/ui/components/KsFormSection.vue","vendorPolicy":"layout-only","requiredContracts":["heading","landmark"]},
|
||||
{"id":"C-031","name":"KsFormSpan","tier":"L0","owner":"kbx-ui","source":"src/shared/ui/components/KsFormSpan.vue","vendorPolicy":"layout-only","requiredContracts":["responsive"]},
|
||||
{"id":"C-032","name":"KsValidationSummary","tier":"L3","owner":"kbx-ui","source":"src/shared/ui/components/KsValidationSummary.vue","vendorPolicy":"validation-feedback-facade","requiredContracts":["aria","field-links","server-errors"]}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,4 @@
|
||||
{
|
||||
"schemaVersion": "1.0",
|
||||
"exceptions": []
|
||||
}
|
||||
@@ -20,13 +20,13 @@ const appVersion = import.meta.env.VITE_APP_VERSION ?? '0.1.0'
|
||||
</template>
|
||||
<style scoped>
|
||||
.ks-shell { min-height: 100vh; display: grid; grid-template-columns: 16rem minmax(0, 1fr); grid-template-rows: auto 1fr auto; grid-template-areas: 'header header' 'nav main' 'footer footer'; }
|
||||
.ks-shell__header { grid-area: header; display: flex; align-items: center; justify-content: space-between; gap: var(--ks-space-4); padding: var(--ks-space-3) var(--ks-space-6); color: #fff; background: var(--ks-color-neutral-950); }
|
||||
.ks-shell__header { grid-area: header; display: flex; align-items: center; justify-content: space-between; gap: var(--ks-space-4); padding: var(--ks-space-3) var(--ks-space-6); color: var(--ks-color-text-on-dark); background: var(--ks-color-neutral-950); }
|
||||
.ks-shell__header > div:first-child { display: grid; } .ks-shell__header small { color: #cbd5e1; }
|
||||
.ks-shell__boundary { padding: var(--ks-space-2) var(--ks-space-3); border: 1px solid #fbbf24; border-radius: var(--ks-radius-sm); color: #fef3c7; }
|
||||
.ks-shell__nav { grid-area: nav; padding: var(--ks-space-4); border-right: 1px solid var(--ks-color-neutral-200); background: #fff; }
|
||||
.ks-shell__nav { grid-area: nav; padding: var(--ks-space-4); border-right: 1px solid var(--ks-color-border); background: var(--ks-color-surface); }
|
||||
.ks-shell__main { grid-area: main; min-width: 0; padding: var(--ks-space-6); }
|
||||
.ks-shell__footer { grid-area: footer; padding: var(--ks-space-2) var(--ks-space-6); border-top: 1px solid var(--ks-color-neutral-200); background: #fff; color: var(--ks-color-neutral-600); font-size: var(--ks-font-caption); }
|
||||
.ks-shell__version { position: fixed; left: var(--ks-space-3); bottom: var(--ks-space-2); z-index: 20; padding: .25rem .5rem; border: 1px solid var(--ks-color-neutral-200); border-radius: var(--ks-radius-sm); background: rgb(255 255 255 / 92%); color: var(--ks-color-neutral-600); font-size: .7rem; box-shadow: 0 .15rem .5rem rgb(15 23 42 / 8%); }
|
||||
.ks-skip { position: fixed; left: var(--ks-space-2); top: -4rem; z-index: 1000; padding: var(--ks-space-2); background: #fff; } .ks-skip:focus { top: var(--ks-space-2); }
|
||||
.ks-shell__footer { grid-area: footer; padding: var(--ks-space-2) var(--ks-space-6); border-top: 1px solid var(--ks-color-border); background: var(--ks-color-surface); color: var(--ks-color-text-muted); font-size: var(--ks-font-caption); }
|
||||
.ks-shell__version { position: fixed; left: var(--ks-space-3); bottom: var(--ks-space-2); z-index: 20; padding: .25rem .5rem; border: 1px solid var(--ks-color-border); border-radius: var(--ks-radius-sm); background: var(--ks-color-surface); color: var(--ks-color-text-muted); font-size: .7rem; box-shadow: var(--ks-shadow-sm); }
|
||||
.ks-skip { position: fixed; left: var(--ks-space-2); top: -4rem; z-index: 1000; padding: var(--ks-space-2); background: var(--ks-color-surface); } .ks-skip:focus { top: var(--ks-space-2); }
|
||||
@media (max-width: 900px) { .ks-shell { grid-template-columns: 1fr; grid-template-areas: 'header' 'nav' 'main' 'footer'; } .ks-shell__header { align-items: flex-start; flex-direction: column; } .ks-shell__nav { border-right: 0; border-bottom: 1px solid var(--ks-color-neutral-200); } }
|
||||
</style>
|
||||
|
||||
@@ -0,0 +1,20 @@
|
||||
{
|
||||
"schemaVersion": "1.0",
|
||||
"contractVersion": "KBX-SCREEN-RECIPE-1",
|
||||
"recipes": [
|
||||
{
|
||||
"id": "T01",
|
||||
"type": "list",
|
||||
"requiredPolicies": ["server-read-model", "tanstack-query", "search-condition-preservation", "server-side-bulk-selection"],
|
||||
"recoveryPolicies": ["idle-before-first-search", "retain-grid-during-refresh", "retry-with-search-context", "partial-bulk-result"],
|
||||
"securityPolicies": ["screen-permission", "command-permission", "safe-drilldown-route", "masked-sensitive-cells"]
|
||||
},
|
||||
{
|
||||
"id": "T12",
|
||||
"type": "queue",
|
||||
"requiredPolicies": ["exception-first-projection", "sla-state", "server-side-bulk-selection", "audit"],
|
||||
"recoveryPolicies": ["partial-action-result", "retryable-vs-terminal-error", "stale-event-suppression", "detail-context-retention"],
|
||||
"securityPolicies": ["screen-permission", "exception-action-permission", "server-enforcement"]
|
||||
}
|
||||
]
|
||||
}
|
||||
@@ -0,0 +1,11 @@
|
||||
import { execFileSync } from 'node:child_process'
|
||||
import { join } from 'node:path'
|
||||
import { describe, expect, it } from 'vitest'
|
||||
|
||||
describe('KBX screen recipe governance', () => {
|
||||
it('validates the normalized recipe contract against the real TypeScript recipe source', () => {
|
||||
const validator = join(process.cwd(), '..', 'scripts', 'validate-kbx-screen-recipes.mjs')
|
||||
const output = execFileSync(process.execPath, [validator, '--root', '.'], { cwd: process.cwd(), encoding: 'utf8' })
|
||||
expect(output).toContain('failures=0')
|
||||
})
|
||||
})
|
||||
@@ -0,0 +1,50 @@
|
||||
import fs from 'node:fs'
|
||||
import path from 'node:path'
|
||||
|
||||
const root = path.resolve(process.argv[process.argv.indexOf('--root') + 1] ?? 'frontend')
|
||||
const featureRoot = path.join(root, 'src', 'features')
|
||||
const indexPath = path.join(root, 'src', 'shared', 'ui', 'components', 'index.ts')
|
||||
const failures = []
|
||||
const files = []
|
||||
function walk(directory) {
|
||||
if (!fs.existsSync(directory)) return
|
||||
for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
|
||||
const file = path.join(directory, entry.name)
|
||||
if (entry.isDirectory()) walk(file)
|
||||
else if (entry.name.endsWith('.vue')) files.push(file)
|
||||
}
|
||||
}
|
||||
walk(featureRoot)
|
||||
const exported = new Set([...fs.readFileSync(indexPath, 'utf8').matchAll(/export\s+\{\s*default\s+as\s+(Ks\w+)/g)].map(match => match[1]))
|
||||
const commonAttributes = new Set(['class', 'style', 'id', 'title', 'role', 'tabindex', 'key', 'ref', 'aria-label', 'aria-describedby', 'aria-live', 'data-testid'])
|
||||
const componentProps = new Map()
|
||||
for (const name of exported) {
|
||||
const componentPath = path.join(root, 'src', 'shared', 'ui', 'components', `${name}.vue`)
|
||||
if (!fs.existsSync(componentPath)) continue
|
||||
const source = fs.readFileSync(componentPath, 'utf8')
|
||||
const propsBlock = source.match(/defineProps\s*<\s*\{([\s\S]*?)\}\s*>/)?.[1] ?? ''
|
||||
componentProps.set(name, new Set([...propsBlock.matchAll(/([A-Za-z_$][\w$]*)\s*\??\s*:/g)].map(match => match[1])))
|
||||
}
|
||||
for (const file of files) {
|
||||
const source = fs.readFileSync(file, 'utf8')
|
||||
for (const match of source.matchAll(/<\/(K(?:s|bx)\w+)|<(K(?:s|bx)\w+)(?=[\s>])/g)) {
|
||||
const name = match[1] ?? match[2]
|
||||
if (!exported.has(name)) failures.push(`${path.relative(process.cwd(), file).replaceAll('\\', '/')}: unknown KBX component ${name}`)
|
||||
else {
|
||||
const tagStart = match.index + match[0].length
|
||||
const tagEnd = source.indexOf('>', tagStart)
|
||||
const tag = source.slice(tagStart, tagEnd < 0 ? source.length : tagEnd)
|
||||
const props = componentProps.get(name) ?? new Set()
|
||||
for (const attr of tag.matchAll(/(?:^|\s)(?::|v-bind:)?([A-Za-z][\w-]*)(?=\s*=)/g)) {
|
||||
const prop = attr[1]
|
||||
if (commonAttributes.has(prop) || prop.startsWith('v-') || prop.startsWith('aria-') || prop.startsWith('data-') || ['if','else','else-if','for','show','model','on','slot'].includes(prop)) continue
|
||||
const camel = prop.replace(/-([a-z])/g, (_, letter) => letter.toUpperCase())
|
||||
if (!props.has(camel)) failures.push(`${path.relative(process.cwd(), file).replaceAll('\\', '/')}: unknown prop ${prop} on ${name}`)
|
||||
}
|
||||
}
|
||||
}
|
||||
if (/(?:primevue(?:\/|$)|ag-grid(?:-vue3)?(?:\/|$))/.test(source)) failures.push(`${path.relative(process.cwd(), file).replaceAll('\\', '/')}: vendor import in AI-scan scope`)
|
||||
}
|
||||
console.log(`KBX_AI_COMPONENTS files=${files.length} known=${exported.size} failures=${failures.length}`)
|
||||
for (const failure of failures) console.log(`FAIL ${failure}`)
|
||||
process.exitCode = failures.length ? 1 : 0
|
||||
@@ -0,0 +1,28 @@
|
||||
import fs from 'node:fs'
|
||||
import path from 'node:path'
|
||||
|
||||
const root = path.resolve(process.argv[process.argv.indexOf('--root') + 1] ?? 'frontend')
|
||||
const manifestPath = path.join(root, 'src', 'shared', 'ui', 'component-manifest.json')
|
||||
const failures = []
|
||||
const allowedTiers = new Set(['L0', 'L1', 'L2', 'L3', 'L4'])
|
||||
if (!fs.existsSync(manifestPath)) failures.push('missing component manifest')
|
||||
else {
|
||||
const manifest = JSON.parse(fs.readFileSync(manifestPath, 'utf8'))
|
||||
if (manifest.schemaVersion !== '1.0') failures.push('unsupported manifest schema')
|
||||
if (!Array.isArray(manifest.components) || manifest.components.length < 6) failures.push('golden component coverage is incomplete')
|
||||
const ids = new Set()
|
||||
const names = new Set()
|
||||
for (const item of manifest.components ?? []) {
|
||||
if (ids.has(item.id)) failures.push(`duplicate component id ${item.id}`)
|
||||
if (names.has(item.name)) failures.push(`duplicate component name ${item.name}`)
|
||||
ids.add(item.id); names.add(item.name)
|
||||
if (!allowedTiers.has(item.tier)) failures.push(`${item.name}: invalid tier`)
|
||||
if (!item.owner || !item.vendorPolicy || !item.requiredContracts?.length) failures.push(`${item.name}: incomplete governance fields`)
|
||||
const source = path.join(root, 'src', 'shared', 'ui', 'components', path.basename(item.source))
|
||||
if (!fs.existsSync(source)) failures.push(`${item.name}: missing source ${item.source}`)
|
||||
if (item.name === 'KsDataGrid' && item.vendorPolicy !== 'strong-facade-no-raw-api') failures.push('KsDataGrid must be a strong facade')
|
||||
}
|
||||
}
|
||||
console.log(`KBX_COMPONENT_MANIFEST failures=${failures.length}`)
|
||||
for (const failure of failures) console.log(`FAIL ${failure}`)
|
||||
process.exitCode = failures.length ? 1 : 0
|
||||
@@ -0,0 +1,24 @@
|
||||
import fs from 'node:fs'
|
||||
import path from 'node:path'
|
||||
|
||||
const root = path.resolve(process.argv[process.argv.indexOf('--root') + 1] ?? 'frontend')
|
||||
const registryPath = path.join(root, 'src', 'shared', 'ui', 'kbx-exception-registry.json')
|
||||
const failures = []
|
||||
const today = new Date().toISOString().slice(0, 10)
|
||||
if (!fs.existsSync(registryPath)) failures.push('missing exception registry')
|
||||
else {
|
||||
const registry = JSON.parse(fs.readFileSync(registryPath, 'utf8'))
|
||||
const ids = new Set()
|
||||
for (const item of registry.exceptions ?? []) {
|
||||
if (ids.has(item.id)) failures.push(`duplicate exception ${item.id}`)
|
||||
ids.add(item.id)
|
||||
for (const field of ['id', 'screenId', 'type', 'reason', 'owner', 'introducedVersion', 'reviewAt', 'removalTarget', 'status']) {
|
||||
if (!item[field]) failures.push(`${item.id ?? 'unknown'}: missing ${field}`)
|
||||
}
|
||||
if (item.reviewAt && item.reviewAt < today && item.status === 'active') failures.push(`${item.id}: reviewAt expired`)
|
||||
if (!['active', 'removed', 'waived'].includes(item.status)) failures.push(`${item.id}: invalid status`)
|
||||
}
|
||||
}
|
||||
console.log(`KBX_EXCEPTIONS failures=${failures.length}`)
|
||||
for (const failure of failures) console.log(`FAIL ${failure}`)
|
||||
process.exitCode = failures.length ? 1 : 0
|
||||
@@ -0,0 +1,27 @@
|
||||
import { execFileSync } from 'node:child_process'
|
||||
import { fileURLToPath } from 'node:url'
|
||||
import path from 'node:path'
|
||||
|
||||
const root = path.resolve(process.argv[process.argv.indexOf('--root') + 1] ?? 'frontend')
|
||||
const validators = [
|
||||
'validate-ui-boundary.mjs',
|
||||
'validate-kbx-component-manifest.mjs',
|
||||
'validate-kbx-screen-recipes.mjs',
|
||||
'validate-kbx-ai-components.mjs',
|
||||
'validate-kbx-exceptions.mjs',
|
||||
]
|
||||
const repositoryRoot = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
|
||||
const failures = []
|
||||
for (const validator of validators) {
|
||||
const file = path.join(repositoryRoot, 'scripts', validator)
|
||||
try {
|
||||
const output = execFileSync(process.execPath, [file, '--root', root], { encoding: 'utf8' })
|
||||
process.stdout.write(`[PASS] ${validator}\n${output}`)
|
||||
} catch (error) {
|
||||
failures.push(validator)
|
||||
process.stdout.write(`[FAIL] ${validator}\n${error.stdout ?? ''}${error.stderr ?? ''}`)
|
||||
}
|
||||
}
|
||||
console.log(`KBX_GOVERNANCE validators=${validators.length} failures=${failures.length}`)
|
||||
if (failures.length) console.log(`Failed validators: ${failures.join(', ')}`)
|
||||
process.exitCode = failures.length ? 1 : 0
|
||||
@@ -0,0 +1,26 @@
|
||||
import fs from 'node:fs'
|
||||
import path from 'node:path'
|
||||
|
||||
const root = path.resolve(process.argv[process.argv.indexOf('--root') + 1] ?? 'frontend')
|
||||
const failures = []
|
||||
const contractPath = path.join(root, 'src', 'shared', 'ui', 'screen-types', 'screen-recipes.json')
|
||||
const sourcePath = path.join(root, 'src', 'shared', 'ui', 'screen-types', 'screenRecipe.ts')
|
||||
if (!fs.existsSync(contractPath) || !fs.existsSync(sourcePath)) failures.push('recipe contract/source missing')
|
||||
else {
|
||||
const contract = JSON.parse(fs.readFileSync(contractPath, 'utf8'))
|
||||
const source = fs.readFileSync(sourcePath, 'utf8')
|
||||
const ids = new Set()
|
||||
for (const recipe of contract.recipes ?? []) {
|
||||
if (ids.has(recipe.id)) failures.push(`duplicate recipe ${recipe.id}`)
|
||||
ids.add(recipe.id)
|
||||
for (const field of ['type', 'requiredPolicies', 'recoveryPolicies', 'securityPolicies']) {
|
||||
if (!recipe[field] || (Array.isArray(recipe[field]) && recipe[field].length === 0)) failures.push(`${recipe.id}: missing ${field}`)
|
||||
}
|
||||
const variable = recipe.id === 'T01' ? 'searchListRecipe' : recipe.id === 'T12' ? 'workQueueRecipe' : null
|
||||
if (!variable || !source.includes(`const ${variable}`)) failures.push(`${recipe.id}: source recipe is not represented`)
|
||||
}
|
||||
if (ids.size === 0) failures.push('no recipes registered')
|
||||
}
|
||||
console.log(`KBX_SCREEN_RECIPES failures=${failures.length}`)
|
||||
for (const failure of failures) console.log(`FAIL ${failure}`)
|
||||
process.exitCode = failures.length ? 1 : 0
|
||||
@@ -0,0 +1,42 @@
|
||||
import fs from 'node:fs'
|
||||
import path from 'node:path'
|
||||
|
||||
const args = process.argv.slice(2)
|
||||
const rootArg = args[args.indexOf('--root') + 1] ?? 'frontend'
|
||||
const root = path.resolve(rootArg)
|
||||
const featureRoot = path.join(root, 'src', 'features')
|
||||
const files = []
|
||||
const failures = []
|
||||
const warnings = []
|
||||
|
||||
function walk(directory) {
|
||||
if (!fs.existsSync(directory)) return
|
||||
for (const entry of fs.readdirSync(directory, { withFileTypes: true })) {
|
||||
const file = path.join(directory, entry.name)
|
||||
if (entry.isDirectory()) walk(file)
|
||||
else if (/\.(ts|tsx|vue|css|scss)$/.test(entry.name)) files.push(file)
|
||||
}
|
||||
}
|
||||
|
||||
function relative(file) {
|
||||
return path.relative(process.cwd(), file).replaceAll('\\', '/')
|
||||
}
|
||||
|
||||
walk(featureRoot)
|
||||
const vendorImport = /(?:from|import\s*\(|import\s+)['"](?:primevue(?:\/|$)|ag-grid(?:-vue3)?(?:\/|$))/
|
||||
const cssLeakage = /(?:\.p-[a-z0-9_-]+|\.ag-[a-z0-9_-]+|:deep\s*\([^)]*(?:\.p-|\.ag-)|!important)/i
|
||||
const rawColor = /(?:#[0-9a-f]{3,8}\b|\brgba?\s*\(|\bhsl\s*\()/i
|
||||
|
||||
for (const file of files) {
|
||||
const source = fs.readFileSync(file, 'utf8')
|
||||
const name = relative(file)
|
||||
if (vendorImport.test(source)) failures.push(`${name}: direct PrimeVue/AG Grid import`)
|
||||
if (cssLeakage.test(source)) failures.push(`${name}: supplier CSS leakage or !important`)
|
||||
if (rawColor.test(source)) warnings.push(`${name}: raw color requires token-debt classification`)
|
||||
}
|
||||
|
||||
if (!fs.existsSync(featureRoot)) failures.push(`missing feature root: ${relative(featureRoot)}`)
|
||||
console.log(`UI_BOUNDARY files=${files.length} failures=${failures.length} warnings=${warnings.length}`)
|
||||
for (const warning of warnings) console.log(`WARN ${warning}`)
|
||||
for (const failure of failures) console.log(`FAIL ${failure}`)
|
||||
process.exitCode = failures.length ? 1 : 0
|
||||
@@ -3,6 +3,6 @@
|
||||
"Mode": "DevelopmentHeader"
|
||||
},
|
||||
"ConnectionStrings": {
|
||||
"Postgres": "Host=127.0.0.1;Port=5432;Database=kartselldb;Username=kartsell;Password=kartsell4321@!"
|
||||
"Postgres": ""
|
||||
}
|
||||
}
|
||||
|
||||
@@ -7,20 +7,20 @@
|
||||
}
|
||||
},
|
||||
"ConnectionStrings": {
|
||||
"Postgres": "Host=127.0.0.1;Port=5432;Database=kartselldb;Username=kartsell;Password=kartsell4321@!"
|
||||
"Postgres": ""
|
||||
},
|
||||
"ExternalApis": {
|
||||
"KrxOpenApi": {
|
||||
"ApiKey": "FB391C96F128419AAFB193AB73DD6B8263E0D021",
|
||||
"ApiKey": "",
|
||||
"BaseUrl": "https://openapi.krx.co.kr"
|
||||
},
|
||||
"OpenDart": {
|
||||
"ApiKey": "75fa723edaf910cdb5e5412fb970333f2a334c63 ",
|
||||
"ApiKey": "",
|
||||
"BaseUrl": "https://opendart.fss.or.kr"
|
||||
},
|
||||
"Kis": {
|
||||
"ApiKey": "PSO3IbfKGVzArif97sdLhtfHZUo0wE7qLx8R",
|
||||
"ApiSecret": "0BD6sP51aB5pf3CXZLGXM1reyE1CWokwPuUOUR6zXve224OXHse9V1thvziQLIyGlQxNeWkshu6mo4WadZOODd1Iw+gN8cxbxnyf4jLIOuJc43jbwAP3SCIoX74WYMQUZCdnq2RJGcdux8JTXMzozh8zIMJKOc2B51qa+jiRNdKIItLBuJA=",
|
||||
"ApiKey": "",
|
||||
"ApiSecret": "",
|
||||
"BaseUrl": "https://openapi.kbsec.com"
|
||||
}
|
||||
},
|
||||
|
||||
Reference in New Issue
Block a user