Skip to content

feat(arena): 체험 공간 설정 저장·조회 API와 블록 검증 연동 (#159) - #160

Merged
exijn merged 1 commit into
developfrom
feature/159-experience-arena-settings
Nov 12, 2026
Merged

exijn merged 1 commit into
developfrom
feature/159-experience-arena-settings

Conversation

@exijn

@exijn exijn commented Nov 12, 2026

Copy link
Copy Markdown
Member

Closes #159

⚠️ 머지하지 마세요(라벨 do-not-merge). develop 머지 = 운영 CD 즉시 실행이고, 이 PR 은 DB 마이그레이션 V20 을 포함합니다.

변경

  • domain/arena: 설정 모델(검증·파생 값), 프리셋 2종, 저장(단일 행)·이력 테이블(V20), 서비스, 컨트롤러
    • GET /api/v1/arena-settings, GET /api/v1/arena-settings/presets(공개), PUT /api/v1/admin/arena-settings, GET /api/v1/admin/arena-settings/history(관리자)
  • maxMovePerCommandM = min(3.0, 내림0.1(가용 영역 짧은 변 − 0.8)) — 이동 후에도 제자리 회전 지름 0.8 m 확보. 6×6 → 3.0 / 3×3 → 1.2. defaultMoveDistanceM 6×6 → 1.0 / 3×3 → 0.5.
  • 블록 파라미터 범위·실행 한도 검증과 PRESET 옵션 공개 #118 검증(BlockProgramLimitValidator), 블록 카탈로그, AI 초안 검증이 위 값을 따른다. 설정이 없으면(또는 DB 없는 구성) DefaultArenaSettingsProvider(6×6) → 기존과 동일.
  • 문서 docs/arena-settings.md

판단

  • 벽 여유·출발점·이동 한도를 따로 두지 않고 공간에서 계산한다: 한 값만 바꿔도 안전 경계가 어긋나지 않게(요청의 표와 같은 결과 — 3×3 에서 0.5/2.0/1.2/0.5).
  • 한 변 상한은 Agent 코드의 하드 상한 6 m(feat(execution): capability-aware Robot allocation 연결 #95)에 맞췄다(요청 문서의 8 m 와 다름 — Agent 쪽 코드는 6.0).

테스트

전체 397건 통과(신규 13). 프리셋 계산, 하한·상한·출발점 검증, 3×3 에서 1.3 m 이동 거부, 6×6 기본값 불변, 관리자 인증 경계, 이력, 잘못된 값이 아무것도 바꾸지 않음.

🤖 Generated with Claude Code

- 가로·세로·벽 여유·출발점·방향 저장, 프리셋 6x6-박람회/3x3-부스, 변경 이력
- 공간에서 1회 이동 한도·기본 이동 거리를 계산해 #118 검증·블록 카탈로그·AI 초안 검증에 반영
- 설정이 없으면 6x6 기본값(기존 동작)

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
@exijn exijn added feature 새로운 기능 작업 ai POPPY ai needs-human 사람 확인·결정이 필요해 자동 머지하지 않음 do-not-merge 머지하면 운영 CD 가 돈다 — 사람이 시점을 정한다 labels Nov 12, 2026
@github-actions github-actions Bot added the test 테스트 관련 작업 label Nov 12, 2026
@exijn
exijn merged commit ee858ca into develop Nov 12, 2026
3 checks passed
@exijn
exijn deleted the feature/159-experience-arena-settings branch November 12, 2026 08:22
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ai POPPY ai do-not-merge 머지하면 운영 CD 가 돈다 — 사람이 시점을 정한다 feature 새로운 기능 작업 needs-human 사람 확인·결정이 필요해 자동 머지하지 않음 test 테스트 관련 작업

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant