[Fix] 현재까지 확인된 오류

[lyeum]

수정 예정

uv run scripts/api_verification.py -- 현재 변경로직에 맞춰서 수정이 필요
uv run pytest -- 13개의 오류 발생

---

[오류발생목록]

/state/session/{session_id}/context --500
/state/session/{session_id}/sequence/details --500
/state/session/{session_id}/enemies --500
/state/player/{player_id} --500
/state/player/{player_id}/inventory --500

--
state/session/ended 항목에 user_id 부분이 실제 세션을 진행한 user_id와 다르게 null로 남아버리는 문제.

예상 결과

local 배포로 보이는 모든 엔드포인트의 정상작동

[lyeum]

예정 계획

• 현재까지 작성한 로직들의 안정화
• Phase D | Repository/Service 레이어 관계 처리 로직을 Graph-SOT로 전면 교체 | 📋 향후 계획

[lyeum]

2026/02/06 현황

[현재 발생 오류]

state/session/{session_id}/context --500
state/player/{player_id} --500
state/session/{session_id}/items --500
state/session/{session_id}/sequence/details --500
state/sessions/ended --user_id가 null로만 저장됨

state/player/{player_id}/hp --404
state/player/{player_id}/stats --500
state/player/item/earn --500
state/player/item/use --500

>>> enemt spawn->처치 로직 검토

대부분의 로직들과 state/enemy/{enemy_id}/hp 부분에서 동작은 정상적으로 되지만, hp가 0이하가 되어도 is_defeated가 false로 고정
-- state/enemy/{enemy_id}/defeat 를 진행해야 is_defeated가 true로 바뀌는 것을 확인
--- hp 0이 되면 저절도 state/enemy/{enemy_id}/defeat가 실행되는지 확인 필요
! DELETE는 세션 종료하면 진행되도록. 처치는 단순히 enemy가 deactivate 상태로 존재하도록 설정

>>> npc spawn->퇴장 로직 검토

전체적인 로직상으로 발견된 문제는 없었음. 다만 아래 로직들은 검토해볼 필요가 있다고 판단

1. [INQUIRY] state/session/{session_id}/npcs
   시나리오에서 주입받은 npc, spawn된 npc 모두 잘 조회됨. 다만 meta 데이터 부분에서 spawn된 데이터는 아래 부분에서 반영이 안됨.
   "state": null, ## 주입 받은 npc도 null로 되어 있는게 정상인지 확인이 필요
   "assigned_sequence_id": null,
   "assigned_location": null,
   "is_departed": false

2. [StateUpdates] state/npc/affinity
   : 동작자체에는 오류가 발생하지 않지만, 수치가 부호가 붙은 변동량 형태로 들어가면 422오류가 발생. 단순 int형태는 들어가긴 하지만 수치 반영이 전혀 되지 않음

[lyeum]

plan003까지 진행이후 테스트 현황

[현재 발생오류 / 고쳐진 오류]

state/session/{session_id}/context --fix
state/player/{player_id} --fix
state/session/{session_id}/items --fix
state/session/{session_id}/sequence/details --fix
state/sessions/ended --user_id가 null로만 저장됨

state/player/{player_id}/hp --fix
state/player/{player_id}/stats --500
state/player/item/earn --404
state/player/item/use --404

---

검토할 부분

state/session/{session_id}/act/details : 엔드포인트 사라짐
state/sessions/ended: 엔드포인트 사라짐

RELATION

• player-npc relation 추가하면 sequence 조회에서 반영되는지 확인
• player과 npc relation 생성 부분이 안보여서 테스트 불가

item

• 인벤토리 업데이트 자체는 정상동작 하나 반영이 안됨. 아이템 획득, 사용 로직도 404에러가 발생

=======[체크리스트]========
affinity score 범주: -100 ~ 100 인지 확인
hp 범주: 0 ~ 100인지 확인
stats: 0 ~ 99

[lyeum]

2026/02/06 수정 현황

user_id가 조회시에 전부 null로만 저장됨

state/player/{player_id}/stats --fix
state/player/item/earn --fix
state/player/item/use --fix

검토할 부분
state/session/{session_id}/act/details : 엔드포인트 사라짐--fix
state/sessions/ended: 엔드포인트 사라짐--fix

RELATION
player-npc relation 추가하면 sequence 조회에서 반영되는지 확인 --fix
player과 npc relation 생성 부분이 안보여서 테스트 불가 --fix

item
인벤토리 업데이트 자체는 정상동작 하나 반영이 안됨. 아이템 획득, 사용 로직도 404에러가 발생 --clear
=======[체크리스트]========
affinity score 범주: -100 ~ 100 인지 확인 --적용됨
hp 범주: 0 ~ 100 --적용안되는거 같은데?
stats: 0 ~ 99

[lyeum]

2026/02/07 수정현황

• /state/player/{player_id}/hp : 0~100 범위로 설정해뒀는데 적용이 안됨.
• /state/player/{player_id}/stats: 업데이트가 적용이 안됨.
• /state/player/item/earn: item_id가 state_entity_id로 설정되어 있음 -> item_id로 변경 필요

+) 추가 오류

• stats 업데이트는 잘 적용되는데, 범위(0~99)가 적용되지 않음

---

위 문제들 해결 및 정상동작 확인