Skip to content

SPEC.md

Latest commit

 

History

History
188 lines (144 loc) · 4.92 KB

SPEC.md

File metadata and controls

188 lines (144 loc) · 4.92 KB

동료들 (AI Office) - 기능 명세서

버전: 1.0.0
작성일: 2026-02-18
플랫폼: Electron (macOS/Windows/Linux)

📌 개요

한동노무법인의 AI 팀원들이 화면에 상주하며 업무를 지원하는 데스크톱 앱. 각 캐릭터는 독립적인 전문성을 가지며, Claude API 또는 Clawdbot Gateway로 연결됨.

👥 AI 캐릭터 (5명)

이름 역할 전문 분야 말투 색상
김 변호사 법률 자문 노동법 소송, 부당해고 구제, 노동위원회 존댓말 #2C3E50
박 노무사 인사노무 컨설팅 취업규칙, 인사제도, 근로계약서 해요체 #8E44AD
오 지도사 산업안전 산안법, 중대재해법, 위험성평가 합쇼체 #E67E22
이 디자이너 브랜드 디자인 PPT, SNS, 마케팅 콘텐츠 반말(MZ) #E74C3C
정 세무사 세무/회계 4대보험, 급여정산, 퇴직금 존댓말 #27AE60

🖥️ 화면 구성

1. 위젯 (Widget)

  • 위치: 화면 하단 중앙
  • 크기: 720 x 185px
  • 특징: 투명 배경, 항상 위에 표시
  • 기능:
    • 5명의 캐릭터 아바타 표시
    • 상태 표시 (🟢 업무중 / 🟡 휴식중 / 🔴 휴가)
    • 클릭 시 대시보드 열기

2. 대시보드 (Dashboard)

  • 크기: 480 x 650px
  • 탭 구성:
    • 채팅: 1:1 대화
    • 페르소나: 성격/전문분야 설정
    • 능력/스킬: 능력치 바, 스킬 태그

3. 회의실 (Meeting)

  • 크기: 550 x 700px
  • 기능: 전체 캐릭터 토론
  • 설정: 회의 규칙, 응답 순서, 최대 응답자

4. 설정 (Settings)

  • 크기: 600 x 700px
  • 기능: 연결 모드, API 키, Clawdbot 설정

5. 트레이 메뉴

  • 위젯 보기
  • 대시보드 열기
  • 🏢 회의실
  • ⚙️ 설정
  • 캐릭터별 바로가기
  • 종료

🔌 연결 모드

API 모드 (기본)

  • Claude API 직접 호출
  • 모델: claude-sonnet-4-5-20250929
  • API 키 필요

Clawdbot 모드

  • Clawdbot Gateway 연결
  • 캐릭터별 개별 설정 가능
  • 설정 항목:
    • Gateway URL (예: http://localhost:3001)
    • 인증 토큰 (선택)
    • 세션 키 (기본: employee-{id})

🏢 회의실 기능

기본 동작

  1. 사용자가 메시지 입력
  2. 키워드 분석 → 관련 캐릭터 선정
  3. 선정된 캐릭터들이 순차 응답

키워드 매핑

캐릭터 키워드
김 변호사 법, 소송, 판례, 해고, 노동위, 구제
박 노무사 인사, 취업규칙, 근로계약, 인사제도
오 지도사 안전, 산재, 중대재해, 위험, 보건
이 디자이너 디자인, 마케팅, SNS, 브랜딩, PPT
정 세무사 세금, 세무, 4대보험, 급여, 퇴직금

회의 설정

  • 회의 규칙: 자유 텍스트 입력 (AI에게 전달)
  • 최대 응답자: 1~5명 (기본 3명)
  • 자동 선택: ON/OFF (키워드 기반)
  • 응답 순서: 드래그로 변경 가능

📎 파일 업로드

지원 형식

  • 🖼️ 이미지: JPEG, PNG, GIF, WebP
  • 📄 문서: PDF, DOC, TXT 등
  • 📝 텍스트 메모: 직접 입력

적용 범위

  • ✅ 개별 채팅 (대시보드)
  • ✅ 회의실

동작 방식

  1. 📎 버튼 클릭 → 첨부 메뉴
  2. 파일 선택 또는 텍스트 입력
  3. 미리보기에 표시 (삭제 가능)
  4. 메시지와 함께 전송
  5. AI에게 [첨부파일] 컨텍스트로 전달

💾 설정 저장

  • 위치: {userData}/config.json
  • 저장 항목:
    • 연결 모드 (api/clawdbot)
    • Anthropic API 키
    • 캐릭터별 Clawdbot 설정
    • 회의실 설정 (규칙, 응답순서, 최대응답자)

📁 파일 구조

동료들/
├── main.js              # Electron 메인 프로세스
├── preload.js           # IPC 브릿지
├── package.json         # 의존성
├── SPEC.md              # 이 문서
└── renderer/
    ├── index.html       # (미사용)
    ├── widget.html      # 하단 위젯
    ├── dashboard.html   # 대시보드/채팅
    ├── meeting.html     # 회의실
    ├── settings.html    # 설정
    ├── characters.js    # 캐릭터 SVG
    ├── app.js           # (레거시)
    └── style.css        # (레거시)

🚀 실행 방법

개발 모드

cd 동료들
npm install
npm start

빌드 (추후)

npm run build

🔮 향후 계획

  1. 맥 미니 배포 - 각 캐릭터별 Clawdbot 인스턴스
  2. 캐릭터 추가 - 새 전문가 추가 기능
  3. 히스토리 저장 - 대화 내역 영구 저장
  4. 알림 기능 - 캐릭터가 먼저 말 걸기
  5. 화면 공유 - 현재 화면 캡처 후 질문

📝 변경 이력

날짜 버전 내용
2026-02-18 1.0.0 최초 작성, Clawdbot 연결, 회의실, 파일 업로드