Files
KArtSell.Aegis/docs/v12/12_TEMPLATE_USAGE.md
T
kjh2064 dcd1322d41
ci / backend (push) Failing after 12s
ci / frontend (push) Failing after 19s
ci / static (push) Failing after 45s
Initial commit: Add project files
2026-08-02 05:15:36 +09:00

1.3 KiB

기본 템플릿 사용법

1. 사전 준비

  • .NET SDK 10.0.100 이상.
  • Node.js 22.
  • pnpm 10.
  • PostgreSQL 17.

현재 패키지에는 registry 접근이 불가능한 환경에서 생성되었으므로 pnpm-lock.yaml이 없다. 네트워크가 가능한 승인 환경에서 한 번 생성하고 dependency review 후 커밋한다.

2. 실행 순서

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