Development

개발 가이드

SSOT: docs/18 빌드·테스트 · docs/15 개발 방법론 · docs/16 문서·git 규약 · docs/13 코드 설계 표준

빌드·실행

cargo build --release          # 단일 실행 파일(≤10MB 게이트)
./target/release/nexa-beep --window --live    # 창 + 실물 LAN 발견
./target/release/nexa-beep --chat-live 이름   # 헤드리스 대화 도구(GUI 목록에 뜸)
./target/release/nexa-beep --discover-probe 5 # 발견 패킷 관측

MSRV 1.82(잠정) · 의존성 퍼미시브 온리(GPL/LGPL 금지).

테스트

cargo test --workspace              # 전체(현재 573 green — main은 항상 green)
cargo test -- --ignored             # 실네트워크 필요 테스트(멀티캐스트 등)
cargo clippy --workspace --all-targets   # 경고 0 유지
cargo fmt --all -- --check

개발 규율

• 수직 슬라이스 · 작업 단위 = 커밋 1개 · 초안→확장 · main 항상 green · Conventional Commits
• 큰 단위 = 브랜치(--no-ff 병합 + BRANCHES.md 기록) · 세부 기능 = 커밋
• 네트워크는 추정 금지, 실측 필수 — "보냈다"는 "닿았다"가 아니다
• 기록 트랜잭션: 커밋 → journal 상세 → DEVLOG 한 줄 → STATUS 한 장 → MILESTONES/TODO
• 모든 UI는 커스텀 컨트롤(DR-6) — 새 컨트롤은 ControlBase 컴포지션 + 갤러리(⌘/Ctrl+G) 등록

문서 체계 (4층)

층	문서
현황	STATUS(한 장) · DEVLOG(시간 역순 한 줄) · journal/(일자 상세)
계획	TODO(마일스톤별) · MILESTONES
설계	docs/00~35(번호 불변 · 신규는 append) · ADR 14종
결정	docs/10 결정 원장(DR-1~28) — 변경은 새 ADR/journal로만

저장소 구조

crates/ 11개 크레이트(Architecture 참조) · packaging/(NSIS·매니페스트 템플릿) · .github/workflows/(ci · release — v* 태그 push = 5타깃 자동 공개).