47 lines
1.3 KiB
Markdown
47 lines
1.3 KiB
Markdown
# 기본 템플릿 사용법
|
|
|
|
## 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를 고객 화면에서 호출.
|