🤝 Project Collaboration

🚀 통합 생성 API (신규)

프로젝트 + 모든 관련 정보를 한 번에 생성합니다. (6번 요청 → 1번 요청)

POST /api/projects/full

{
  "project": {
    "name": "Meeting Server v2",
    "description": "AI 협업 플랫폼",
    "owner": "Kim & Claude",
    "status": "진행중"
  },
  "architecture": {
    "stack": "Node.js, Express, SQLite",
    "database": "SQLite with WAL mode",
    "infrastructure": "PM2, Nginx, SSH Tunnel"
  },
  "roadmap": {
    "phases": [
      {"week": 1, "goal": "SQLite 전환"},
      {"week": 2, "goal": "프론트엔드 개선"}
    ],
    "timeline": "2 weeks"
  },
  "decisions": [
    {
      "title": "SQLite 사용",
      "content": "KimDB 대신 SQLite 채택",
      "priority": "high"
    }
  ],
  "meetings": [
    {
      "title": "킥오프 미팅",
      "date": "2025-01-08",
      "participants": ["Kim", "Claude"],
      "summary": "프로젝트 시작"
    }
  ],
  "checklist": {
    "items": [
      {"task": "SQLite 설정", "priority": 1, "status": "completed"},
      {"task": "프론트엔드 개발", "priority": 2, "status": "pending"}
    ]
  }
}

📋 프로젝트 관리

GET    /api/projects               # 프로젝트 목록
POST   /api/projects               # 프로젝트 생성 (메타데이터 자동 추가)
GET    /api/projects/:id           # 프로젝트 상세
PUT    /api/projects/:id           # 프로젝트 전체 수정
PATCH  /api/projects/:id           # 프로젝트 부분 수정 (신규)
GET    /api/projects/:id/full      # 전체 정보 한 번에 조회 (신규)
GET    /api/projects/:id/stats     # 프로젝트 통계 (신규)

# 프로젝트 생성 시 자동 추가되는 메타데이터:
# - created_by: "Claude Sonnet 4.5"
# - server_location: "DESKTOP-CD5THBO"
# - status: "진행중"
# - created_at: timestamp

🔍 검색 API (신규)

GET /api/projects/search?q=키워드              # 키워드 검색
GET /api/projects/search?owner=Claude          # 담당자 필터
GET /api/projects/search?status=진행중          # 상태 필터
GET /api/projects/search?tags=AI,ML            # 태그 필터

# 예시
GET /api/projects/search?q=SQLite&status=완료

📊 통계 API (신규)

GET /api/projects/:id/stats

# 응답 예시
{
  "success": true,
  "stats": {
    "total_decisions": 3,
    "total_meetings": 2,
    "checklist_progress": "5/10 (50%)",
    "roadmap_progress": "2/4 phases",
    "last_updated": "2025-01-08T12:00:00Z"
  }
}

🔄 워크플로우 진행률 API (신규)

AI 작업의 5단계 진행 상황을 자동으로 판단합니다.

GET /api/projects/:id/workflow

# 5단계 워크플로우
1️⃣ 계획      → 프로젝트 생성
2️⃣ 플랜모드   → 아키텍처 + 로드맵
3️⃣ 구현      → 체크리스트 + 결정사항
4️⃣ 테스트    → "[테스트]" 노트
5️⃣ 완료      → status "완료" or "[완료]" 노트

# 응답 예시
{
  "success": true,
  "workflow": {
    "steps": [
      {
        "step": 1,
        "name": "계획",
        "status": "completed",
        "description": "프로젝트 생성"
      },
      {
        "step": 2,
        "name": "플랜모드",
        "status": "pending",
        "description": "아키텍처 + 로드맵 + 학습자료"
      },
      ...
    ],
    "progress": 60,              // 진행률 (%)
    "completed_steps": 3,        // 완료된 단계
    "total_steps": 5,            // 전체 단계
    "current_step": 2,           // 현재 단계
    "project_status": "구현중"   // 프로젝트 상태
  }
}

🏗️ 세부 항목 조회 (신규)

