feat(manifest): ModuleManifest에 repository·author 필드 추가

마켓플레이스 상세 페이지에서 GitHub README 표시 및 제작자 정보를
저장할 수 있도록 module.json 스펙을 확장한다.
author는 npm package.json 관례(string | { name, email, url })를 따른다.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: SOIV

CLAUDE.md

@@ -51,6 +51,8 @@ packages/
 modules/   — Phase 2 모듈 (Ledger, Subscription) 위치 예정
 ```
 
+**모듈 템플릿**: `D:\5. Development\A. Project\Fieldstack-Project\module-template` (WSL: `/mnt/d/5. Development/A. Project/Fieldstack-Project/module-template`) — 프로젝트 루트 외부에 별도 존재. `module.json` 스펙 변경 시 함께 업데이트.
+
 pnpm workspace, `node-linker=hoisted`.
 
 ### apps/web — 라우팅 & 상태

apps/api/src/loader/index.ts

@@ -6,6 +6,12 @@ export interface ModuleRoutes {
   api: string;
 }
 
+export interface ModuleAuthor {
+  name?: string;
+  email?: string;
+  url?: string;
+}
+
 export interface ModuleManifest {
   name: string;
   displayName: string;
@@ -14,6 +20,8 @@ export interface ModuleManifest {
   enabled: boolean;
   dependencies: string[];
   routes: ModuleRoutes;
+  repository?: string;
+  author?: ModuleAuthor | string;
 }
 
 export interface BackendRouteRegistration {
@@ -48,6 +56,8 @@ export function parseModuleJson(content: string): ModuleManifest {
       frontend: parsed.routes?.frontend ?? "",
       api: parsed.routes?.api ?? "",
     },
+    ...(parsed.repository !== undefined && { repository: parsed.repository }),
+    ...(parsed.author !== undefined && { author: parsed.author }),
   };
 }
 

apps/web/src/loader/index.ts

@@ -3,12 +3,20 @@ export interface ModuleRoutes {
   api: string;
 }
 
+export interface ModuleAuthor {
+  name?: string;
+  email?: string;
+  url?: string;
+}
+
 export interface ModuleManifest {
   name: string;
   version: string;
   enabled: boolean;
   dependencies: string[];
   routes: ModuleRoutes;
+  repository?: string;
+  author?: ModuleAuthor | string;
 }
 
 export interface FrontendRouteRegistration {
@@ -34,6 +42,8 @@ export function parseModuleJson(content: string): ModuleManifest {
       frontend: parsed.routes?.frontend ?? "",
       api: parsed.routes?.api ?? "",
     },
+    ...(parsed.repository !== undefined && { repository: parsed.repository }),
+    ...(parsed.author !== undefined && { author: parsed.author }),
   };
 }
 

docs/v2_FINANCIAL-LEDGER/architecture/04-directory-structure.md

@@ -312,15 +312,18 @@ modules/[module-name]/
   "version": "1.0.0",
   "displayName": "가계부",
   "description": "수입/지출 관리",
-  "icon": "💰",
-  "category": "finance",
+  "enabled": true,
+  "dependencies": [],
   "routes": {
     "frontend": "/ledger",
     "api": "/api/ledger"
   },
-  "permissions": ["db:read", "db:write"],
-  "dependencies": [],
-  "enabled": true
+  "repository": "https://github.com/author/module-ledger",
+  "author": {
+    "name": "작성자 이름",
+    "email": "author@example.com",
+    "url": "https://example.com"
+  }
 }
 ```
 
@@ -330,29 +333,29 @@ modules/[module-name]/
 
 문서 폴더
 
-```
-docs/
-├── README.md                     # 문서 인덱스
-├── architecture/                 # 아키텍처 문서
-│   ├── 00-overview.md
-│   ├── 01-decisions.md
-│   ├── 02-core-principles.md
-│   ├── 03-resilience-operations.md
-│   └── 04-directory-structure.md
-├── technical/                    # 기술 문서
-│   ├── 00-tech-stack.md
-│   ├── 01-database.md
-│   └── 03-ai-integration.md
-├── modules/                      # 모듈 문서
-│   ├── 03-system-design.md
-│   └── 01-development-guide.md
-├── deployment/                   # 배포 문서
-│   ├── 01-installation.md
-│   └── 02-setup-wizard.md
-└── community/                    # 커뮤니티 문서
-    ├── 00-philosophy.md
-    └── 01-contributing.md
-```
+```
+docs/
+├── README.md                     # 문서 인덱스
+├── architecture/                 # 아키텍처 문서
+│   ├── 00-overview.md
+│   ├── 01-decisions.md
+│   ├── 02-core-principles.md
+│   ├── 03-resilience-operations.md
+│   └── 04-directory-structure.md
+├── technical/                    # 기술 문서
+│   ├── 00-tech-stack.md
+│   ├── 01-database.md
+│   └── 03-ai-integration.md
+├── modules/                      # 모듈 문서
+│   ├── 03-system-design.md
+│   └── 01-development-guide.md
+├── deployment/                   # 배포 문서
+│   ├── 01-installation.md
+│   └── 02-setup-wizard.md
+└── community/                    # 커뮤니티 문서
+    ├── 00-philosophy.md
+    └── 01-contributing.md
+```
 
 ---
 
@@ -407,4 +410,4 @@ services:
 - **camelCase**: 예외적으로 React 컴포넌트 폴더
 
 ### 모듈
-- **kebab-case**: ledger, subscription, crypto-tracker
+- **kebab-case**: ledger, subscription, crypto-tracker

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

@@ -41,13 +41,21 @@ modules/{name}/
   "routes": {
     "frontend": "/my-module",
     "api": "/api/my-module"
+  },
+  "repository": "https://github.com/author/module-my-module",
+  "author": {
+    "name": "작성자 이름",
+    "email": "author@example.com",
+    "url": "https://example.com"
   }
 }
 ```
 
 - `displayName` → 사이드바에 자동 표시 (API 경유)
 - `enabled: false` → 서버 시작 시 완전히 무시
 - `routes.api` → Express 라우터 마운트 경로
+- `repository` → 마켓플레이스 상세 페이지에서 GitHub README 표시에 사용 (선택)
+- `author` → npm `package.json` 관례. `string` 또는 `{ name, email, url }` 객체 모두 허용 (선택)
 
 ---
 

modules/ledger/module.json

@@ -5,6 +5,12 @@
   "description": "ledger:description",
   "enabled": true,
   "dependencies": [],
+  "repository": "",
+  "author": {
+    "name": "",
+    "email": "",
+    "url": ""
+  },
   "routes": {
     "frontend": "/ledger",
     "api": "/api/ledger"

packages/core/src/types/index.ts

@@ -20,12 +20,20 @@ export interface ModuleRoutes {
   api: string;
 }
 
+export interface ModuleAuthor {
+  name?: string;
+  email?: string;
+  url?: string;
+}
+
 export interface ModuleManifest {
   name: string;
   version: string;
   enabled: boolean;
   dependencies: string[];
   routes: ModuleRoutes;
+  repository?: string;
+  author?: ModuleAuthor | string;
 }
 
 export interface IntegrationConfig {