David Brain

서버 개발

7 min read

ID: key_26_22_05_25_16_01_00_00000 Created date: 5월 25 2026 월요일, 22주 16:01

연관 문서

Index > 개발 아이템 정리 Jira 기능 정리

서버 개발 개발 아이템

Phase 1: 핵심 API 개발 (필수 구현)

1. 인증/인가 시스템

  • 관련 기능: 시스템 공통 및 아키텍처, 권한 및 보안
  • 개발 항목:
    • JWT 기반 토큰 발급 및 검증
    • 로그인/로그아웃 API (POST /api/v1/auth/login, POST /api/v1/auth/logout)
    • 사용자 등록 API (POST /api/v1/auth/register)
    • 토큰 리프레시 (POST /api/v1/auth/refresh)
    • 사용자 정보 조회 (GET /api/v1/users/me)
    • RBAC(Role-Based Access Control) 미들웨어

2. 이슈 관리 API (CRUD)

  • 관련 기능: 이슈 및 업무 관리 모듈
  • 개발 항목:
    • 이슈 생성 (POST /api/v1/projects/{projectId}/issues)
    • 이슈 조회 (GET /api/v1/issues/{issueId})
    • 이슈 목록 조회 (GET /api/v1/projects/{projectId}/issues)
    • 이슈 수정 (PUT /api/v1/issues/{issueId})
    • 이슈 삭제 (DELETE /api/v1/issues/{issueId})
    • 이슈 필터링 (프로젝트, 상태, 담당자, 우선순위 기반)

3. 워크플로우 상태 관리

  • 관련 기능: 맞춤형 워크플로우 및 상태 전이 엔진
  • 개발 항목:
    • 이슈 상태 변경 (PUT /api/v1/issues/{issueId}/status)
    • 상태 전이 검증 로직 (정의된 워크플로우 규칙 확인)
    • 상태 변경 이력 기록 (issue_logs 테이블)
    • 상태 변경 시 타임스탬프 갱신

4. 프로젝트 및 스프린트 관리

  • 관련 기능: 프로젝트 & 스프린트 관리 모듈
  • 개발 항목:
    • 프로젝트 생성/조회/수정 API
    • 스프린트 생성 (POST /api/v1/projects/{projectId}/sprints)
    • 스프린트 시작/종료 API
    • 백로그 이슈 우선순위 업데이트
    • 스프린트에 이슈 할당 (PUT /api/v1/issues/{issueId}/sprint)
    • 속도(Velocity) 계산 로직

5. 칸반 보드 API

  • 관련 기능: 칸반 보드
  • 개발 항목:
    • 보드 조회 (GET /api/v1/projects/{projectId}/board)
    • 이슈 위치 업데이트 (PUT /api/v1/issues/{issueId}/position) - Lexorank 기반
    • WIP 제한 검증
    • 실시간 업데이트 (WebSocket)

6. 댓글 API

  • 관련 기능: 협업 및 커뮤니케이션 모듈
  • 개발 항목:
    • 댓글 작성 (POST /api/v1/issues/{issueId}/comments)
    • 댓글 조회 (GET /api/v1/issues/{issueId}/comments)
    • 댓글 수정 (PUT /api/v1/comments/{commentId})
    • 댓글 삭제 (DELETE /api/v1/comments/{commentId})
    • 멘션(@) 처리 및 알림 발송

7. 파일 업로드 (첨부)

  • 관련 기능: 이슈 첨부 파일
  • 개발 항목:
    • 파일 업로드 API (POST /api/v1/issues/{issueId}/attachments)
    • S3/Cloud Storage 연동
    • 파일 다운로드 API
    • 파일 삭제 API

Phase 2: 고급 기능 API (추후 구현)

1. Git Webhook 처리

  • 관련 기능: 외부 서비스 연동 (Git Integration)
  • 개발 항목:
    • Webhook 엔드포인트 (POST /api/v1/webhooks/git)
    • 커밋 메시지 파싱 (정규식)
    • 스마트 커밋 명령어 처리 (#comment, #resolve, #close)
    • PR 상태 동기화

2. 자동화 엔진

  • 관련 기능: 워크플로우 자동화 엔진
  • 개발 항목:
    • 자동화 규칙 생성/조회/수정 API
    • 이벤트 기반 트리거 (RabbitMQ/Redis BullMQ)
    • 자동화 워커 (Action 실행)
    • 무한 루프 방지 로직

3. 예산 및 시간 추적

  • 관련 기능: 프로젝트 예산 관리 모듈
  • 개발 항목:
    • 시간 기록 API (POST /api/v1/issues/{issueId}/time-logs)
    • 지출 기록 API (POST /api/v1/projects/{projectId}/expenses)
    • 예산 대시보드 데이터 조회
    • 예산 소진 예측 계산

4. 고급 검색 (JQL)

  • 관련 기능: 검색 & 필터링 모듈
  • 개발 항목:
    • JQL 쿼리 파서 및 실행 엔진
    • 저장된 필터 API
    • 검색 인덱싱 (Elasticsearch)
    • 자동완성 API (GET /api/v1/autocomplete)

5. 알림 시스템

  • 관련 기능: 알림 및 이력 관리 시스템
  • 개발 항목:
    • 알림 발송 API (인앱, 이메일, Slack)
    • WebSocket 기반 실시간 알림
    • 알림 설정 API
    • 디바운싱(Debouncing) 구현

6. Wiki/문서 API

  • 관련 기능: 업무 지식 정리 모듈
  • 개발 항목:
    • 문서 생성/조회/수정 API
    • 계층 구조(Tree) 관리
    • 마크다운 파싱
    • 이슈 임베드 및 백링크 관리

7. 대시보드 데이터 API

  • 관련 기능: 대시보드 및 리포팅 모듈
  • 개발 항목:
    • 위젯 데이터 조회 API
    • 번다운 차트 데이터
    • 속도 리포트 데이터
    • CFD(누적 흐름) 데이터

8. 버전 및 마일스톤 API

  • 관련 기능: 버전 및 마일스톤 관리 모듈
  • 개발 항목:
    • 버전 생성/조회/수정 API
    • 마일스톤 생성/조회/수정 API
    • 릴리스 노트 자동 생성
    • 버전 상태 전이

9. 사용자 관리 API

  • 관련 기능: 사용자 관리 모듈
  • 개발 항목:
    • 사용자 초대 API
    • 그룹/팀 생성 및 관리 API
    • 사용자 프로필 수정 API
    • API 토큰 관리

서버 기술 스택 고려사항

주요 기술

  • 프레임워크: Node.js + Express / Python + FastAPI / Java + Spring Boot
  • 실시간: WebSocket (Socket.io / native WebSocket)
  • 메시지 큐: RabbitMQ / Redis (자동화 엔진용)
  • 캐싱: Redis (세션, 쿼리 캐싱)
  • 검색: Elasticsearch
  • 파일 저장: AWS S3 / GCS / MinIO

주요 설계 원칙

  1. RESTful API: 표준 HTTP 메서드 준수
  2. 에러 처리: 일관된 에러 응답 포맷
  3. 로깅 및 모니터링: 모든 작업 로깅
  4. 성능: API 응답 시간 < 500ms 목표
  5. 보안: 입력 검증, SQL 인젝션 방지, CORS 설정

연관 메일

Graph View

Backlinks