Initial commit: Add project files

2026-08-02 05:15:36 +09:00
commit dcd1322d41
636 changed files with 122352 additions and 0 deletions
@@ -0,0 +1,46 @@
+# 기본 템플릿 사용법
+
+## 1. 사전 준비
+
+- .NET SDK 10.0.100 이상.
+- Node.js 22.
+- pnpm 10.
+- PostgreSQL 17.
+
+현재 패키지에는 registry 접근이 불가능한 환경에서 생성되었으므로 `pnpm-lock.yaml`이 없다. 네트워크가 가능한 승인 환경에서 한 번 생성하고 dependency review 후 커밋한다.
+
+## 2. 실행 순서
+
+```bash
+cp frontend/.env.example frontend/.env.local
+docker compose up -d postgres
+
+dotnet restore KArtSell.sln
+dotnet run --project src/KArtSell.DbMigrator
+dotnet test KArtSell.sln
+dotnet run --project src/KArtSell.Host
+
+cd frontend
+pnpm install
+pnpm typecheck
+pnpm test
+pnpm build
+pnpm dev
+```
+
+Development 연구 Endpoint 호출 시 `X-KArtSell-User`, `X-KArtSell-Role=Quant`가 필요하다. Frontend는 `.env.local` 값이 있을 때 개발 환경에서만 해당 Header를 추가한다.
+
+## 3. 생산 전 필수 교체
+
+- DevelopmentHeader 인증을 승인된 OIDC/JWT 공급자로 교체.
+- Connection string과 secret를 vault/secret store로 이동.
+- OTLP endpoint, Telegram alert, SLO/Runbook 설정.
+- Source adapter 계약과 라이선스 승인.
+- pnpm lockfile과 Software Bill of Materials.
+
+## 4. 금지
+
+- `Capabilities:AutomaticOrder=true`.
+- `Capabilities:KisOrderAdapter=true`.
+- 실계좌/실주문 credential 저장.
+- Research Endpoint를 고객 화면에서 호출.