diff --git a/.dev-docs/migration/bais-spring/c파일-정리-OCR-위험-구간.md b/.dev-docs/migration/bais-spring/c파일-정리-OCR-위험-구간.md deleted file mode 100644 index 1250654..0000000 --- a/.dev-docs/migration/bais-spring/c파일-정리-OCR-위험-구간.md +++ /dev/null @@ -1,88 +0,0 @@ -# OCR 위험 구간 상세 분석 - -## 위험 분류 기준 - -- **높음**: 수동 리뷰 필수, 자동 전환 불가 -- **중간**: 샘플 검증 후 전환 가능 -- **낮음**: 자동 전환 권장 - -## 위험 구간 목록 - -### 높음 위험 (4개) - -#### 1. api_parser.c - 파서 상태머신 -```c -// 위험 구간: parser_state_t enum 및 상태 전이 -typedef enum { - PARSER_INIT, - PARSER_HEADER, - PARSER_BODY, - PARSER_COMPLETE, - PARSER_ERROR -} parser_state_t; - -// 위험 구간: 중첩 switch-case -switch (state) { - case PARSER_HEADER: - switch (field_type) { - // ... - } -} -``` - -#### 2. db_migrator.c - 스키마 diff 로직 -```c -// 위험 구간: 테이블 비교 알고리즘 -int compare_columns(column_t* a, column_t* b) { - // 복잡한 비교 로직 -} -``` - -#### 3. net_protocol.c - 프로토콜 상태머신 -```c -// 위험 구간: 바이너리 프로토콜 파싱 -switch (packet_type) { - case PKT_HANDSHAKE: - // ... - case PKT_DATA: - // ... -} -``` - -#### 4. utils_string.c - 인코딩 변환 -```c -// 위험 구간: 멀티바이트 문자 처리 -size_t convert_encoding(char* out, const char* in, enc_t from, enc_t to) { - // EUC-KR, UTF-8, ISO-2022-KR 변환 -} -``` - -### 중간 위험 (6개) - -| 파일 | 구간 | 위험 이유 | -|------|------|-----------| -| api_handler.c | 콜백 레지스트리 | 함수 포인터 배열 초기화 | -| api_router.c | 동적 라우트 테이블 | 해시맵 구현체 | -| db_query.c | 트랜잭션 처리 | 에러 코드 매핑 | -| net_client.c | SSL 핸드셰이크 | OpenSSL 콜백 | -| crypto_cipher.c | 키 관리 | 키 파생 함수 | -| utils_config.c | 설정 파싱 | 토큰 파싱 로직 | - -### 낮음 위험 (8개) - -| 파일 | 구간 | 비고 | -|------|------|------| -| api_validator.c | 스키마 검증 | 단순 검증 로직 | -| db_connector.c | 연결 풀 관리 | 표준 인터페이스 | -| net_server.c | 소켓 옵션 | 표준 소켓 API | -| net_buffer.c | 메모리 풀 | 단순 할당 래퍼 | -| crypto_hash.c | HMAC 처리 | 표준 OpenSSL | -| crypto_random.c | 엔트로피 소스 | 단순 래퍼 | -| utils_logger.c | 로그 로테이션 | 표준 파일 I/O | -| utils_timer.c | 타이머 큐 | 단순链表 | - -## OCR 리스크 완화 전략 - -1. **높음 위험**: 전문 리뷰어 수동 검토, 테스트 케이스 보강 -2. **중간 위험**: 샘플 입력으로 검증, 커버리지 테스트 작성 -3. **낮음 위험**: 자동 전환 후 기본 테스트만 수행 diff --git a/.dev-docs/migration/bais-spring/c파일-정리-모듈-매핑.md b/.dev-docs/migration/bais-spring/c파일-정리-모듈-매핑.md deleted file mode 100644 index ceb57cf..0000000 --- a/.dev-docs/migration/bais-spring/c파일-정리-모듈-매핑.md +++ /dev/null @@ -1,68 +0,0 @@ -# C 파일 모듈 매핑 - -## 모듈 구조 - -``` -┌──────────────────────────────────────────────────────────────┐ -│ Application │ -├──────────────────────────────────────────────────────────────┤ -│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │ -│ │ API │ │ DB │ │ Network │ │ Crypto │ │ -│ │ Module │ │ Module │ │ Module │ │ Module │ │ -│ └────┬────┘ └────┬────┘ └────┬────┘ └────┬────┘ │ -│ │ │ │ │ │ -│ └────────────┴────────────┴────────────┘ │ -│ │ │ -│ ┌─────┴─────┐ │ -│ │ Utils │ │ -│ │ Module │ │ -│ └───────────┘ │ -└──────────────────────────────────────────────────────────────┘ -``` - -## 의존성 그래프 - -``` -API ─────► DB - │ │ - ▼ ▼ -Utils ◄──────┘ - -Network ────► Crypto - │ - ▼ - Utils -``` - -## 파일별 모듈归属 - -| 파일명 | 모듈 | 레이어 | -|--------|------|--------| -| api_handler.c | API | Application | -| api_parser.c | API | Application | -| api_validator.c | API | Application | -| api_router.c | API | Application | -| db_connector.c | DB | Data | -| db_query.c | DB | Data | -| db_migrator.c | DB | Data | -| net_server.c | Network | Infrastructure | -| net_client.c | Network | Infrastructure | -| net_protocol.c | Network | Infrastructure | -| net_buffer.c | Network | Infrastructure | -| crypto_hash.c | Crypto | Security | -| crypto_cipher.c | Crypto | Security | -| crypto_random.c | Crypto | Security | -| utils_logger.c | Utils | Common | -| utils_config.c | Utils | Common | -| utils_timer.c | Utils | Common | -| utils_string.c | Utils | Common | - -## 전환 영향도 매트릭스 - -| 전환 대상 | 영향받는 모듈 | 영향도 | -|-----------|---------------|--------| -| API 모듈 전체 | DB, Utils | 높음 | -| DB 모듈 전체 | API | 중간 | -| Network 모듈 전체 | API, Crypto | 중간 | -| Crypto 모듈 전체 | Network | 높음 | -| Utils 모듈 전체 | 모든 모듈 | 매우 높음 | diff --git a/.dev-docs/migration/bais-spring/c파일-정리-인벤토리-세부사항.md b/.dev-docs/migration/bais-spring/c파일-정리-인벤토리-세부사항.md deleted file mode 100644 index 27b2243..0000000 --- a/.dev-docs/migration/bais-spring/c파일-정리-인벤토리-세부사항.md +++ /dev/null @@ -1,147 +0,0 @@ -# C 파일 상세 분석 - -## 파일별 상세 분석 - -### api_handler.c -- **모듈**: API -- **Entry Point**: `handle_api_request(request_t* req, response_t* res)` -- **Dependencies**: `api_parser.c`, `api_validator.c`, `api_router.c` -- **미캡처 구간**: 콜백 레지스트리 (`callback_registry[]` 배열) -- **OCR 위험**: 중간 - 함수 포인터 배열 초기화 부분 -- **전환 우선순위**: P1 - -### api_parser.c -- **모듈**: API -- **Entry Point**: `parse_api_payload(const char* data, size_t len)` -- **Dependencies**: `utils_string.c` -- **미캡처 구간**: 파서 상태머신 (`parser_state_t` enum 및 상태 전이) -- **OCR 위험**: 높음 - 중첩 switch-case 및 상태 열거형 -- **전환 우선순위**: P1 - -### api_validator.c -- **모듈**: API -- **Entry Point**: `validate_request(const request_t* req)` -- **Dependencies**: `utils_config.c` -- **미캡처 구간**: 스키마 검증 로직 (정규식 패턴 매칭) -- **OCR 위험**: 낮음 - 비교적 단순한 검증 로직 -- **전환 우선순위**: P2 - -### api_router.c -- **모듈**: API -- **Entry Point**: `route_request(const request_t* req)` -- **Dependencies**: `api_handler.c` -- **미캡처 구간**: 동적 라우트 테이블 (`route_table` 해시맵) -- **OCR 위험**: 중간 - 라우트 패턴 파싱 로직 -- **전환 우선순위**: P2 - -### db_connector.c -- **모듈**: DB -- **Entry Point**: `db_connect(const char* conn_str)` -- **Dependencies**: `net_client.c` (소켓 사용) -- **미캡처 구간**: 연결 풀 관리 (`connection_pool_t`) -- **OCR 위험**: 낮음 - 표준 libpq 인터페이스 -- **전환 우선순위**: P1 - -### db_query.c -- **모듈**: DB -- **Entry Point**: `execute_query(db_conn_t* conn, const char* sql)` -- **Dependencies**: `db_connector.c` -- **미캡처 구간**: 트랜잭션 처리 (isolation level, savepoint) -- **OCR 위험**: 중간 - 에러 코드 매핑 로직 -- **전환 우선순위**: P1 - -### db_migrator.c -- **모듈**: DB -- **Entry Point**: `run_migration(const char* migration_dir)` -- **Dependencies**: `db_query.c`, `utils_logger.c` -- **미캡처 구간**: 스키마 diff 로직 (테이블 비교 알고리즘) -- **OCR 위험**: 높음 - 복잡한 diff 알고리즘 -- **전환 우선순위**: P3 - -### net_server.c -- **모듈**: Network -- **Entry Point**: `start_server(uint16_t port)` -- **Dependencies**: `net_buffer.c` -- **미캡처 구간**: 소켓 옵션 설정 (SO_REUSEADDR 등) -- **OCR 위험**: 낮음 - 표준 소켓 API -- **전환 우선순위**: P1 - -### net_client.c -- **모듈**: Network -- **Entry Point**: `connect_remote(const char* host, uint16_t port)` -- **Dependencies**: `net_buffer.c`, `crypto_cipher.c` (TLS) -- **미캡처 구간**: SSL 핸드셰이크 로직 -- **OCR 위험**: 중간 - OpenSSL 콜백 인터페이스 -- **전환 우선순위**: P2 - -### net_protocol.c -- **모듈**: Network -- **Entry Point**: `process_packet(buffer_t* buf)` -- **Dependencies**: `net_buffer.c` -- **미캡처 구간**: 프로토콜 상태머신 (패킷 파싱 상태 전이) -- **OCR 위험**: 높음 - 바이너리 프로토콜 파싱 -- **전환 우선순위**: P2 - -### net_buffer.c -- **모듈**: Network -- **Entry Point**: `alloc_buffer(size_t size)` -- **Dependencies**: 없음 -- **미캡처 구간**: 메모리 풀 (`buffer_pool_t`) -- **OCR 위험**: 낮음 - 단순 메모리 할당 래퍼 -- **전환 우선순위**: P3 - -### crypto_hash.c -- **모듈**: Crypto -- **Entry Point**: `compute_hash(const void* data, size_t len, hash_algo_t algo)` -- **Dependencies**: 없음 -- **미캡처 구간**: HMAC 처리 (키 확장 로직) -- **OCR 위험**: 낮음 - 표준 OpenSSL 인터페이스 -- **전환 우선순위**: P1 - -### crypto_cipher.c -- **모듈**: Crypto -- **Entry Point**: `encrypt_data(const void* key, const void* iv, const void* data)` -- **Dependencies**: `crypto_random.c` -- **미캡처 구간**: 키 관리 (키 롤링, 스토어) -- **OCR 위험**: 중간 - 키 파생 함수 -- **전환 우선순위**: P2 - -### crypto_random.c -- **모듈**: Crypto -- **Entry Point**: `generate_random(void* buf, size_t len)` -- **Dependencies**: 없음 -- **미캡처 구간**: 엔트로피 소스 (`/dev/urandom` fallback) -- **OCR 위험**: 낮음 - 단순 래퍼 함수 -- **전환 우선순위**: P3 - -### utils_logger.c -- **모듈**: Utils -- **Entry Point**: `log_message(log_level_t level, const char* fmt, ...)` -- **Dependencies**: `utils_string.c` -- **미캡처 구간**: 로그 로테이션 (파일 크기 기반) -- **OCR 위험**: 낮음 - 표준 파일 I/O -- **전환 우선순위**: P2 - -### utils_config.c -- **모듈**: Utils -- **Entry Point**: `load_config(const char* path)` -- **Dependencies**: `utils_string.c` -- **미캡처 구간**: 설정 파싱 (INI/JSON 섹션 처리) -- **OCR 위험**: 중간 - 토큰 파싱 로직 -- **전환 우선순위**: P2 - -### utils_timer.c -- **모듈**: Utils -- **Entry Point**: `start_timer(uint32_t ms, timer_callback_t cb)` -- **Dependencies**: 없음 -- **미캡처 구간**: 타이머 큐 (우선순위 큐 구현) -- **OCR 위험**: 낮음 - 단순链表 기반 -- **전환 우선순위**: P3 - -### utils_string.c -- **모듈**: Utils -- **Entry Point**: `string_utils(const char* op, char* dest, const char* src)` -- **Dependencies**: 없음 -- **미캡처 구간**: 인코딩 변환 (UTF-8, EUC-KR, ISO-2022-KR) -- **OCR 위험**: 높음 - 멀티바이트 문자 처리 -- **전환 우선순위**: P3 diff --git a/.dev-docs/migration/bais-spring/c파일-정리-인벤토리.md b/.dev-docs/migration/bais-spring/c파일-정리-인벤토리.md deleted file mode 100644 index 3db0534..0000000 --- a/.dev-docs/migration/bais-spring/c파일-정리-인벤토리.md +++ /dev/null @@ -1,131 +0,0 @@ -# C 소스 인벤토리 분석 보고서 - -## 개요 -- **분석 기준**: `.dev-docs/migration/bais-spring/c파일 정리/` 디렉토리 내 18개 C 파일 및 md 정리 파일 -- **분석 일시**: 2025-07-13 -- **분석자**: Legacy C Cartographer - ---- - -## 모듈별 분류 - -### 1. API 모듈 (4개 파일) -| 파일명 | 역할 | Entry Point | 미캡처 구간 | OCR 위험 | 전환우선순위 | -|--------|------|-------------|-------------|----------|-------------| -| `api_handler.c` | REST API 요청 처리 | `handle_api_request()` | 콜백 레지스트리 | 중간 | P1 | -| `api_parser.c` | JSON/XML 파싱 | `parse_api_payload()` | 파서 상태머신 | 높음 | P1 | -| `api_validator.c` | 요청 검증 | `validate_request()` | 스키마 검증 로직 | 낮음 | P2 | -| `api_router.c` | 경로 라우팅 | `route_request()` | 동적 라우트 테이블 | 중간 | P2 | - -### 2. DB 모듈 (3개 파일) -| 파일명 | 역할 | Entry Point | 미캡처 구간 | OCR 위험 | 전환우선순위 | -|--------|------|-------------|-------------|----------|-------------| -| `db_connector.c` | DB 연결 관리 | `db_connect()` | 연결 풀 관리 | 낮음 | P1 | -| `db_query.c` | 쿼리 실행 | `execute_query()` | 트랜잭션 처리 | 중간 | P1 | -| `db_migrator.c` | 마이그레이션 | `run_migration()` | 스키마 diff | 높음 | P3 | - -### 3. Network 모듈 (4개 파일) -| 파일명 | 역할 | Entry Point | 미캡처 구간 | OCR 위험 | 전환우선순위 | -|--------|------|-------------|-------------|----------|-------------| -| `net_server.c` | 서버 리스닝 | `start_server()` | 소켓 옵션 설정 | 낮음 | P1 | -| `net_client.c` | 클라이언트 연결 | `connect_remote()` | SSL 핸드셰이크 | 중간 | P2 | -| `net_protocol.c` | 프로토콜 처리 | `process_packet()` | 프로토콜 상태머신 | 높음 | P2 | -| `net_buffer.c` | 버퍼 관리 | `alloc_buffer()` | 메모리 풀 | 낮음 | P3 | - -### 4. Crypto 모듈 (3개 파일) -| 파일명 | 역할 | Entry Point | 미캡처 구간 | OCR 위험 | 전환우선순위 | -|--------|------|-------------|-------------|----------|-------------| -| `crypto_hash.c` | 해시 계산 | `compute_hash()` | HMAC 처리 | 낮음 | P1 | -| `crypto_cipher.c` | 암호화/복호화 | `encrypt_data()` | 키 관리 | 중간 | P2 | -| `crypto_random.c` | 난수 생성 | `generate_random()` | 엔트로피 소스 | 낮음 | P3 | - -### 5. Utils 모듈 (4개 파일) -| 파일명 | 역할 | Entry Point | 미캡처 구간 | OCR 위험 | 전환우선순위 | -|--------|------|-------------|-------------|----------|-------------| -| `utils_logger.c` | 로깅 | `log_message()` | 로그 로테이션 | 낮음 | P2 | -| `utils_config.c` | 설정 관리 | `load_config()` | 설정 파싱 | 중간 | P2 | -| `utils_timer.c` | 타이머 관리 | `start_timer()` | 타이머 큐 | 낮음 | P3 | -| `utils_string.c` | 문자열 처리 | `string_utils()` | 인코딩 변환 | 높음 | P3 | - ---- - -## Entry Point 인벤토리 (총 12개) - -``` -P1 (전환 우선순위 1): - - api_handler.c: handle_api_request() - - api_parser.c: parse_api_payload() - - db_connector.c: db_connect() - - db_query.c: execute_query() - - net_server.c: start_server() - - crypto_hash.c: compute_hash() - -P2 (전환 우선순위 2): - - api_validator.c: validate_request() - - api_router.c: route_request() - - net_client.c: connect_remote() - - net_protocol.c: process_packet() - - crypto_cipher.c: encrypt_data() - - utils_logger.c: log_message() - - utils_config.c: load_config() - -P3 (전환 우선순위 3): - - db_migrator.c: run_migration() - - net_buffer.c: alloc_buffer() - - crypto_random.c: generate_random() - - utils_timer.c: start_timer() - - utils_string.c: string_utils() -``` - ---- - -## OCR 위험 구간 분석 (총 7개) - -| 위험도 | 파일 | 구간 설명 | 권장 조치 | -|--------|------|-----------|-----------| -| 높음 | `api_parser.c` | 파서 상태머신 (switch-case 중첩) | 수동 리뷰 필수 | -| 높음 | `db_migrator.c` | 스키마 diff 로직 | 수동 리뷰 필수 | -| 높음 | `net_protocol.c` | 프로토콜 상태머신 | 수동 리뷰 필수 | -| 높음 | `utils_string.c` | 인코딩 변환 로직 | 수동 리뷰 필수 | -| 중간 | `api_handler.c` | 콜백 레지스트리 | 샘플 검증 | -| 중간 | `api_router.c` | 동적 라우트 테이블 | 샘플 검증 | -| 중간 | `db_query.c` | 트랜잭션 처리 | 샘플 검증 | -| 중간 | `net_client.c` | SSL 핸드셰이크 | 샘플 검증 | -| 중간 | `crypto_cipher.c` | 키 관리 | 샘플 검증 | -| 중간 | `utils_config.c` | 설정 파싱 | 샘플 검증 | - ---- - -## 미캡처 구간 인벤토리 - -| 파일 | 미캡처 구간 | 영향도 | -|------|-------------|--------| -| `api_handler.c` | 콜백 레지스트리 매핑 로직 | 중간 | -| `api_parser.c` | 파서 상태머신의 상태 전이 테이블 | 높음 | -| `api_router.c` | 동적 라우트 테이블 빌드 로직 | 중간 | -| `db_query.c` | 트랜잭션 격리 수준 처리 | 중간 | -| `net_client.c` | 비동기 연결 재시도 로직 | 낮음 | -| `net_protocol.c` | 프로토콜 버전 협상 로직 | 높음 | -| `utils_config.c` | 설정 파일 핫리로딩 | 낮음 | - ---- - -## 전환 우선순위 매트릭스 - -``` -┌─────────────────────────────────────────────────────────────┐ -│ 우선순위 │ 파일 수 │ 핵심 이유 │ -├───────────┼─────────┼───────────────────────────────────────┤ -│ P1 │ 6개 │ 핵심 비즈니스 로직, 즉시 전환 필요 │ -│ P2 │ 7개 │ 중요 인프라, 점진적 전환 가능 │ -│ P3 │ 5개 │ 지원 유틸리티, 후순위 │ -└─────────────────────────────────────────────────────────────┘ -``` - ---- - -## 권장 전환 순서 - -1. **1단계 (P1)**: API + DB + Network 서버 + Crypto 해시 -2. **2단계 (P2)**: 나머지 API + Network 클라이언트 + Crypto 암호화 + Utils 로깅/설정 -3. **3단계 (P3)**: DB 마이그레이션 + Network 버퍼 + Crypto 난수 + Utils 타이머/문자열 diff --git a/.forge/codex-bais-final4-20260713-195657-BAIS-SPRING-CTX-001-attempt-1-run-374d0c84ac09.md b/.forge/codex-bais-final4-20260713-195657-BAIS-SPRING-CTX-001-attempt-1-run-374d0c84ac09.md deleted file mode 100644 index 50c6ee2..0000000 --- a/.forge/codex-bais-final4-20260713-195657-BAIS-SPRING-CTX-001-attempt-1-run-374d0c84ac09.md +++ /dev/null @@ -1,3 +0,0 @@ -# codex-bais-final4-20260713-195657-BAIS-SPRING-CTX-001-attempt-1-run-374d0c84ac09 - -Forge 이슈 작업 브랜치 `forge/codex-bais-final4-20260713-195657-BAIS-SPRING-CTX-001-attempt-1-run-374d0c84ac09`.