---
name: signit-v2
description: Signit v2 전체 프로젝트 팀. 기획부터 배포까지 전 단계를 담당하는 풀스택 팀입니다. Edge/Cloud/Mobile 3계층 IoT 플랫폼 개발 및 운영.
---

# Signit v2 팀 구성

## 팀 개요

스마트팜 IoT 통합 관리 플랫폼(Signit v2) 개발 팀.
Edge(농가 현장) + Cloud(AWS) + Mobile 3계층 구조.

## 팀원 (Agents)

### 리드
- **tech-lead**: 기술 방향 결정, 역할 간 조율, 아키텍처 최종 승인, 리스크 관리

### 기획/설계
- **product-planner**: 기능 기획, 요구사항 분석, 사용자 스토리 작성
- **system-architect**: 전체 시스템 설계, API 계약, MQTT 토픽 설계
- **db-architect**: DB 스키마 설계, Alembic 마이그레이션, 인덱스/쿼리 최적화
- **security-architect**: 보안 아키텍처 설계, JWT 흐름, 암호화 전략

### 개발
- **python-pro** (user_backend, manager_backend): FastAPI 백엔드 개발
- **flutter-expert** (user_frontend, mobile): Flutter UI 개발
- **frontend-developer** (user_frontend): Flutter Web 현장 UI 개발
- **ui-ux-designer**: 웹 UI/UX 설계 (Edge 현장 UI, 관리자 페이지)
- **mobile-ui-ux-designer** (mobile): 모바일 앱 UI/UX (iOS/Android 패턴)

### 품질/보안
- **code-reviewer**: 코드 리뷰, 품질 검토
- **qa-engineer**: 테스트 케이스 설계, 오프라인 시나리오 검증, 버그 리포트
- **test-engineer**: 테스트 자동화 코드 작성, CI/CD 파이프라인, 부하 테스트
- **security-auditor**: 구현 코드 보안 점검, 취약점 분석, 보안 리포트
- **performance-engineer**: 성능 프로파일링, Edge 리소스 최적화, 응답 시간 튜닝

### 운영/문서
- **doc-writer**: 문서 작성 (md/xlsx/pptx/docx 형식별 목적에 맞게)

---

## 워크플로우

### 신규 기능 개발 플로우

```
1. product-planner      → 기능 정의서, 사용자 스토리
2. tech-lead            → 기술 방향 검토, 트레이드오프 결정
3. system-architect     → API 계약, 서비스 흐름 설계
4. db-architect         → DB 스키마, 마이그레이션 계획
5. security-architect   → 보안 요소 설계 (인증/인가/암호화)
6. ui-ux-designer       → 화면 설계 (웹)
   mobile-ui-ux-designer → 화면 설계 (모바일, 해당 시)
7. python-pro           → Backend 구현
8. flutter-expert       → Frontend/Mobile 구현
9. code-reviewer        → 코드 리뷰
10. test-engineer       → 자동화 테스트 작성
11. qa-engineer         → 테스트 케이스 검증 (오프라인 시나리오 포함)
12. security-auditor    → 보안 점검
13. performance-engineer → 성능 검증 (Edge 기준)
14. doc-writer          → 문서 업데이트 (md/xlsx/pptx/docx)
```

### 버그 수정 플로우

```
1. qa-engineer          → 버그 리포트, 재현 절차
2. tech-lead            → 우선순위 결정
3. python-pro /         → 수정 구현
   flutter-expert
4. code-reviewer        → 변경사항 리뷰
5. test-engineer        → 회귀 테스트 추가
6. qa-engineer          → 검증
7. doc-writer           → CHANGELOG 업데이트
```

### 보안/성능 이슈 대응 플로우

```
보안 이슈:
1. security-auditor     → 취약점 발견 및 리포트
2. security-architect   → 수정 방향 설계
3. tech-lead            → 우선순위 및 영향도 결정
4. python-pro           → 수정 구현
5. security-auditor     → 수정 검증

성능 이슈:
1. performance-engineer → 프로파일링, 병목 분석
2. db-architect         → 쿼리/인덱스 최적화 (DB 관련 시)
3. python-pro /         → 코드 최적화 구현
   flutter-expert
4. performance-engineer → 개선 검증 (Edge 기준 달성 여부)
```

---

## 서브 프로젝트 담당 Agent 매핑

| 프로젝트 | 주담당 Agent | 보조 Agent |
|---------|------------|-----------|
| signit_v2_user_backend | python-pro, debugger | db-architect, performance-engineer |
| signit_v2_user_frontend | flutter-expert, frontend-developer | ui-ux-designer |
| signit_v2_manager_backend | python-pro, debugger | db-architect, system-architect |
| signit_v2_mobile | flutter-expert, debugger | mobile-ui-ux-designer |
| signit_v2_frp | — | security-architect, security-auditor |

---

## 문서 형식 규칙

| 형식 | 용도 |
|------|------|
| `.md` | 개발자용 (아키텍처, README, CLAUDE.md) |
| `.xlsx` | API 명세서, 테스트 케이스 |
| `.pptx` | 사용자/현장 매뉴얼 |
| `.docx` | 운영 가이드, 보안 정책, 설치 가이드 |

## 작업 승인 규칙

- **Read/Add**: 확인 불필요
- **Update/Delete**: 사용자 확인 필요 + CHANGELOG 기록