toki/alt

toki db4ee8f78e feat: socket session loop implementation and agent-task documentation

- Add server_test.go for socket server testing
- Update socket-session-loop.md roadmap milestone
- Refactor services/api/internal/socket/server.go
- Add agent-task documentation for socket session loop

2026-05-28 09:36:33 +09:00

2.4 KiB

Raw Blame History

Milestone: Socket Session Loop

위치

Roadmap: agent-roadmap/ROADMAP.md
Phase: agent-roadmap/phase/foundation-alignment/PHASE.md

목표

Go API와 Flutter client 사이에 proto-socket 기반 최소 session loop를 만든다. 첫 loop는 handshake, request-response, disconnect/heartbeat 동작을 확인하는 데 집중하고, 무거운 데이터/백테스트 실행은 worker milestone로 넘긴다.

상태

[진행중]

구현 잠금

상태: 해제
결정 필요: 없음

범위

API socket server의 ALT payload parser 등록
Hello request/response handshake
Flutter client의 proto-socket connection wrapper
최소 request-response smoke path
API/client socket loop 테스트 또는 수동 검증 명령

기능

Epic: [session-loop] Proto-socket session loop

API와 Flutter client 사이의 최소 연결, 요청, 연결 상태 표현을 묶는다.

[api-handshake] API가 ALT Hello request를 받고 Hello response를 반환한다. 검증: API와 client가 같은 contract typeName 기준으로 메시지를 주고받는다.
[client-connect] Flutter client가 configured socket endpoint에 연결할 client layer를 갖는다.
[request-loop] 최소 request-response 메시지가 API와 client 사이에서 왕복한다.
[disconnect-state] client에서 연결/해제/오류 상태를 UI나 state layer에서 표현할 수 있다. 검증: heartbeat/disconnect는 proto-socket 기본 동작을 따른다.
[socket-test] handshake loop를 검증하는 테스트 또는 반복 가능한 smoke 명령이 있다. 검증: API가 long-running worker 작업을 직접 실행하지 않고 bin/test, bin/lint가 통과한다.

완료 리뷰

상태: 없음
요청일: 없음
완료 근거: 아직 기능 Task와 Task별 검증이 충족되지 않았다.
리뷰 필요:
- 사용자가 완료 결과를 확인했다
- archive 이동을 승인했다
리뷰 코멘트: 없음

범위 제외

market data import
backtest 실행
인증/세션 권한 모델
실시간 시세 streaming

작업 컨텍스트

관련 경로: services/api/, apps/client/, packages/contracts/, ../proto-socket/
표준선(선택): API는 socket/session boundary를 맡고, worker execution은 worker milestone에서 다룬다.
선행 작업: Contract and Codegen Baseline
후속 작업: Flutter Operator Console
확인 필요: 없음

2.4 KiB Raw Blame History