archive: persistence-worker-backbone milestone and add user review
This commit is contained in:
parent
f762d2abd9
commit
6cd08cdaf4
5 changed files with 91 additions and 20 deletions
|
|
@ -10,7 +10,7 @@ ALT는 개인용 quant system workspace로, 한국장 일봉 MVP에서 시작해
|
|||
완료된 Phase도 로드맵에서 제거하지 않고, archive의 Phase 문서로 연결한다.
|
||||
검토중 또는 진행중 Phase는 계획 Phase보다 위에 두어, 아래로 갈수록 미래 계획에 가까워지게 정렬한다.
|
||||
|
||||
- [진행중] 기반 정렬
|
||||
- [검토중] 기반 정렬
|
||||
- 경로: `agent-roadmap/phase/foundation-alignment/PHASE.md`
|
||||
- 요약: agent-first monorepo, Go workspace, contracts, proto-socket session loop, PostgreSQL/Redis worker backbone을 안정화한다.
|
||||
- [계획] 데이터 기반
|
||||
|
|
|
|||
|
|
@ -11,7 +11,7 @@ PostgreSQL과 Redis를 ALT의 운영 기본 인프라로 고정하고, worker가
|
|||
|
||||
## 상태
|
||||
|
||||
[진행중]
|
||||
[완료]
|
||||
|
||||
## 구현 잠금
|
||||
|
||||
|
|
@ -32,22 +32,22 @@ PostgreSQL과 Redis를 ALT의 운영 기본 인프라로 고정하고, worker가
|
|||
|
||||
PostgreSQL, Redis, worker job model, storage boundary 기준을 묶는다.
|
||||
|
||||
- [ ] [db-migrations] PostgreSQL migration entrypoint가 있다. 검증: local PostgreSQL/Redis를 실행한 뒤 worker가 필요한 설정을 읽을 수 있다.
|
||||
- [ ] [typed-queries] DB query를 type-safe하게 다루는 생성/검증 흐름이 있다. 검증: migration/query generation 흐름이 문서화되어 있다.
|
||||
- [ ] [redis-boundary] Redis 사용 목적과 key prefix 기준이 worker 문서나 config에 정리되어 있다.
|
||||
- [ ] [job-model] worker가 비동기 작업을 표현하고 실행할 기본 job model을 갖는다. 검증: worker job이 API 내부 구현에 의존하지 않는다.
|
||||
- [ ] [storage-ports] domain과 persistence 사이의 adapter/port 경계가 정해져 있다.
|
||||
- [x] [db-migrations] PostgreSQL migration entrypoint가 있다. 검증: local PostgreSQL/Redis를 실행한 뒤 worker가 필요한 설정을 읽을 수 있다.
|
||||
- [x] [typed-queries] DB query를 type-safe하게 다루는 생성/검증 흐름이 있다. 검증: migration/query generation 흐름이 문서화되어 있다.
|
||||
- [x] [redis-boundary] Redis 사용 목적과 key prefix 기준이 worker 문서나 config에 정리되어 있다.
|
||||
- [x] [job-model] worker가 비동기 작업을 표현하고 실행할 기본 job model을 갖는다. 검증: worker job이 API 내부 구현에 의존하지 않는다.
|
||||
- [x] [storage-ports] domain과 persistence 사이의 adapter/port 경계가 정해져 있다.
|
||||
- [x] [infra-check] local PostgreSQL/Redis health를 확인하는 반복 가능한 절차가 있다. 검증: `bin/test`, `bin/lint`, `bin/build`가 통과한다.
|
||||
|
||||
## 완료 리뷰
|
||||
|
||||
- 상태: 없음
|
||||
- 요청일: 없음
|
||||
- 완료 근거: 아직 기능 Task와 Task별 검증이 충족되지 않았다.
|
||||
- 상태: 승인됨
|
||||
- 요청일: 2026-05-28
|
||||
- 완료 근거: 모든 기능 Task와 Task별 검증이 충족된 것으로 보인다. `agent-task/archive/2026/05/m-persistence-worker-backbone_1/complete.log`에서 code-server Postgres/Redis health와 worker migration smoke가 PASS로 해소되었다.
|
||||
- 리뷰 필요:
|
||||
- [ ] 사용자가 완료 결과를 확인했다
|
||||
- [ ] archive 이동을 승인했다
|
||||
- 리뷰 코멘트: 없음
|
||||
- [x] 사용자가 완료 결과를 확인했다
|
||||
- [x] archive 이동을 승인했다
|
||||
- 리뷰 코멘트: 2026-05-28 사용자 승인으로 Milestone을 완료 처리하고 archive로 이동한다.
|
||||
|
||||
## 범위 제외
|
||||
|
||||
|
|
@ -63,6 +63,8 @@ PostgreSQL, Redis, worker job model, storage boundary 기준을 묶는다.
|
|||
- 환경 불일치: 현재 실행 컨테이너에는 Docker가 없고 기본 `localhost:5432/6379`가 닫혀 있어 local compose health를 직접 확인할 수 없다.
|
||||
- field 환경 불일치: `ssh toki@toki-labs.com` macOS host에는 Docker와 `alt-postgres`가 있으나 해당 PostgreSQL은 role/db `alt` 기본값과 맞지 않고, host `localhost:6379` Redis는 열려 있지 않다.
|
||||
- 표준선(환경): repo 기준 반복 검증은 `deployments/local/docker-compose.yml`의 PostgreSQL `alt/alt`와 Redis를 `bin/infra-check`로 확인한다. 외부/field 인프라는 `DATABASE_URL`, `REDIS_URL`을 명시해 별도 확인한다.
|
||||
- 2026-05-28 검증: `go test ./...` in `services/worker`, `bin/worker-storage-check`, `bin/test`, `bin/lint`, `bin/build` 통과. `bin/infra-check`는 현재 컨테이너의 외부 DB env override와 Docker/DB client 부재로 local infra smoke를 완료하지 못했다.
|
||||
- 2026-05-28 검증: `ssh toki@192.168.0.97`의 code-server Docker network에서 `code-server-postgres` health, `code-server-redis` PING, worker migration smoke가 통과했다. 상세는 `agent-task/archive/2026/05/m-persistence-worker-backbone_1/complete.log`에 남겼다.
|
||||
- 선행 작업: Workspace Baseline
|
||||
- 후속 작업: Korea Daily Data Foundation
|
||||
- 확인 필요: 없음
|
||||
|
|
@ -2,16 +2,13 @@
|
|||
|
||||
## 활성 Phase
|
||||
|
||||
- [진행중] 기반 정렬
|
||||
- [검토중] 기반 정렬
|
||||
- 경로: `agent-roadmap/phase/foundation-alignment/PHASE.md`
|
||||
- [계획] 운영 표면
|
||||
- 경로: `agent-roadmap/phase/operator-surface/PHASE.md`
|
||||
|
||||
## 활성 Milestone
|
||||
|
||||
- [진행중] Persistence and Worker Backbone
|
||||
- Phase: `agent-roadmap/phase/foundation-alignment/PHASE.md`
|
||||
- 경로: `agent-roadmap/phase/foundation-alignment/milestones/persistence-worker-backbone.md`
|
||||
- [계획] Client Integration Clone Adoption
|
||||
- Phase: `agent-roadmap/phase/operator-surface/PHASE.md`
|
||||
- 경로: `agent-roadmap/phase/operator-surface/milestones/client-integration-clone-adoption.md`
|
||||
|
|
|
|||
|
|
@ -2,7 +2,7 @@
|
|||
|
||||
## 상태
|
||||
|
||||
[진행중]
|
||||
[검토중]
|
||||
|
||||
## 목표
|
||||
|
||||
|
|
@ -22,8 +22,8 @@ ALT가 agent-first monorepo 기준선 위에서 계약, proto-socket session loo
|
|||
- [완료] Socket Session Loop
|
||||
- 경로: `agent-roadmap/archive/phase/foundation-alignment/milestones/socket-session-loop.md`
|
||||
- 요약: proto-socket 기반 API와 Flutter client 사이의 최소 handshake/request-response loop를 닫는다.
|
||||
- [진행중] Persistence and Worker Backbone
|
||||
- 경로: `agent-roadmap/phase/foundation-alignment/milestones/persistence-worker-backbone.md`
|
||||
- [완료] Persistence and Worker Backbone
|
||||
- 경로: `agent-roadmap/archive/phase/foundation-alignment/milestones/persistence-worker-backbone.md`
|
||||
- 요약: PostgreSQL/Redis 기반의 durable storage와 비동기 worker 실행 기준을 마련한다.
|
||||
|
||||
## Phase 경계
|
||||
|
|
@ -31,3 +31,13 @@ ALT가 agent-first monorepo 기준선 위에서 계약, proto-socket session loo
|
|||
- 이 Phase는 monorepo 운영 기준, contracts/codegen, socket session boundary, storage/worker backbone까지만 다룬다.
|
||||
- 실제 market data import, backtest engine, operator 화면 완성, paper/live trading 구현은 후속 Phase에서 다룬다.
|
||||
- API는 socket/session boundary를 맡고 worker execution을 직접 소유하지 않는다.
|
||||
|
||||
## 완료 리뷰
|
||||
|
||||
- 상태: 요청됨
|
||||
- 요청일: 2026-05-28
|
||||
- 완료 근거: 하위 Milestone이 모두 `[완료]`로 정리되었고, 마지막 Persistence and Worker Backbone Milestone도 archive 이동까지 완료되었다.
|
||||
- 리뷰 필요:
|
||||
- [ ] 사용자가 Phase 완료 결과를 확인했다
|
||||
- [ ] Phase archive 이동을 승인했다
|
||||
- 리뷰 코멘트: 사용자 최종 확인 전까지 Phase는 `[검토중]`으로 유지한다.
|
||||
|
|
|
|||
|
|
@ -0,0 +1,62 @@
|
|||
# User Review Required - m-persistence-worker-backbone
|
||||
|
||||
## 요청 일시
|
||||
|
||||
2026-05-28T10:59:07Z
|
||||
|
||||
## 상태
|
||||
|
||||
RESOLVED_PASS
|
||||
|
||||
## 사유
|
||||
|
||||
- 유형: environment-blocked
|
||||
- 현재 리뷰 회차: 1
|
||||
- 최종 판정: FAIL
|
||||
- 요약: repo 표준 local compose 기반 PostgreSQL/Redis smoke와 worker migration entrypoint 실행이 Docker/local DB/Redis 부재로 완료되지 않아 자동 follow-up을 멈춥니다.
|
||||
|
||||
## 루프 이력
|
||||
|
||||
| Plan | Review | Verdict | 메모 |
|
||||
|------|--------|---------|------|
|
||||
| `agent-task/m-persistence-worker-backbone/plan_cloud_G07_0.log` | `agent-task/m-persistence-worker-backbone/code_review_cloud_G06_0.log` | FAIL | TEST-1 live local infra smoke가 Docker와 local PostgreSQL/Redis 부재로 차단됨 |
|
||||
|
||||
## 차단 근거
|
||||
|
||||
- 문제: `TEST-1`은 `bin/infra-check`와 `go run ./cmd/alt-worker-migrate`가 live local PostgreSQL/Redis에 대해 통과해야 하지만 현재 실행 환경에는 Docker CLI/daemon과 `localhost:5432`, `localhost:6379` 서비스가 없습니다.
|
||||
- 현재 archive plan: `agent-task/m-persistence-worker-backbone/plan_cloud_G07_0.log`
|
||||
- 현재 archive review: `agent-task/m-persistence-worker-backbone/code_review_cloud_G06_0.log`
|
||||
- 검증 명령: `command -v docker`; `docker compose -f deployments/local/docker-compose.yml up -d postgres redis`; `env -u DATABASE_URL -u REDIS_URL bin/infra-check`; `(cd services/worker && env -u DATABASE_URL -u REDIS_URL go run ./cmd/alt-worker-migrate)`
|
||||
- 실제 출력: `command -v docker` exit 1, `docker compose ...` exit 127 with `docker: command not found`, `bin/infra-check` exit 1 with `postgres: docker is unavailable; cannot inspect local compose service`, migration entrypoint exit 1 with `dial tcp 127.0.0.1:5432: connect: connection refused`.
|
||||
- 차단 판단 근거: `bin/test`, `bin/lint`, `bin/build`는 재실행 통과했고, 실패는 repo 코드 수정으로 해소할 수 있는 manifest/script 결함이 아니라 live infra 전제 부재입니다.
|
||||
|
||||
## 사용자 결정 필요
|
||||
|
||||
- [ ] 자동 follow-up plan/review를 계속 진행한다.
|
||||
- [ ] 계획을 재작성한다.
|
||||
- [x] 테스트 환경, secret, 외부 서비스, SDK, 장비 조건을 준비한 뒤 재시도한다.
|
||||
- [ ] 작업 범위를 줄이거나 보류/폐기한다.
|
||||
|
||||
## 해소 결과
|
||||
|
||||
- 해소 일시: 2026-05-28T11:20:18Z
|
||||
- 최종 판정: PASS
|
||||
- 사용자 결정: `ssh toki@192.168.0.97`의 `~/docker/services/code-server/compose/docker-compose.yml`에서 code-server Postgres/Redis 설정을 확인하고 해당 설정으로 smoke를 재시도한다.
|
||||
- 충족 근거:
|
||||
- `ssh toki@192.168.0.97 '/Applications/Docker.app/Contents/Resources/bin/docker exec code-server-postgres pg_isready -U nomadcode -d nomadcode'` -> `/var/run/postgresql:5432 - accepting connections`
|
||||
- `ssh toki@192.168.0.97 '/Applications/Docker.app/Contents/Resources/bin/docker exec code-server-redis redis-cli ping'` -> `PONG`
|
||||
- `ssh toki@192.168.0.97 '... docker exec code-server bash -lc "cd /config/workspace/alt/services/worker && DATABASE_URL=<private code-server Postgres URL> REDIS_URL=<private code-server Redis URL> go run ./cmd/alt-worker-migrate"'` -> `migrations completed successfully`
|
||||
- `agent-ops/rules/private/testing-env.md`에 code-server Postgres/Redis 접근 방식과 192.168.0.97 직접 포트 주의사항을 기록했다.
|
||||
|
||||
## 재개 조건
|
||||
|
||||
- 충족됨. code-server Docker network에서 `code-server-postgres:5432`와 `code-server-redis:6379`를 사용한다.
|
||||
|
||||
## 다음 실행 힌트
|
||||
|
||||
- 종료 처리 완료 후 이 task directory를 archive로 이동한다. roadmap 상태 갱신은 runtime 완료 이벤트가 처리한다.
|
||||
|
||||
## 종료 규칙
|
||||
|
||||
- 사용자가 이 stop state를 완료/PASS로 해소하면 `USER_REVIEW.md`를 해소 상태로 갱신하고, `agent-ops/skills/common/code-review/templates/complete-log-template.md` 기준 `complete.log`를 작성한 뒤 task directory를 archive로 이동한다.
|
||||
- 새 구현이 필요하면 `plan` 스킬이 `USER_REVIEW.md`를 `user_review_N.log`로 아카이브한 뒤 새 `PLAN-*-G??.md` / `CODE_REVIEW-*-G??.md`를 작성한다.
|
||||
Loading…
Reference in a new issue