GET /api/projects/:id/architecture    # 아키텍처
GET /api/projects/:id/roadmap          # 로드맵
GET /api/projects/:id/decisions        # 결정사항 목록
GET /api/projects/:id/meetings         # 회의록 목록
GET /api/projects/:id/checklist        # 체크리스트

📝 Notes API (MD 파일 + Gogs 자동 업로드)

POST /api/projects/:id/notes
{
  "title": "API 설계 문서",
  "content": "# API 설계\n\n## 개요\n...",
  "auto_upload": true  // Gogs 자동 업로드 (기본값: true)
}

GET /api/projects/:id/notes              # 노트 목록
GET /api/projects/:id/notes/:noteId      # 특정 노트 조회

# Gogs 자동 업로드 기능:
# - Markdown 파일을 Gogs 저장소에 자동 커밋
# - gogs_url 필드에 링크 저장
# - comupload.ai-empire.kr API 사용

🔧 개별 항목 생성

POST /api/projects/:id/architecture
{
  "stack": "Node.js, Express",
  "database": "SQLite",
  "infrastructure": "PM2, Nginx"
}

POST /api/projects/:id/roadmap
{
  "phases": [{"week": 1, "goal": "개발"}],
  "timeline": "2 weeks"
}

POST /api/projects/:id/decisions
{
  "title": "기술 스택 결정",
  "content": "SQLite 사용",
  "priority": "high"
}

POST /api/projects/:id/meetings
{
  "title": "주간 회의",
  "date": "2025-01-08",
  "participants": ["Kim", "Claude"],
  "summary": "진행 상황 논의"
}

POST /api/projects/:id/checklist
{
  "items": [
    {"task": "DB 설정", "priority": 1, "status": "completed"}
  ]
}

✨ 스키마 자동 필터링 (AI 편의성 100%)

AI가 아무 필드나 넣어도 에러가 발생하지 않습니다!
모든 API 엔드포인트에서 자동으로 스키마 필터링이 적용되어, 허용된 필드만 저장되고 잘못된 필드는 자동으로 제거됩니다.

# 허용 필드 (테이블별)

projects: name, description, status, owner, tags, created_by, server_location
architecture: project_id, stack, database, infrastructure, diagram
roadmap: project_id, phases
decisions: project_id, title, content, rationale
meetings: project_id, date, participants, agenda, summary
checklist: project_id, items
notes: project_id, title, content, filename, gogs_url

# 자동 제거되는 예시 필드
❌ decisions: priority, decided_by, decided_at, impact, status
❌ meetings: title, action_items, attendees
❌ roadmap: milestones, timeline, duration
❌ projects: 임의의 필드

# 사용 예시
POST /api/projects/123/decisions
{
  "title": "JWT 사용",
  "content": "stateless 인증",
  "priority": 1,           // ← 자동 제거됨 (로그 기록)
  "decided_by": "Kim",     // ← 자동 제거됨 (로그 기록)
  "impact": "high",        // ← 자동 제거됨 (로그 기록)
  "anything": "ignored"    // ← 자동 제거됨 (로그 기록)
}

# 결과: 에러 없이 성공! (title, content만 저장됨)
# 로그: [Schema Filter] decisions: 제거된 필드 → priority, decided_by, impact, anything

# 배열 필드 자동 변환
phases: "string"      → ["string"]    (자동 변환)
phases: {...}         → [{...}]       (자동 변환)
items: {...}          → [{...}]       (자동 변환)
participants: "Kim"   → ["Kim"]       (자동 변환)

⚡ 성능 개선

• SQLite WAL 모드: 동시 읽기/쓰기 성능 향상
• 통합 API: 6번 요청 → 1번 요청 (네트워크 비용 절감)
• PATCH 지원: 필요한 필드만 부분 업데이트
• 인덱싱: project_id 기반 빠른 조회
• 스키마 필터링: 잘못된 필드 자동 제거 (100% AI 편의성)

🔗 접속 정보

도메인: https://meeting2.dclub.kr
로컬:   http://localhost:50400
헬스:   /health

서버: 회사 WSL (DESKTOP-CD5THBO)
DB:   SQLite (data/meeting.db)
PM2:  meeting-v2