APIDOC43: API 문서 자동 생성

• 초기 화면 설계

APIDOC43은 정적 코드 기반 API 문서 생성 서비스입니다.

├── api_spec_generator           // OpenAPI 명세 생성 
├── code_parser                  // Java 소스코드 파싱
├── pipline_orchestrator         // 비동기 파이프라인 
└── saas_platform                // 문서관리 API (미개발)

---

API 문서 생성과정

시퀀스 다이어그램

sequenceDiagram
   participant Client as Client
   participant Pipeline as 명세생성파이프라인
   participant Collector as codePaser
   participant LLM as LLM
   
   Client ->> Pipeline: 요청: Project
    loop API별 관련된 소스코드 수집
   Pipeline ->> Collector: OrderController.java
   
   Collector -->> Pipeline: API Tasks 반환
   note over Collector: [API Task]<br><br>orderController.java <br> ㅤㅤㅤㄴ orderService.java <br>  ㅤㅤ ㅤㅤㄴ orderRepository.java <br>...
        
       end
   loop API tasks
       Pipeline ->> LLM: API 명세 생성 요청
       
       LLM -->> Pipeline: API 명세 반환
   end
   
   Pipeline -->> Client: 전체 API 명세 반환

Loading

핵심 구현

1. 배치 저장 최적화 (DB I/O 약80% 감소)

@Scheduled(fixedDelay = 30000)
public void flushEntities() { // 30초마다 일괄 저장
    ... 
}

OasBatchSaverService.java

• ArrayBlockingQueue 기반 메모리 버퍼링
• 쿼리 횟수: 28회 → 4회
• 재시도 메커니즘과 실패 처리 로직

sequenceDiagram
   participant Pipeline as 파이프라인
   participant Queue as 메모리큐
   participant BatchSaver as 배치저장
   participant Merger as 엔티티병합
   participant DB as 데이터베이스
   
   loop API 처리
       Pipeline ->> Queue: 데이터 추가 
   end
   
   Note over Queue: 30초 대기 (버퍼링)
   
   BatchSaver ->> Queue: 1000개씩 일괄 수집
   BatchSaver ->> Merger: 동일 Request ID 기준 엔티티 병합
   Merger -->> BatchSaver: 병합된 하나의 엔티티 반환
   BatchSaver ->> DB: Bulk Insert
   Note right of DB: 28회 → 4회 (약 80% 감소)

Loading

2. 비동기 처리 + 스레드풀 분리 (처리 시간 54% 단축)

// 요청 유형별 스레드풀과 세마포어 분리 관리
public void submit(ThrottleRequest request) {
    Semaphore semaphore = resolver.getRelatedSemaphore(request.getTaskType());
    CompletableFuture.runAsync(() -> pipelineService.execute(task), executor);
}

PipelineThrottleService.java

• 처리 시간: 202초 → 93초 (54% 단축)
• ThreadPool + Semaphore 기반 동시성 제어
• 신규/기존 사용자 요청 분리 처리로 UX 개선

sequenceDiagram
    participant Request as 요청
    participant Classifier as Task분류기
    participant HeavyPool as Heavy스레드풀
    participant FastPool as Fast스레드풀
    participant LLM
    
    Request ->> Classifier: API 개수 확인
    
    alt 신규 사용자 (API 많음)
        Classifier ->> HeavyPool: Heavy 작업 할당
        HeavyPool ->> LLM: 오랜 시간 소요
    else 기존 사용자 (API 적음)
        Classifier ->> FastPool: Fast 작업 할당
        FastPool ->> LLM: 빠른 처리
    end
    
    Note over FastPool: 기존 사용자 대기시간 개선

Loading

---

기술 스택

• Java 17, Spring Boot 3, JPA 3
• MySQL 8, MongoDB
• Docker, AWS
• OpenAI API, JavaParser

---

링크

• 랜딩페이지: https://apidoc43.softr.app/