48 lines
2.6 KiB
Markdown
48 lines
2.6 KiB
Markdown
# 작업 플랜
|
|
|
|
- UUID: `bbaba3dd-0931-47bd-92af-5c38892f9040`
|
|
- 작업자: `Codex`
|
|
- 생성 시각: `2026-06-02 16:41 KST`
|
|
- 요청 요약: `README와 필수 문서를 읽고 client 작업을 이어받을 준비`
|
|
|
|
## 할 일
|
|
|
|
- [x] 현재 요청 확인
|
|
- [x] `README.md` 확인
|
|
- [x] `docs/00-ai-collaboration-rules.md` 확인
|
|
- [x] Git 상태와 현재 브랜치 확인
|
|
- [x] `client/` 관련 문서와 구현 상태 확인
|
|
- [x] 이전 플랜에서 client 작업 흐름 확인
|
|
- [x] server 작업영역을 수정하지 않는 범위 정리
|
|
- [x] 이어받을 작업 지점 정리
|
|
|
|
## 범위
|
|
|
|
- 이번 준비 작업은 `client/`, `docs/`, `plans/` 맥락 확인에 집중합니다.
|
|
- 사용자의 지시에 따라 `server/` 작업영역은 수정하지 않습니다.
|
|
- 사용자가 계획을 확정하고 실행을 지시하기 전까지 C++ 코드, 빌드 시스템, 테스트 코드는 만들거나 수정하지 않습니다.
|
|
|
|
## 현재 확인 내용
|
|
|
|
- 현재 브랜치: `main`
|
|
- 작업 시작 시점의 Git 변경사항: `.DS_Store` untracked
|
|
- `client/`에는 C++17 기반 ALSA 캡처와 UDP 송신 초기 구현이 있습니다.
|
|
- `client/src/main.cpp`는 설정 파일과 CLI 옵션을 읽고, ALSA에서 signed 16-bit little endian PCM을 캡처한 뒤 UDP 패킷으로 송신합니다.
|
|
- `client/CMakeLists.txt`, `client/client.conf.example`, `client/README.md`가 있습니다.
|
|
- 이전 client 플랜 기록상 로컬 환경에는 빌드 도구와 ALSA 개발 패키지가 없어 실제 컴파일 검증은 완료되지 않았습니다.
|
|
- 현재 client 패킷 형식은 40바이트 `MIC1` 헤더입니다.
|
|
- 최근 server 방향 기록에는 56바이트 헤더 v1과 `sender_id`, `session_id`, `capture_sample_index` 같은 추가 메타데이터가 언급되어 있어, 다음 client 작업에서는 서버와 맞출 패킷 포맷을 먼저 확정해야 합니다.
|
|
|
|
## 이어받을 때 주의할 점
|
|
|
|
- `server/` 파일은 수정하지 않습니다.
|
|
- client 변경이 필요해도 먼저 계획을 제시하고 사용자 실행 지시를 받은 뒤 진행합니다.
|
|
- 서버와 패킷 포맷을 맞추는 작업은 client 쪽 변경만으로 가능한지 먼저 분리해서 판단합니다.
|
|
- 실제 빌드 검증은 Orange Pi 또는 ALSA 개발 패키지가 설치된 Linux 환경에서 수행하는 것이 우선입니다.
|
|
|
|
## 완료 요약
|
|
|
|
- README, 필수 협업 규칙, client 방향성 문서, client 구현 파일, 이전 client 플랜을 확인했습니다.
|
|
- 현재 상태와 다음 작업 진입점을 정리했습니다.
|
|
- 이번 준비 작업에서는 `server/` 작업영역을 수정하지 않았습니다.
|