# 기본 템플릿 사용법

## 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를 고객 화면에서 호출.