2.6 KiB

Raw Permalink Blame History

작업 플랜

UUID: bbaba3dd-0931-47bd-92af-5c38892f9040
작업자: Codex
생성 시각: 2026-06-02 16:41 KST
요청 요약: README와 필수 문서를 읽고 client 작업을 이어받을 준비

할 일

현재 요청 확인
README.md 확인
docs/00-ai-collaboration-rules.md 확인
Git 상태와 현재 브랜치 확인
client/ 관련 문서와 구현 상태 확인
이전 플랜에서 client 작업 흐름 확인
server 작업영역을 수정하지 않는 범위 정리
이어받을 작업 지점 정리

범위

이번 준비 작업은 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/ 작업영역을 수정하지 않았습니다.