docs(ai-character): 리소스 관리 문서 정리
This commit is contained in:
@@ -1,7 +1,7 @@
|
||||
# 환경 변수
|
||||
|
||||
- 개발 서버 API: `VITE_API_BASE_URL=https://test-character-admin.sodalive.net`
|
||||
- 프로덕션 서버 API: `VITE_API_BASE_URL=https://character-admin.sodalive.net`
|
||||
- 개발 서버 API: `VITE_API_BASE_URL=https://test-api.sodalive.net`
|
||||
- 프로덕션 서버 API: `VITE_API_BASE_URL=https://api.sodalive.net`
|
||||
- API mode: `VITE_API_MODE=server | mock`. 누락 시 `server`이며, `mock`은 개발 환경에서만 허용한다.
|
||||
- Vite mode별 파일은 `.env.development`, `.env.production`을 사용한다.
|
||||
- 기본 `npm run dev`는 `server` mode로 실제 개발 API를 사용하고, `npm run dev:mock`만 browser MSW를 시작한다.
|
||||
|
||||
@@ -12,7 +12,8 @@
|
||||
- 대상 `prd.md`와 `plan-task.md`가 있는 기능 문서 디렉터리 아래 `reviews/`를 만들고 모든 리뷰 문서를 그 안에 둔다.
|
||||
- 리뷰 문서를 기능 문서 디렉터리 바로 아래나 단수형 `review/`에 두지 않는다. 여러 Phase·Task 리뷰가 생겨도 같은 `reviews/`에 누적한다.
|
||||
- [코드 리뷰 보고서 샘플](../sample/sample-review.md)을 원본 템플릿으로 사용하고, section·필드·상태 의미를 임의로 축소하지 않는다.
|
||||
- 실제 리뷰 문서 파일명은 범위가 드러나게 작성한다. 예: `review-phase-0-1.md`, `review-auth.md`.
|
||||
- 새로 생성하는 리뷰 문서 파일명은 `phase<번호>-<구현 내용을 나타내는 영문 kebab-case>.md` 패턴을 사용한다. `phase`와 번호 사이에는 하이픈을 넣지 않는다. 예: `phase1-character-management.md`, `phase2-audio-content.md`.
|
||||
- 이 파일명 규칙은 새 리뷰 문서에만 적용한다. 이미 생성된 리뷰 문서는 이름과 기존 참조 링크를 변경하지 않는다.
|
||||
- `prd.md`나 `plan-task.md`에서 리뷰 문서를 참조할 때는 `./reviews/<리뷰 파일명>.md` 상대 링크를 사용한다.
|
||||
|
||||
## 3. 리뷰 수행 원칙
|
||||
|
||||
@@ -10,6 +10,6 @@
|
||||
- Vitest watch: `npm run test`
|
||||
- Vitest 단발 실행: `npm run test:run`
|
||||
- Playwright E2E(server mode): `npm run e2e`는 `playwright.config.ts`의 server mode `testMatch`에 있는 spec만 실행하며, 추가 file filter를 넘기면 교집합만 실행한다.
|
||||
- Playwright E2E(mock mode): `npm run e2e:mock`은 `playwright.config.ts`의 mock mode `testMatch`에 있는 spec만 실행하며, 추가 file filter를 넘기면 교집합만 실행한다.
|
||||
- Playwright E2E(mock mode): `npm run e2e:mock`은 인자 없이 실행하면 Chromium/mobile Chrome matrix를 분할 실행하며, file filter나 `--project` 인자를 넘기면 `playwright.config.ts`의 mock mode `testMatch`와 교집합만 실행한다.
|
||||
- Mock preview domain rule: 후속 도메인 Phase는 자기 handler, fixture, mock E2E를 같은 Phase에서 소유하고 추가한다.
|
||||
- Phase 0 Gate 기준: `npm ci`, `npx playwright install chromium webkit`, `npm run typecheck`, `npm run lint`, `npm run test:run -- src/app/App.test.tsx src/shared/config/env.test.ts`, `npm run e2e -- tests/e2e/smoke.spec.ts`, `npm run build:dev`, `npm run build:prod`
|
||||
- Phase 0 Gate 기준: `npm ci`, `npx playwright install chromium`, `npm run typecheck`, `npm run lint`, `npm run test:run -- src/app/App.test.tsx src/shared/config/env.test.ts`, `npm run e2e -- tests/e2e/smoke.spec.ts`, `npm run build:dev`, `npm run build:prod`
|
||||
|
||||
Reference in New Issue
Block a user