# 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 연동 가이드