업무와 관련하여 사용하는 툴 (Jira, Monday, Google Calendar...) 각각에서 생성/활용 중인 데이터를 하나로 통합하여 손쉽게 관리하기 위한 솔루션
- Language: Java 17
- Build Tool: Gradle 8.7
- Framework: Spring Boot 3.2.4
- Database: PostgreSQL
- Spring Boot (https://spring.io/projects/spring-boot)
- Spring Batch (https://spring.io/projects/spring-batch)
- Spring Data JPA (https://spring.io/projects/spring-data-jpa)
- PostgreSQL JDBC Driver (https://jdbc.postgresql.org/)
- Spring Web (https://docs.spring.io/spring-framework/reference/web/webmvc.html)
- Spring Webflux (https://docs.spring.io/spring-framework/reference/web/webflux.html)
- Lombok (https://projectlombok.org/)
- Jackson (https://github.com/FasterXML/jackson)
- Quartz (https://www.quartz-scheduler.org/)
- GraphQL Spring Web Client (https://github.com/graphql-java-kickstart/graphql-spring-webclient)
- Atlassian ADF (Atlassian Document Format) Builder (https://bitbucket.org/atlassian/adf-builder-java/wiki/Home)
아래 환경변수를 등록한다.
- MONDAY_API_KEY (Monday API Key)
- JIRA_SITE_URL (Jira Cloud Site URL)
- JIRA_AUTH_EMAIL (Jira Cloud API 토큰 발급 사용자 이메일)
- JIRA_API_TOKEN (Jira Cloud API Token)
- 모든 데이터 동기화
- GET /jira/
- 사용자별 평균 1차 응답 시간 분석 API
GET /response-time?projectId=?&responseTimeUnit=?&targetDate=?- Query
projectId: 조회 대상 DB 내부 Project IDresponseTimeUnit: 응답 시간을 계산할 범위- ALL (전체), MONTHLY (월별), WEEKLY (주별), DAILY (일별)
targetDate: 기준 날짜 (ex:2024-05-27)
- 사용자별 데드라인 미준수 작업 개수 분석 API
GET /deadline-exceeded?projectId=?&includeParentIssue=?- Query
projectId: 조회 대상 DB 내부 Project IDincludeParentIssue: 최상위 이슈 포함 여부 (true/false)
- Jira Webhook 연결 API
- POST /jira/webhook
- Jira 조직에 Webhook 연동을 통하여 실시간 유저/이슈/댓글 동기화
- 연동 정보 등록
- POST /monday/register
- 사용자별 평균 1차 응답 시간 분석 API
- GET /monday/respones-time
- 사용자별 데드라인 미준수 작업 개수 분석 API
- GET /expired-item
- 사용자별 댓글, 업데이트 변경 횟수 분석 API
- GET /number-of-changes
- 실시간 웹훅 처리
- 업데이트, 댓글 생성 및 수정 실시간 반영
- 작업, 유저, 보드 1일 주기 데이터 동기화 (배치)
- 사용자별 평균 1차 응답 시간 한달, 일주일, 하루 간격 계산 및 DB 저장 (배치)
- src: 소스코드 폴더
- main: 메인 패키지
- resources: 리소스
- application.yml: 애플리케이션 관련 전반적인 기본 설정 정보
- java: Java 클래스
- com.pbl.tasktoolintegration: 솔루션 백엔드 메인 패키지
- jira: Jira 연동 관련 패키지
- common: Jira 관련 공통 사용 클래스를 모아둔 패키지
- config: Jira 관련 각종 설정 클래스를 모아둔 패키지
- converter: Jira 관련 컨버팅 클래스를 모아둔 패키지
- ADFDeserializer: Atlassian Document Format을 Jackson에서 Deserializing 하기 위한 로직을 작성한 클래스
- AsyncConfig: Async Thread 설정 클래스
- JiraConfiguration: Jira 관련 각종 Configuration 및 Bean 등록을 위한 클래스
- RequestLoggingFilterConfig: 서버로 들어오는 Request 로깅을 위한 필터 Configuration 클래스
- WebConfig: Spring Web MVC Configuration 클래스
- config: Jira 관련 각종 설정 클래스를 모아둔 패키지
- entity: Jira 관련 DB Entity 패키지
- model: Jira 관련 모델 패키지
- dto: Jira 관련 Data Transfer Object 패키지
- request: Jira 관련 REST API 호출 시 사용하는 Request Body Object 패키지
- repository: Jira 관련 Spring Data JPA Repository
- JiraConstants: Jira 관련 상수 모음 클래스
- JiraController: Jira 관련 API Endpoint를 설정하는 클래스
- JiraService: Jira 관련 비즈니스 로직을 작성하는 클래스
- common: Jira 관련 공통 사용 클래스를 모아둔 패키지
- monday: Monday 연동 관련 패키지
- config: Monday 관련 각종 설정 클래스를 모아둔 패키지
- ObjectMapperConfig: Jackson ObjectMapper Configuration 클래스
- WebClientConfig: Monday 관련 API 호출을 위한 WebClient Configuration 클래스
- entity: Monday 관련 DB Entity 패키지
- exception: Monday 관련 Exception 패키지
- model: Monday 관련 Model 패키지
- dto: Monday 관련 Data Transfer Object 패키지
- mondayProperty: Monday 관련 Property Model 패키지
- request: Monday 관련 REST API 호출 시 사용하는 Request Body Object 패키지
- response: Monday 관련 REST API 호출 시 사용하는 Response Body Object 패키지
- repository: Monday 관련 Spring Data JPA Repository
- util: Monday 관련 Util 패키지
- MondayQuery: Monday REST API를 호출하기 위한 GraphQL 쿼리 클래스
- MondayController: Monday 관련 API Endpoint를 설정하는 클래스
- MondayService: Monday 관련 비즈니스 로직을 작성하는 클래스
- MondayScheduler: Monday 관련 스케쥴링 등록 설정 클래스
- TaskToolIntegrationApplication.java: 솔루션 백엔드 서버 Startpoint
- config: Monday 관련 각종 설정 클래스를 모아둔 패키지
- jira: Jira 연동 관련 패키지
- com.pbl.tasktoolintegration: 솔루션 백엔드 메인 패키지
- resources: 리소스
- test: 테스트 관련 패키지
- main: 메인 패키지
- build.gradle: Gradle에서 Build를 수행하기 위한 설정 및 각종 Dependencies 정보를 작성한 파일
- settings.gradle: Gradle 관련 기본 설정