toki/alt

toki c4a457c5c4 docs(agent-ops): domain rule과 로드맵을 operator reliability refactor에 맞게 갱신한다

API domain에 workerclient proxy와 handler responsibility를 추가하고,
worker domain에 backtest engine, storage, provider, socket surface를 명시한다.
Client domain에 socket integration과 push integration 경계를 보강한다.
Operations domain에 agent-test/local과 bin 명령어를 포함하며,
operations domain table에 agent-test/local 경계를 추가한다.

로드맵에 Operator Runtime Reliability Refactor Milestone를 추가하고
현재 활성 Milestone으로 설정하여 Flutter Operator Console 전에
선행할 작업으로 변경한다.

2026-05-31 06:53:24 +09:00

3.5 KiB

Raw Blame History

domain	last_rule_review_commit	last_rule_updated_at
operations	`3b1be95e62`	2026-05-31

operations

목적 / 책임

로컬 개발, remote verification routing, workspace orchestration, operator CLI, generated output checks, and infrastructure entrypoints를 관리한다. 개발자와 agent가 반복적으로 쓰는 root-level commands, local/remote test rules, and service entrypoints stay discoverable here.

포함 경로

bin/ - workspace helper scripts
go.work - Go workspace module membership
go.work.sum - Go workspace dependency checksum
apps/cli/ - Go operator CLI for local/admin workflows
deployments/local/ - local Docker Compose infrastructure
agent-test/local/ - local profile test routing that executes on the remote test host
.gitignore - repository-level ignore policy

제외 경로

services/api/ - API runtime implementation
services/worker/ - worker runtime implementation
apps/client/ - Flutter client code
packages/domain/ and packages/contracts/ - shared model and schema sources

주요 구성 요소

bin/dev - prints local development entrypoints
bin/test - runs Go tests and Flutter tests
bin/lint - runs Go vet and Flutter analyze
bin/build - builds Go binaries and Flutter web
bin/contracts-gen - regenerates contract outputs
bin/contracts-check - checks generated contract outputs are current
bin/infra-check - checks PostgreSQL/Redis availability for the configured environment
bin/worker-storage-gen - regenerates worker sqlc outputs
bin/worker-storage-check - checks worker sqlc generated output drift
deployments/local/docker-compose.yml - PostgreSQL and Redis local stack
apps/cli/cmd/alt/main.go - operator CLI scaffold
agent-test/local/rules.md - local profile routing with remote host execution policy

유지할 패턴

Keep root helper scripts executable, idempotent where practical, and set -euo pipefail.
Prefer root bin/* commands for whole-workspace workflows.
Keep contract codegen/check scripts under bin/ and route schema ownership back to packages/contracts.
Keep worker storage codegen/check scripts under bin/ and route schema/query ownership back to services/worker/internal/storage/postgres.
Keep local infrastructure defaults aligned with worker/API environment fallback values.
Add new Go modules to go.work when they are part of local development.
Treat agent-test/local as a local profile whose commands run from the remote ALT checkout; do not imply local shell execution when local testing is forbidden.
Keep root scripts explicit: generated drift checks should fail loudly and tell the user which generation command to run.

다른 도메인과의 경계

api and worker: operations starts, tests, and builds services; service behavior belongs to each service domain.
client: operations invokes Flutter commands; UI implementation stays under apps/client.
contracts: operations may run codegen later; schema design remains in contracts.
agent-test: operations owns routing to test profiles, but domain-specific smoke criteria remain in each agent-test/local/*-smoke.md document.

금지 사항

Do not put application business logic in shell scripts.
Do not commit local secrets or machine-specific state.
Do not make root scripts silently skip failing module checks.
Do not record raw remote paths, tokens, passwords, account numbers, or personal endpoints in tracked test rules or command output.

3.5 KiB Raw Blame History