Files
KArtSell.Aegis/docs/CURRENT/03_BE_DATA.md
T
kjh2064 5dfb8f3e12
ci / backend (push) Failing after 1s
ci / static (push) Failing after 6s
ci / frontend (push) Failing after 5s
refactor: Reorganize docs folder structure for clarity and version management (PR 3c)
Reorganize documentation following AGENTS.md v16.0 governance (traceability, reproducibility):

Structure changes:
- CURRENT/ (new)
  ├─ 00~08.md (v16.0 standards, renamed for clarity)
  └─ CATALOGS/ (9 CSV files: WBS, decision log, debt register, matrices, catalogs)

- LEGACY/ (new, read-only archives)
  ├─ v11/ (original baseline + hardening analysis)
  ├─ v12~v15/ (.gitkeep + README for future archiving)

- DECISIONS/ (new, ready for ADR usage)
- TEMPLATES/ (existing, unchanged)

Deletions (consolidated into CURRENT/):
- v16_0/ folder (files migrated)
- hardening/ folder (contents → LEGACY/v11/)
- Root-level v11 files (00~07.md, CSV)

Renames (for clarity):
- 00_EXECUTIVE_REFERENCE_IMPLEMENTATION.md → 00_EXECUTIVE.md
- 01_BRUTAL_ROLE_AUDIT.md → 01_ROLE_AUDIT.md
- 02_FRONTEND_ADAPTER_CRUD_STANDARD.md → 02_FE_ADAPTER.md
- 03_BACKEND_DATA_SCHEDULER_STANDARD.md → 03_BE_DATA.md
- 04_ALGORITHM_MODEL_GOVERNANCE.md → 04_ALGORITHM.md
- 05_PROCESS_VIBE_DEBT_CONTROL.md → 05_PROCESS_VIBE_DEBT.md
- 06_VALIDATION_TRUTH.md → 06_VALIDATION.md
- 07_PACKAGE_ATTACHMENT_POLICY.md → 07_PACKAGE_POLICY.md

Updates:
- docs/INDEX.md (complete rewrite with navigation)
- LEGACY/ folders with README + .gitkeep

Benefits:
 Clear version management (v16.0 is active, v11~v15 read-only)
 No version mixing in root
 CURRENT/ as single point of reference for active docs
 CATALOGS/ consolidates all data matrices
 LEGACY/ preserves history without clutter
 Traceability: decision log, tech debt, WBS all linked
 DECISIONS/ ready for ADR pattern (future use)

Sync with root:
- CLAUDE.md references: docs/CURRENT/, docs/INDEX.md 
- AGENTS.md references: docs/CURRENT/, traceability 
- README.md: Document guide links updated 

Co-Authored-By: Claude Haiku 4.5 <noreply@anthropic.com>
2026-08-02 05:49:29 +09:00

1.1 KiB

BE·데이터·스케줄러 실행참조 표준

BE

Endpoint는 HTTP/Auth/Validation, Application은 orchestration/idempotency/transaction, Domain은 순수 정책, Infrastructure는 Dapper/Npgsql/Adapter를 소유한다. 생산 Command는 최소 식별자만 받고 PIT Evidence는 서버에서 해석한다.

ExecutionEnvelope

AsOf, PublishedAtCutoff, ScopeKey, IdempotencyKey, CorrelationId, VersionSet, ContentHash를 검증한다. PublishedAtCutoff > AsOf는 즉시 차단한다.

Scheduler

  • scheduledFor anchor에서 다음 시각을 계산한다.
  • Lease는 fencing token을 가지며 stale worker의 갱신·advance를 거부한다.
  • BusinessHold와 기술 실패를 분리한다.
  • J41은 expired/overlap/stale token을 감사한다.
  • J42는 거래세션 평가창의 누락·중복·지연·revision 재계산 계획을 만든다.
  • J41/J42는 기본 disabled이며 자동 모델 변경을 하지 않는다.

DB

Write model은 정규화한다. Evidence/Decision/Evaluation reconciliation은 append-only로 보존한다. 역정규화는 Projection에 한정하고 Version/Watermark/Rebuild/Stale 상태를 가진다.