From d775dd73d8c55237cb509d89568af51e68e12c5a Mon Sep 17 00:00:00 2001 From: overhyeon <105336318+overhyeon@users.noreply.github.com> Date: Mon, 9 Nov 2026 03:06:49 +0900 Subject: [PATCH 1/6] =?UTF-8?q?feat:=20=EC=9E=AC=EA=B3=A0=20=EB=8F=84?= =?UTF-8?q?=EA=B5=AC=EA=B0=80=20=ED=95=99=EC=83=9D=20JWT=EB=A1=9C=20?= =?UTF-8?q?=EB=B0=B1=EC=97=94=EB=93=9C=20=EC=8B=A4=EB=8D=B0=EC=9D=B4?= =?UTF-8?q?=ED=84=B0=EB=A5=BC=20=EC=A1=B0=ED=9A=8C=ED=95=98=EB=8F=84?= =?UTF-8?q?=EB=A1=9D=20=EB=B3=80=EA=B2=BD?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- app.py | 18 +++++++++++++++--- tools.py | 54 ++++++++++++++++++++++++++++++++++++++++++++++++------ 2 files changed, 63 insertions(+), 9 deletions(-) diff --git a/app.py b/app.py index bd91e02..86d423d 100644 --- a/app.py +++ b/app.py @@ -14,6 +14,7 @@ import llm from search import search +import tools from tools import TOOLS load_dotenv() @@ -199,7 +200,11 @@ def build_system_instruction(docs: list[dict], today: str | None = None) -> str: ) -async def relay(req: Request, messages: list[Msg]): +async def relay(req: Request, messages: list[Msg], user_token: str | None): + # 학생 JWT를 이 요청 동안만 도구가 볼 수 있게 넣어 둔다(tools.user_token 설명 참고). + # 여기(스트림을 실제로 만드는 곳)에서 넣어야 도구가 호출될 때 같은 값이 보인다. + tools.user_token.set(user_token) + # 검색부터 전부 try 안에서 한다. # StreamingResponse는 이 함수가 돌기 전에 이미 200과 헤더를 보냈기 때문에, # 여기서 밖으로 튀는 예외는 error 이벤트도 없이 연결만 끊는다. 클라이언트는 이유를 모른다. @@ -238,11 +243,18 @@ async def relay(req: Request, messages: list[Msg]): @app.post("/chat") -async def chat(req: Request, body: ChatReq, user_id: int | None = Depends(verify_backend)): +async def chat( + req: Request, + body: ChatReq, + user_id: int | None = Depends(verify_backend), + x_user_token: str | None = Header(default=None), +): # user_id는 아직 쓰지 않는다. 개인 데이터 조회 도구(#52)가 이 값으로만 조회한다. # 모델이 정한 값을 쓰면 다른 학생 정보를 물어 꺼낼 수 있기 때문이다. + # x_user_token: 백엔드가 넘겨준 학생 JWT. 도구가 백엔드 학생 API를 조회할 때 쓴다(#69). + # 검사는 백엔드가 이미 끝냈다. 여기서는 그대로 전달만 하고, 로그에 남기지 않는다. return StreamingResponse( - relay(req, body.messages), + relay(req, body.messages, x_user_token), media_type="text/event-stream", headers={"Cache-Control": "no-cache", "X-Accel-Buffering": "no"}, ) diff --git a/tools.py b/tools.py index b695ba7..82a60a0 100644 --- a/tools.py +++ b/tools.py @@ -12,15 +12,41 @@ """ import logging +import os +from contextvars import ContextVar from datetime import datetime from zoneinfo import ZoneInfo +import httpx +from dotenv import load_dotenv + +load_dotenv() + logger = logging.getLogger(__name__) +# ───────────────────────────────────────────────────────────── +# 백엔드 연결 (#69) +# ───────────────────────────────────────────────────────────── +# 백엔드 주소. 배포에서는 같은 도커 네트워크 안의 내부 주소를 넣는다(예: http://<백엔드 컨테이너 이름>:8080). +# 비어 있으면 아래 가짜 응답을 쓴다. 로컬 개발과 평가(eval.py)는 학생 토큰이 없어서 가짜 응답으로 돈다. +BACKEND_BASE_URL = os.getenv("BACKEND_BASE_URL", "").rstrip("/") +if os.getenv("ENV", "dev") == "prod" and not BACKEND_BASE_URL: + # 배포에서 빠뜨리면 학생에게 가짜 재고를 진짜처럼 보여주게 된다. 조용히 뜨지 않고 멈춘다. + raise RuntimeError("ENV=prod 인데 환경변수 BACKEND_BASE_URL이 없습니다. 백엔드 내부 주소를 넣으세요.") + +# 백엔드가 느리면 답변 전체가 기다린다. 재고 하나 조회에 5초 넘게 걸리면 실패로 보고 안내 문구로 답한다. +BACKEND_TIMEOUT_SECONDS = 5 + +# 지금 질문한 학생의 JWT. app.py가 요청마다 넣고, 도구 함수 안에서만 꺼내 쓴다. +# ContextVar: 요청마다 따로 보관되는 변수다. 여러 학생이 동시에 질문해도 서로의 토큰이 섞이지 않는다. +# 함수 인자로 받지 않는 이유: 인자는 모델이 채운다. 모델이 토큰을 보면 답변으로 샐 수 있고, 다른 값을 넣을 수도 있다. +# 이 토큰은 학생의 쓰기 권한까지 갖고 있다. 그래서 이 파일에는 조회(GET) 도구만 둔다(로드맵 「학생 토큰 전달」). +user_token: ContextVar[str | None] = ContextVar("user_token", default=None) + TYPE_LABELS = {"RENTAL": "대여품", "CONSUMABLE": "소모품"} # ───────────────────────────────────────────────────────────── -# 가짜 응답 — 백엔드 AI 서버 전용 재고 API가 생기기 전까지 쓴다 +# 가짜 응답 — 백엔드 주소가 없을 때(로컬 개발·평가) 쓴다 # ───────────────────────────────────────────────────────────── # 모양은 stream-server의 `GET /v1/app/billilge/items` 실제 응답과 같다 # (ApiResponse → CursorSliceResponse → ItemListItemResponse). @@ -28,7 +54,7 @@ # # 품목과 수량은 test_data/billilge.json(골든셋 기준 데이터)과 맞췄다. # 그 파일은 예전 빌릴게 백엔드 모양(itemName, itemType)이라 직접 읽지 않는다. -# 학생 앱 API는 학생 로그인(JWT)이 있어야 해서 AI 서버가 부를 수 없다. 내부 API가 따로 필요하다. +# 학생 앱 API는 학생 로그인(JWT)이 있어야 한다. 그래서 백엔드가 중계할 때 학생 JWT를 같이 넘겨 준다(#69). _FAKE_RESPONSE = { "success": True, "code": "SUCCESS", @@ -50,12 +76,28 @@ def _fetch_items() -> list[dict]: - """백엔드에서 물품 목록을 받아 온다. 지금은 가짜 응답을 돌려준다. + """백엔드에서 물품 목록을 받아 온다. 백엔드 주소가 없으면 가짜 응답을 돌려준다. + + 학생 앱이 쓰는 `GET /v1/app/billilge/items`를 그 학생의 JWT로 부른다. + 백엔드 목록은 이름순이고 한 번에 최대 100개다. 품목이 100개를 넘을 일은 당분간 없으므로 첫 페이지만 받는다. - 실제 API로 바꿀 때 이 함수만 고친다(#50). 백엔드 목록은 이름순이고 한 번에 최대 100개다. - 품목이 100개를 넘을 일은 당분간 없으므로 첫 페이지만 받는다. + 실패하면 예외를 던진다. 부르는 쪽(`get_item_stock`)이 잡아서 "확인할 수 없다"는 안내로 바꾼다. """ - response = _FAKE_RESPONSE + if not BACKEND_BASE_URL: + response = _FAKE_RESPONSE + else: + token = user_token.get() + if not token: + raise RuntimeError("학생 토큰(X-User-Token)이 없어 재고를 조회할 수 없습니다") + # 토큰은 로그에 남기지 않는다. 예외 메시지에도 주소만 들어가고 헤더는 들어가지 않는다. + r = httpx.get( + f"{BACKEND_BASE_URL}/v1/app/billilge/items", + params={"size": 100}, + headers={"Authorization": f"Bearer {token}"}, + timeout=BACKEND_TIMEOUT_SECONDS, + ) + r.raise_for_status() + response = r.json() if not response["success"]: raise RuntimeError(f"재고 API 실패: {response['code']}") return response["data"]["content"] From 96bc4c7e8d2f7e25771737ea715bbc3f95103d35 Mon Sep 17 00:00:00 2001 From: overhyeon <105336318+overhyeon@users.noreply.github.com> Date: Mon, 9 Nov 2026 03:06:49 +0900 Subject: [PATCH 2/6] =?UTF-8?q?docs:=20X-User-Token=20=EA=B3=84=EC=95=BD?= =?UTF-8?q?=EA=B3=BC=20BACKEND=5FBASE=5FURL=20=EB=B0=B0=ED=8F=AC=20?= =?UTF-8?q?=EC=95=88=EB=82=B4=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .env.example | 6 ++++++ AGENTS.md | 1 + docs/guides/deploy.md | 5 ++++- 3 files changed, 11 insertions(+), 1 deletion(-) diff --git a/.env.example b/.env.example index 6dbd0f5..01bebfe 100644 --- a/.env.example +++ b/.env.example @@ -9,6 +9,12 @@ KMU_AI_API_KEY= # 게이트웨이 주소. 바꿀 일이 없으면 비워 둔다(기본값이 들어간다). # LLM_BASE_URL=https://ai.cs.kookmin.ac.kr/v1 +# ─── 백엔드 연결 (재고 같은 실시간 조회) ────────────────────── +# 백엔드 주소. 도구가 학생 JWT(X-User-Token)로 백엔드 학생 API를 조회한다. +# 비워 두면 tools.py의 가짜 응답을 쓴다. 로컬 개발과 평가(eval.py)는 비워 둔다(학생 토큰이 없다). +# ENV=prod 인데 비어 있으면 서버가 뜨지 않는다. +BACKEND_BASE_URL= + # ─── 평가용 Gemini (eval.py만 쓴다, 서버는 쓰지 않는다) ───────── # eval.py의 채점기와 예전 답변 경로가 Gemini를 쓴다. 서버를 띄우기만 할 거면 없어도 된다. # diff --git a/AGENTS.md b/AGENTS.md index c26adce..2d40575 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -93,6 +93,7 @@ GET /health POST /chat 헤더: X-Internal-Token, X-User-Id (토큰 불일치 401, 사용자 ID가 양의 정수가 아니면 400) + X-User-Token (학생 JWT. 도구가 백엔드 학생 API를 조회할 때만 쓴다. 없으면 실시간 조회가 "확인할 수 없음"으로 답한다) 본문: { "messages": [ { "role": "user" | "model", "text": str } ] } 응답: SSE 스트림 ``` diff --git a/docs/guides/deploy.md b/docs/guides/deploy.md index d2d13d9..e009bc2 100644 --- a/docs/guides/deploy.md +++ b/docs/guides/deploy.md @@ -39,10 +39,11 @@ Coolify 리소스의 Environment Variables에 넣는다. 저장소에는 올리 | `INTERNAL_TOKEN` | 새로 만든 값. 백엔드의 `STREAM_AI_INTERNAL_TOKEN`과 **같은 값** | | `LLM_MODEL` | `gpt-oss-120b` (모델 선정 근거: `eval/model-comparison.md`) | | `KMU_AI_API_KEY` | 학교 AI 게이트웨이 키. **실험용과 다른 운영 전용 키**를 쓴다 | +| `BACKEND_BASE_URL` | `http://:8080`. 재고 같은 실시간 조회에 쓴다(#69) | 토큰 만들기: `python -c "import secrets; print(secrets.token_urlsafe(32))"` -`ENV=prod`인데 `INTERNAL_TOKEN`이 비어 있으면 서버가 뜨지 않는다. `LLM_MODEL`이나 `KMU_AI_API_KEY`가 없어도 뜨지 않는다. +`ENV=prod`인데 `INTERNAL_TOKEN`이 비어 있으면 서버가 뜨지 않는다. `LLM_MODEL`, `KMU_AI_API_KEY`, `BACKEND_BASE_URL`이 없어도 뜨지 않는다. 일부러 그렇게 만들었다. 서버가 떠 있는데 질문마다 실패하는 것보다 원인을 찾기 쉽다. **main에 머지하면 바로 배포된다.** 새 환경변수가 필요한 변경은 환경변수를 먼저 넣고 머지한다. @@ -89,6 +90,8 @@ curl -s -o /dev/null -w "%{http_code}\n" https://ai.cs.kookmin.ac.kr/v1/models | 컨테이너가 바로 죽음, 로그에 `LLM_MODEL 또는 KMU_AI_API_KEY가 없습니다` | 2번 환경변수 누락 | | 질문하면 `error` 이벤트, 로그에 `401 Unauthorized` (`ai.cs.kookmin.ac.kr`) | 게이트웨이 키가 틀렸거나 막혔다. 값 끝에 다른 글자가 붙지 않았는지, 게이트웨이 관리 화면에서 키 상태·남은 크레딧을 본다 | | 질문하면 `error` 이벤트, 로그에 `ConnectError` 또는 시간 초과 | 3번. Coolify 서버에서 게이트웨이로 나가지 못한다 | +| 컨테이너가 바로 죽음, 로그에 `BACKEND_BASE_URL이 없습니다` | 2번 환경변수 누락 | +| 재고를 물으면 "확인할 수 없어요", 로그에 `재고 조회 실패` | `BACKEND_BASE_URL`이 틀렸거나, 백엔드가 학생 JWT(`X-User-Token`)를 넘기지 않는다(stream-server #309 배포 여부) | | 백엔드 로그에 `status=401` | 양쪽 토큰이 다르다 | | 백엔드 로그에 연결 실패 | 같은 네트워크가 아니거나 `STREAM_AI_BASE_URL`의 컨테이너 이름이 틀렸다 | | Coolify 빌드 실패 | Coolify 빌드 로그를 본다. 로컬에서 `docker build .`가 되는지 먼저 확인한다 | From d362334c21f8d40ffe48ca70a10f407582062c32 Mon Sep 17 00:00:00 2001 From: overhyeon <105336318+overhyeon@users.noreply.github.com> Date: Mon, 16 Nov 2026 18:28:33 +0900 Subject: [PATCH 3/6] =?UTF-8?q?feat:=20=ED=95=99=EC=83=9D=20=EB=B3=B8?= =?UTF-8?q?=EC=9D=B8=EC=9D=98=20=EB=8C=80=EC=97=AC=20=ED=98=84=ED=99=A9?= =?UTF-8?q?=EA=B3=BC=20=EB=B0=98=EB=82=A9=20=EA=B8=B0=ED=95=9C=EC=9D=84=20?= =?UTF-8?q?=EC=A1=B0=ED=9A=8C=ED=95=98=EB=8A=94=20=EB=8F=84=EA=B5=AC=20?= =?UTF-8?q?=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- tools.py | 168 ++++++++++++++++++++++++++++++++++++++++++++++++------- 1 file changed, 149 insertions(+), 19 deletions(-) diff --git a/tools.py b/tools.py index 82a60a0..b8db7f5 100644 --- a/tools.py +++ b/tools.py @@ -14,7 +14,7 @@ import logging import os from contextvars import ContextVar -from datetime import datetime +from datetime import datetime, timedelta from zoneinfo import ZoneInfo import httpx @@ -84,23 +84,32 @@ def _fetch_items() -> list[dict]: 실패하면 예외를 던진다. 부르는 쪽(`get_item_stock`)이 잡아서 "확인할 수 없다"는 안내로 바꾼다. """ if not BACKEND_BASE_URL: - response = _FAKE_RESPONSE - else: - token = user_token.get() - if not token: - raise RuntimeError("학생 토큰(X-User-Token)이 없어 재고를 조회할 수 없습니다") - # 토큰은 로그에 남기지 않는다. 예외 메시지에도 주소만 들어가고 헤더는 들어가지 않는다. - r = httpx.get( - f"{BACKEND_BASE_URL}/v1/app/billilge/items", - params={"size": 100}, - headers={"Authorization": f"Bearer {token}"}, - timeout=BACKEND_TIMEOUT_SECONDS, - ) - r.raise_for_status() - response = r.json() - if not response["success"]: - raise RuntimeError(f"재고 API 실패: {response['code']}") - return response["data"]["content"] + return _FAKE_RESPONSE["data"]["content"] + return _backend_get("/v1/app/billilge/items", {"size": 100})["content"] + + +def _backend_get(path: str, params: dict | None = None): + """학생 JWT로 백엔드 학생 앱 API 하나를 불러 응답의 `data`를 돌려준다. 실패하면 예외를 던진다. + + 재고·내 대여·내 사물함 도구가 모두 같은 방식으로 부르므로 한곳에 모았다(#79). + 백엔드 응답은 항상 `{"success": ..., "code": ..., "data": ...}` 모양이다(ApiResponse). + `data`는 비어 있을 수 있다(예: 배정된 사물함이 없으면 null). + """ + token = user_token.get() + if not token: + raise RuntimeError("학생 토큰(X-User-Token)이 없어 백엔드를 조회할 수 없습니다") + # 토큰은 로그에 남기지 않는다. 예외 메시지에도 주소만 들어가고 헤더는 들어가지 않는다. + r = httpx.get( + f"{BACKEND_BASE_URL}{path}", + params=params, + headers={"Authorization": f"Bearer {token}"}, + timeout=BACKEND_TIMEOUT_SECONDS, + ) + r.raise_for_status() + response = r.json() + if not response.get("success"): + raise RuntimeError(f"백엔드 API 실패: {path} code={response.get('code')}") + return response.get("data") def get_item_stock(item_name: str = "") -> dict: @@ -149,5 +158,126 @@ def get_item_stock(item_name: str = "") -> dict: return result +# ───────────────────────────────────────────────────────────── +# 내 대여 (#79) — 개인별 데이터라 질문한 학생 본인 것만 조회한다 +# ───────────────────────────────────────────────────────────── +# 백엔드 대여 상태값을 학생이 앱에서 보는 말로 바꾼다. 모델이 영어 상태값을 그대로 말하지 않게 한다. +RENTAL_STATUS_LABELS = { + "PENDING": "신청함(승인 대기)", + "CONFIRMED": "승인됨(아직 안 받아 감)", + "REJECTED": "거절됨", + "CANCEL": "신청 취소함", + "RENTAL": "대여 중", + "RETURN_PENDING": "반납 신청함(확인 대기)", + "RETURN_CONFIRMED": "반납 승인됨(최종 확인 대기)", + "RETURNED": "반납 완료", +} + +# 끝난 대여(반납 완료·취소·거절)는 최근 몇 건만 보여준다. 다 넘기면 오래된 기록까지 모델 입력이 길어진다. +# "반납 처리됐어?" 같은 질문에 답할 만큼만 남긴다. +FINISHED_RENTAL_STATUSES = {"RETURNED", "CANCEL", "REJECTED"} +RECENT_FINISHED_LIMIT = 3 + + +def _fake_my_rentals() -> tuple[list[dict], list[dict]]: + """백엔드 주소가 없을 때(로컬 개발·평가) 쓸 가짜 대여 기록. (전체 이력, 반납해야 하는 목록) 순서다. + + 모양은 `GET /histories`의 `data.histories`, `GET /histories/return-required`의 `data.rentalHistories`와 같다. + 날짜를 고정하면 며칠 뒤 평가에서 전부 "기한 지남"이 되므로 지금 시각 기준으로 만든다. + """ + now = datetime.now(ZoneInfo("Asia/Seoul")).replace(second=0, microsecond=0) + rented = now - timedelta(days=1) + due = (rented + timedelta(days=3)).replace(hour=17, minute=0) # 빌린 날 + 3일, 17시 마감 + histories = [ + {"rentalHistoryId": 12, "itemName": "우산", "itemImageUrl": None, + "rentAt": (now + timedelta(hours=2)).isoformat(timespec="seconds"), "returnedAt": None, "status": "PENDING"}, + {"rentalHistoryId": 11, "itemName": "보조배터리", "itemImageUrl": None, + "rentAt": rented.isoformat(timespec="seconds"), "returnedAt": None, "status": "RENTAL"}, + {"rentalHistoryId": 9, "itemName": "HDMI 케이블", "itemImageUrl": None, + "rentAt": (now - timedelta(days=10)).isoformat(timespec="seconds"), + "returnedAt": (now - timedelta(days=8)).isoformat(timespec="seconds"), "status": "RETURNED"}, + ] + return_required = [ + {"rentalHistoryId": 11, "itemName": "보조배터리", "itemImageUrl": None, + "status": "RENTAL", "dueAt": due.isoformat(timespec="seconds")}, + ] + return histories, return_required + + +def _fetch_my_rentals() -> tuple[list[dict], list[dict]]: + """학생 본인의 대여 이력 전체와 반납해야 하는 목록을 받아 온다. 실패하면 예외를 던진다. + + 두 API를 부르는 이유: 이력(`/histories`)에는 반납 기한이 없고, 반납 기한은 `/histories/return-required`만 준다. + 반대로 반납 목록에는 승인 대기 같은 아직 안 받아 간 신청이 없다. 그래서 둘을 대여 ID로 맞춰 합친다. + """ + if not BACKEND_BASE_URL: + return _fake_my_rentals() + histories = (_backend_get("/v1/app/billilge/histories") or {}).get("histories") or [] + required = (_backend_get("/v1/app/billilge/histories/return-required") or {}).get("rentalHistories") or [] + return histories, required + + +def _to_datetime(value: str | None) -> datetime | None: + """백엔드 시각 문자열('2026-11-17T17:00:00')을 한국 시각 datetime으로. 없으면 None.""" + if not value: + return None + return datetime.fromisoformat(value).replace(tzinfo=ZoneInfo("Asia/Seoul")) + + +def _fmt(value: datetime | None) -> str | None: + """모델에게 넘길 시각 표기. 요일을 붙여야 "내일까지예요"처럼 말하기 쉽다.""" + if value is None: + return None + weekday = "월화수목금토일"[value.weekday()] + return value.strftime(f"%Y-%m-%d({weekday}) %H:%M") + + +def get_my_rentals() -> dict: + """질문한 학생 본인이 빌렸거나 신청한 빌릴게 물품과 반납 기한을 조회한다. + + 학생이 내가 빌린 물품, 반납 기한, 언제까지 돌려줘야 하는지, 연체됐는지, + 내 대여 신청이 승인됐는지, 반납 처리가 됐는지 물을 때 부른다. + 물품이 남았는지(재고)는 이 함수가 아니라 get_item_stock으로 조회한다. + """ + # 결과는 개인정보라 로그에 남기지 않는다. 불렸다는 사실만 남긴다. + logger.info("도구 호출: get_my_rentals()") + now = datetime.now(ZoneInfo("Asia/Seoul")) + + try: + histories, required = _fetch_my_rentals() + except Exception: + logger.exception("내 대여 조회 실패") + return {"조회성공": False, "안내": "지금 대여 내역을 확인할 수 없어요. Stream 빌릴게 화면의 내 대여에서 확인해 주세요."} + + due_by_id = {r["rentalHistoryId"]: _to_datetime(r.get("dueAt")) for r in required} + + in_progress, finished = [], [] + for h in histories: # 백엔드가 최근 신청순으로 준다 + status = h["status"] + rent_at = _to_datetime(h.get("rentAt")) + item = {"물품": h.get("itemName") or "(삭제된 물품)", "상태": RENTAL_STATUS_LABELS.get(status, status)} + if status in FINISHED_RENTAL_STATUSES: + if len(finished) < RECENT_FINISHED_LIMIT: + if status == "RETURNED": + item["반납시각"] = _fmt(_to_datetime(h.get("returnedAt"))) + finished.append(item) + continue + if status in ("PENDING", "CONFIRMED"): + # 받아 가기 전에는 rentAt이 학생이 고른 희망 수령 시각이다. 받아 가면 실제 수령 시각으로 바뀐다. + item["수령예정시각"] = _fmt(rent_at) + else: + item["수령시각"] = _fmt(rent_at) + due = due_by_id.get(h["rentalHistoryId"]) + if due: + item["반납기한"] = _fmt(due) + item["기한지남"] = now > due + in_progress.append(item) + + result = {"조회성공": True, "조회시각": _fmt(now), "진행중": in_progress, "최근끝난대여": finished} + if not in_progress: + result["안내"] = "지금 빌리고 있거나 신청해 둔 물품이 없어요." + return result + + # app.py가 모델에 넘기는 도구 목록. 새 도구를 만들면 여기에 추가한다. -TOOLS = [get_item_stock] +TOOLS = [get_item_stock, get_my_rentals] From 96a5b7bb258f14c9ee03b0490c56633abe3e01a7 Mon Sep 17 00:00:00 2001 From: overhyeon <105336318+overhyeon@users.noreply.github.com> Date: Mon, 16 Nov 2026 18:28:53 +0900 Subject: [PATCH 4/6] =?UTF-8?q?feat:=20=ED=95=99=EC=83=9D=20=EB=B3=B8?= =?UTF-8?q?=EC=9D=B8=EC=97=90=EA=B2=8C=20=EB=B0=B0=EC=A0=95=EB=90=9C=20?= =?UTF-8?q?=EC=82=AC=EB=AC=BC=ED=95=A8=20=EC=9C=84=EC=B9=98=EC=99=80=20?= =?UTF-8?q?=EC=82=AC=EC=9A=A9=20=EA=B8=B0=EA=B0=84=EC=9D=84=20=EC=A1=B0?= =?UTF-8?q?=ED=9A=8C=ED=95=98=EB=8A=94=20=EB=8F=84=EA=B5=AC=20=EC=B6=94?= =?UTF-8?q?=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- tools.py | 72 +++++++++++++++++++++++++++++++++++++++++++++++++++++++- 1 file changed, 71 insertions(+), 1 deletion(-) diff --git a/tools.py b/tools.py index b8db7f5..686f8bf 100644 --- a/tools.py +++ b/tools.py @@ -279,5 +279,75 @@ def get_my_rentals() -> dict: return result +# ───────────────────────────────────────────────────────────── +# 내 사물함 (#79) — 개인별 데이터라 질문한 학생 본인 것만 조회한다 +# ───────────────────────────────────────────────────────────── +LOCKER_STATUS_LABELS = {"ASSIGNED": "사용 중", "EXPIRED": "사용 기간 끝남"} + +# 가짜 응답. 모양은 `GET /v1/app/lockers/applications`의 data, `GET /v1/app/lockers/sections`의 data와 같다. +# 위치는 골든셋 32번 정답요지와 맞췄다. +_FAKE_LOCKER_APPLICATIONS = {"applications": [ + {"lockerApplicationId": 5, "lockerPeriodId": 2, "lockerPeriodName": "2026-2학기 사물함", + "applicationStatus": "ASSIGNED", "appliedAt": "2026-09-01T10:03:00", + "usageStartDate": "2026-09-01", "usageEndDate": "2026-12-19", + "sectionId": 4, "lockerLabel": "17"}, +]} +_FAKE_LOCKER_SECTIONS = {"sections": [ + {"sectionId": 3, "section": "미래관 3층 A구역", "availableCount": 2, "totalCount": 40, + "availabilityStatus": "AVAILABLE", "hasMine": False}, + {"sectionId": 4, "section": "미래관 4층 B구역", "availableCount": 8, "totalCount": 40, + "availabilityStatus": "AVAILABLE", "hasMine": True}, +]} + + +def _fetch_my_lockers() -> tuple[list[dict], dict[int, str]]: + """학생 본인의 사물함 배정 목록과 {구역ID: 구역 이름}을 받아 온다. 실패하면 예외를 던진다. + + 배정 목록에는 구역 번호(sectionId)만 있고 "미래관 4층 B구역" 같은 이름이 없다. + 이름은 그 회차의 구역 목록(`/lockers/sections`)에만 있어서 한 번 더 부른다. 위치를 묻는 질문이라 이름이 꼭 필요하다. + """ + if not BACKEND_BASE_URL: + applications = _FAKE_LOCKER_APPLICATIONS["applications"] + return applications, {s["sectionId"]: s["section"] for s in _FAKE_LOCKER_SECTIONS["sections"]} + + # 배정된 사물함이 없으면 백엔드가 data를 null로 준다. + applications = (_backend_get("/v1/app/lockers/applications") or {}).get("applications") or [] + section_names = {} + for period_id in {a["lockerPeriodId"] for a in applications}: + sections = (_backend_get("/v1/app/lockers/sections", {"lockerPeriodId": period_id}) or {}).get("sections") or [] + section_names.update({s["sectionId"]: s["section"] for s in sections}) + return applications, section_names + + +def get_my_locker() -> dict: + """질문한 학생 본인에게 배정된 사물함의 위치(구역·번호)와 사용 기간을 조회한다. + + 학생이 내 사물함이 어디인지, 몇 번인지, 언제까지 쓸 수 있는지, 사물함 신청이 됐는지 물을 때 부른다. + 사물함 신청 방법이나 신청 기간 같은 안내는 이 함수가 아니라 참고 문서에 있다. + """ + # 결과는 개인정보라 로그에 남기지 않는다. 불렸다는 사실만 남긴다. + logger.info("도구 호출: get_my_locker()") + + try: + applications, section_names = _fetch_my_lockers() + except Exception: + logger.exception("내 사물함 조회 실패") + return {"조회성공": False, "안내": "지금 사물함 정보를 확인할 수 없어요. Stream 사물함 화면에서 확인해 주세요."} + + if not applications: + return {"조회성공": True, "사물함": [], "안내": "배정된 사물함이 없어요."} + + return {"조회성공": True, "사물함": [ + { + "회차": a.get("lockerPeriodName"), + "구역": section_names.get(a.get("sectionId")), + "번호": a.get("lockerLabel"), + "상태": LOCKER_STATUS_LABELS.get(a.get("applicationStatus"), a.get("applicationStatus")), + "사용기간": f"{a.get('usageStartDate') or ''} ~ {a.get('usageEndDate') or ''}", + } + for a in applications + ]} + + # app.py가 모델에 넘기는 도구 목록. 새 도구를 만들면 여기에 추가한다. -TOOLS = [get_item_stock, get_my_rentals] +TOOLS = [get_item_stock, get_my_rentals, get_my_locker] From 8587765d16b4ea19dae0b5e5a0037ceee9114e2c Mon Sep 17 00:00:00 2001 From: overhyeon <105336318+overhyeon@users.noreply.github.com> Date: Mon, 16 Nov 2026 18:29:51 +0900 Subject: [PATCH 5/6] =?UTF-8?q?feat:=20=EC=8B=9C=EC=8A=A4=ED=85=9C=20?= =?UTF-8?q?=ED=94=84=EB=A1=AC=ED=94=84=ED=8A=B8=EC=97=90=20=EB=82=B4=20?= =?UTF-8?q?=EB=8C=80=EC=97=AC=C2=B7=EB=82=B4=20=EC=82=AC=EB=AC=BC=ED=95=A8?= =?UTF-8?q?=20=EB=8F=84=EA=B5=AC=20=EC=82=AC=EC=9A=A9=20=EA=B7=9C=EC=B9=99?= =?UTF-8?q?=20=EC=B6=94=EA=B0=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- prompts/system_v2.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/prompts/system_v2.md b/prompts/system_v2.md index fa77163..79cdddb 100644 --- a/prompts/system_v2.md +++ b/prompts/system_v2.md @@ -29,6 +29,14 @@ - 조회에 실패하면 수량을 짐작하지 않고, 도구가 준 안내 문구대로 답합니다. - 도구로 조회한 내용은 출처를 "출처: Stream 빌릴게 실시간 재고"로 표시합니다. +6. 학생 본인의 대여 내역·반납 기한은 `get_my_rentals`, 본인 사물함 위치는 `get_my_locker` 도구로 조회해서 답합니다. + 이 정보는 질문한 학생 한 명의 것이라 문서에는 없습니다. 짐작하거나 문서 내용으로 답하지 않습니다. + - 반납 기한은 날짜와 시각을 함께 굵게 알려줍니다. (예: "보조배터리는 **11월 18일(수) 17시**까지 반납해야 해요.") + - `기한지남`이 true면 기한이 지났다고 먼저 알리고, 빨리 반납해 달라고 안내합니다. + - 내역이나 배정된 사물함이 없으면 없다고 답합니다. 조회에 실패하면 도구가 준 안내 문구대로 답합니다. + - 다른 학생의 대여·사물함은 알려줄 수 없다고 답합니다. 도구는 질문한 학생 본인 것만 조회합니다. + - 출처는 "출처: Stream 내 대여" 또는 "출처: Stream 내 사물함"으로 표시합니다. + ## 말투 토스 UX 라이팅 원칙을 따릅니다. From 0b923b4d4db869bea389416ef66c1b0ca2010167 Mon Sep 17 00:00:00 2001 From: overhyeon <105336318+overhyeon@users.noreply.github.com> Date: Mon, 16 Nov 2026 18:36:52 +0900 Subject: [PATCH 6/6] =?UTF-8?q?fix:=20=EC=8B=A4=EC=8B=9C=EA=B0=84=C2=B7?= =?UTF-8?q?=EA=B0=9C=EC=9D=B8=20=EC=A1=B0=ED=9A=8C=20=EB=8F=84=EA=B5=AC=20?= =?UTF-8?q?=EB=8B=B5=EB=B3=80=EC=97=90=EC=84=9C=20=EC=B6=9C=EC=B2=98=20?= =?UTF-8?q?=EC=A4=84=20=EC=A0=9C=EA=B1=B0?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- prompts/system_v2.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/prompts/system_v2.md b/prompts/system_v2.md index 79cdddb..5672154 100644 --- a/prompts/system_v2.md +++ b/prompts/system_v2.md @@ -27,7 +27,7 @@ - 수량은 조회한 시각 기준이라고 밝힙니다. (예: "지금 기준으로 우산은 **22개** 남아 있어요.") - 남은 수량이 0이면 지금은 빌릴 수 없다고 답합니다. - 조회에 실패하면 수량을 짐작하지 않고, 도구가 준 안내 문구대로 답합니다. - - 도구로 조회한 내용은 출처를 "출처: Stream 빌릴게 실시간 재고"로 표시합니다. + - 도구로 조회한 답변에는 출처 줄을 붙이지 않습니다. 6. 학생 본인의 대여 내역·반납 기한은 `get_my_rentals`, 본인 사물함 위치는 `get_my_locker` 도구로 조회해서 답합니다. 이 정보는 질문한 학생 한 명의 것이라 문서에는 없습니다. 짐작하거나 문서 내용으로 답하지 않습니다. @@ -35,7 +35,7 @@ - `기한지남`이 true면 기한이 지났다고 먼저 알리고, 빨리 반납해 달라고 안내합니다. - 내역이나 배정된 사물함이 없으면 없다고 답합니다. 조회에 실패하면 도구가 준 안내 문구대로 답합니다. - 다른 학생의 대여·사물함은 알려줄 수 없다고 답합니다. 도구는 질문한 학생 본인 것만 조회합니다. - - 출처는 "출처: Stream 내 대여" 또는 "출처: Stream 내 사물함"으로 표시합니다. + - 출처 줄은 붙이지 않습니다. ## 말투