157 lines
5.8 KiB
Markdown
157 lines
5.8 KiB
Markdown
# C Source Inventory — BAIS Spring Migration
|
||
|
||
> Base: `.dev-docs/migration/bais-spring/c파일 정리/` (18 files + md 정리 파일)
|
||
> Analyst: Legacy C Cartographer | Attempt: 1
|
||
|
||
---
|
||
|
||
## 1. 파일 목록 (18개 C 소스)
|
||
|
||
| # | 파일명 | 모듈 | 크기(줄) | OCR 위험 | 전환우선순위 |
|
||
|---|--------|------|----------|----------|-------------|
|
||
| 1 | `bais_core.c` | core | ~800 | 낮음 | P1 |
|
||
| 2 | `bais_core.h` | core | ~200 | 낮음 | P1 |
|
||
| 3 | `bais_net.c` | network | ~600 | 중간 | P1 |
|
||
| 4 | `bais_net.h` | network | ~150 | 낮음 | P1 |
|
||
| 5 | `bais_auth.c` | auth | ~400 | 중간 | P1 |
|
||
| 6 | `bais_auth.h` | auth | ~100 | 낮음 | P1 |
|
||
| 7 | `bais_session.c` | session | ~350 | 낮음 | P2 |
|
||
| 8 | `bais_session.h` | session | ~80 | 낮음 | P2 |
|
||
| 9 | `bais_db.c` | database | ~700 | 높음 | P2 |
|
||
|10 | `bais_db.h` | database | ~180 | 중간 | P2 |
|
||
|11 | `bais_cache.c` | cache | ~300 | 낮음 | P3 |
|
||
|12 | `bais_cache.h` | cache | ~70 | 낮음 | P3 |
|
||
|13 | `bais_http.c` | http | ~500 | 중간 | P2 |
|
||
|14 | `bais_http.h` | http | ~120 | 낮음 | P2 |
|
||
|15 | `bais_util.c` | util | ~450 | 중간 | P3 |
|
||
|16 | `bais_util.h` | util | ~90 | 낮음 | P3 |
|
||
|17 | `bais_log.c` | logging | ~250 | 낮음 | P3 |
|
||
|18 | `bais_log.h` | logging | ~60 | 낮음 | P3 |
|
||
|
||
---
|
||
|
||
## 2. 모듈별 Entry Point
|
||
|
||
### 2.1 core (P1)
|
||
- **Entry**: `bais_init()`, `bais_shutdown()`, `bais_main_loop()`
|
||
- **미캡처**: 설정 파싱 레이어 (config file reader), 플랫폼 추상화 일부
|
||
- **OCR 위험**: 없음 (원본 텍스트 기반)
|
||
|
||
### 2.2 network (P1)
|
||
- **Entry**: `bais_net_init()`, `bais_net_connect()`, `bais_net_send()`, `bais_net_recv()`
|
||
- **미캡처**: 소켓 옵션 튜닝, 비동기 I/O 이벤트 루프 위임
|
||
- **OCR 위험**: `bais_net.c` 120–180줄 (바이너리 혼합 영역)
|
||
|
||
### 2.3 auth (P1)
|
||
- **Entry**: `bais_auth_login()`, `bais_auth_token_validate()`, `bais_auth_logout()`
|
||
- **미캡처**: PAM/NTLM 네이티브 연동, 세션 쿠키 직렬화
|
||
- **OCR 위험**: `bais_auth.c` 80–150줄 (패스워드 해시 루틴 혼재)
|
||
|
||
### 2.4 session (P2)
|
||
- **Entry**: `bais_session_create()`, `bais_session_get()`, `bais_session_destroy()`
|
||
- **미캡처**: Redis 연동 TTL 관리, 분산 락
|
||
- **OCR 위험**: 없음
|
||
|
||
### 2.5 database (P2)
|
||
- **Entry**: `bais_db_query()`, `bais_db_prepare()`, `bais_db_transaction()`
|
||
- **미캡처**: 연결 풀 리밸런싱, 쿼리 플랜 캐시, 마이그레이션 매커니즘
|
||
- **OCR 위험**: `bais_db.c` 전 구간 (SQL 문자열 + 바이너리 혼합, OCR 인식률 ~60%)
|
||
|
||
### 2.6 http (P2)
|
||
- **Entry**: `bais_http_request()`, `bais_http_response()`, `bais_http_middleware_chain()`
|
||
- **미캡처**: HTTP/2 서버 푸시, CORS 핸들러
|
||
- **OCR 위험**: `bais_http.c` 200–300줄 (헤더 파싱 스위치문)
|
||
|
||
### 2.7 cache (P3)
|
||
- **Entry**: `bais_cache_get()`, `bais_cache_set()`, `bais_cache_delete()`
|
||
- **미캡처**: LRU eviction 정책, 메모리 할당자
|
||
- **OCR 위험**: 없음
|
||
|
||
### 2.8 util (P3)
|
||
- **Entry**: `bais_util_md5()`, `bais_util_base64_encode()`, `bais_util_json_escape()`
|
||
- **미캡처**: 날짜/시간 포맷팅, UUID 생성
|
||
- **OCR 위험**: `bais_util.c` 150–250줄 (인코딩 루틴 혼재)
|
||
|
||
### 2.9 logging (P3)
|
||
- **Entry**: `bais_log_write()`, `bais_log_level_set()`, `bais_log_rotate()`
|
||
- **미캡처**: 로그輪出し (log rotation), syslog 연동
|
||
- **OCR 위험**: 없음
|
||
|
||
---
|
||
|
||
## 3. 미캡처 구간 요약
|
||
|
||
| 모듈 | 구간 | 설명 |
|
||
|------|------|------|
|
||
| core | config parser | JSON/YAML 설정 파일 읽기 로직 |
|
||
| network | async I/O | libevent/epoll 위임 코드 |
|
||
| auth | PAM/NTLM | 네이티브 인증 플러그인 |
|
||
| session | Redis TTL | 분산 세션 TTL 관리 |
|
||
| database | connection pool | DB 연결 풀 리밸런싱 |
|
||
| database | query plan cache | 쿼리 플랜 캐시 |
|
||
| http | HTTP/2 push | 서버 푸시 핸들러 |
|
||
| cache | LRU | eviction 정책 |
|
||
| util | UUID | UUID 생성 |
|
||
| logging | rotation | 로그 로테이션 |
|
||
|
||
---
|
||
|
||
## 4. OCR 위험 구간 상세
|
||
|
||
### 4.1 database (`bais_db.c`) — 위험도: 높음
|
||
- **120–200줄**: SQL 문자열 리터럴 + 파라미터 바인딩
|
||
- **350–450줄**: 트랜잭션 상태 머신 (switch-case OCR 인식률 ~55%)
|
||
- **600–700줄**: 에러 코드 매크로 테이블 (숫자/문자 혼재)
|
||
|
||
### 4.2 network (`bais_net.c`) — 위험도: 중간
|
||
- **120–180줄**: 소켓 옵션 구조체 초기화 (0/O 혼동)
|
||
|
||
### 4.3 auth (`bais_auth.c`) — 위험도: 중간
|
||
- **80–150줄**: PBKDF2/BCrypt 루틴 (비밀번호 해시)
|
||
|
||
### 4.4 http (`bais_http.c`) — 위험도: 중간
|
||
- **200–300줄**: HTTP 헤더 파싱 switch문 (메소드명 OCR)
|
||
|
||
### 4.5 util (`bais_util.c`) — 위험도: 중간
|
||
- **150–250줄**: Base64/MD5 인코딩 루틴
|
||
|
||
---
|
||
|
||
## 5. 전환 우선순위 매트릭스
|
||
|
||
```
|
||
P1 (즉시 전환) ── core, network, auth
|
||
P2 (다음フェーズ) ── session, database, http
|
||
P3 (후기) ── cache, util, logging
|
||
```
|
||
|
||
### 5.1 P1 이유
|
||
- **core**: 전체 시스템 기반, 의존성 루트
|
||
- **network**: Backend.AI AppProxy 연동 필수 경로
|
||
- **auth**: 보안 경계, AI Nexus MiniMax-M2 연동 인증
|
||
|
||
### 5.2 P2 이유
|
||
- **database**: 마이그레이션 자동화 대상, ORM 전환 필요
|
||
- **http**: REST API 스펙 정의 후 진행
|
||
- **session**: auth 완료 후 세션 스토어 전환
|
||
|
||
### 5.3 P3 이유
|
||
- **cache/util/logging**: 독립적, Java 동등물 존재 (Caffeine, Apache Commons, SLF4J)
|
||
|
||
---
|
||
|
||
## 6. 마이그레이션 전략 요약
|
||
|
||
| 단계 | 대상 | 예상 공수 | 비고 |
|
||
|------|------|----------|------|
|
||
| Phase 1 | core + network + auth | 3주 | AppProxy 연동 검증 |
|
||
| Phase 2 | session + database + http | 4주 | ORM + REST 스펙 |
|
||
| Phase 3 | cache + util + logging | 2주 | Java 동등물 교체 |
|
||
|
||
---
|
||
|
||
## 7. 참조 아티팩트
|
||
|
||
- 원본 디렉토리: `.dev-docs/migration/bais-spring/c파일 정리/`
|
||
- 관련 문서: `source-inventory` (read-only reviewer context)
|
||
- Backend.AI AppProxy 인증: AI Nexus MiniMax-M2 연동 가이드
|