docs: 1.4 기준 OpenAPI/가이드/체크리스트 동기화

Author: SOIV

TODO.md

@@ -30,15 +30,17 @@ Source: `docs/v2_FINANCIAL-LEDGER/roadmap/01-development-plan.md`
 
 ## 1.4 Test & Docs
 
-- [ ] Unit tests (Vitest)
-- [ ] Integration tests
-- [ ] OpenAPI docs baseline
-- [ ] Developer guide updates
-- [ ] README sync with implementation
+- [x] Unit tests (Vitest)
+- [x] Integration tests
+- [x] OpenAPI docs baseline
+- [x] Developer guide updates
+- [x] README sync with implementation
 
 ## Phase 1 Milestone Checks
 
-- [ ] Core layer completed
-- [ ] Module loader working
+- [x] Core layer completed
+- [x] Module loader working
 - [ ] Coverage > 70%
-- [ ] Documentation complete
+- [x] Documentation complete
+
+Coverage note: current baseline coverage is below 70% and requires additional test expansion.

docs/v2_FINANCIAL-LEDGER/README.md

@@ -104,6 +104,7 @@ pnpm start
 - [🤖 AI 통합](technical/03-ai-integration.md)
 - [🔐 인증](technical/02-authentication.md)
 - [⏰ Scheduler](technical/04-scheduler.md)
+- [📘 OpenAPI Baseline](technical/05-openapi-baseline.yaml)
 
 ### 모듈 개발
 - [📦 모듈 시스템](modules/03-system-design.md)

docs/v2_FINANCIAL-LEDGER/modules/01-development-guide.md

@@ -243,10 +243,16 @@ module-registry 저장소에 PR 제출
 - 📖 `architecture/00-overview.md § Module Layer` - 모듈 레이어 설명
 - 📖 `architecture/04-directory-structure.md` - 디렉터리 구조
 
-### 기술
-- 📖 `technical/01-database.md` - DB 추상화 레이어
-- 📖 `technical/04-scheduler.md` - Scheduler 사용법
-- 📖 `modules/02-integrations.md` - 외부 서비스 통합
+### 기술
+- 📖 `technical/01-database.md` - DB 추상화 레이어
+- 📖 `technical/04-scheduler.md` - Scheduler 사용법
+- 📖 `technical/05-openapi-baseline.yaml` - OpenAPI baseline
+- 📖 `modules/02-integrations.md` - 외부 서비스 통합
+
+### 테스트 베이스라인 (Phase 1.4)
+- Vitest 기반 단위 테스트는 `packages/core/src/**/*.test.ts`에 추가합니다.
+- API 통합 스모크 테스트는 `apps/api/src/integration/*.test.ts`에 추가합니다.
+- 모듈 로더 계약 검증은 `apps/api/src/loader/index.test.ts`를 기준으로 확장합니다.
 
 ### UI
 - 📖 `ui/01-core-components.md` - Core UI 컴포넌트
@@ -269,4 +275,4 @@ module-registry 저장소에 PR 제출
 
 > 💬 **도움이 필요하신가요?**  
 > → Discord: https://discord.gg/5m4aHKmWgg
-> → GitHub Discussions: https://github.com/.../discussions
+> → GitHub Discussions: https://github.com/.../discussions

docs/v2_FINANCIAL-LEDGER/roadmap/01-development-plan.md

@@ -92,9 +92,9 @@ Fieldstack/
 #### 1.4 테스트 & 문서
 **예상 기간: 2주**
 
-- [ ] 단위 테스트 (Vitest)
-- [ ] 통합 테스트
-- [ ] API 문서 (OpenAPI) (설계 완료)
+- [x] 단위 테스트 (Vitest)
+- [x] 통합 테스트
+- [x] API 문서 (OpenAPI) (설계 완료)
 - [x] 개발자 가이드
 - [x] README 작성
 

docs/v2_FINANCIAL-LEDGER/technical/05-openapi-baseline.yaml

@@ -0,0 +1,45 @@
+openapi: 3.1.0
+info:
+  title: Fieldstack API Baseline
+  version: 0.1.0
+  description: |
+    Phase 1.4 baseline OpenAPI document.
+    This file defines minimal health/module endpoints to bootstrap API documentation workflow.
+servers:
+  - url: http://localhost:3000
+paths:
+  /api/health:
+    get:
+      summary: Health check
+      operationId: getHealth
+      responses:
+        "200":
+          description: Service is healthy
+          content:
+            application/json:
+              schema:
+                type: object
+                properties:
+                  status:
+                    type: string
+                    example: ok
+  /api/modules:
+    get:
+      summary: List enabled modules
+      operationId: listModules
+      responses:
+        "200":
+          description: Enabled module list
+          content:
+            application/json:
+              schema:
+                type: array
+                items:
+                  type: object
+                  properties:
+                    name:
+                      type: string
+                    version:
+                      type: string
+                    enabled:
+                      type: boolean