proto-socket/agent-ops/rules/project/domain/kotlin/rules.md

kotlin

목적 / 책임

Toki Socket의 Kotlin/Android 구현체를 담당한다. Android 및 JVM 환경을 대상으로 한다.

포함 경로

• kotlin/src/ — 구현 소스
• kotlin/crosstest/ — 크로스 언어 테스트 (Dart, Go와 연동). 오케스트레이터 또는 클라이언트 헬퍼
• kotlin/build.gradle.kts, kotlin/settings.gradle.kts — Gradle 빌드 설정

제외 경로

• kotlin/src/**/packets/ — protocol 도메인

주요 구성 요소

• Transport, Communicator, BaseClient 등 코어 로직
• TCP / WebSocket 통신 클라이언트

유지할 패턴

• ./gradlew test로 테스트 실행
• ./gradlew run -PmainClass=...으로 crosstest 실행

다른 도메인과의 경계

• protocol: proto 타입을 사용하지만, 스키마 정의는 protocol 도메인
• dart/go: crosstest에서 상호 연동

금지 사항

• Kotlin proto 복사본에서 메시지 스키마를 변경하지 않는다