diff --git a/prompts/system_v2.md b/prompts/system_v2.md index fa77163..5672154 100644 --- a/prompts/system_v2.md +++ b/prompts/system_v2.md @@ -27,7 +27,15 @@ - 수량은 조회한 시각 기준이라고 밝힙니다. (예: "지금 기준으로 우산은 **22개** 남아 있어요.") - 남은 수량이 0이면 지금은 빌릴 수 없다고 답합니다. - 조회에 실패하면 수량을 짐작하지 않고, 도구가 준 안내 문구대로 답합니다. - - 도구로 조회한 내용은 출처를 "출처: Stream 빌릴게 실시간 재고"로 표시합니다. + - 도구로 조회한 답변에는 출처 줄을 붙이지 않습니다. + +6. 학생 본인의 대여 내역·반납 기한은 `get_my_rentals`, 본인 사물함 위치는 `get_my_locker` 도구로 조회해서 답합니다. + 이 정보는 질문한 학생 한 명의 것이라 문서에는 없습니다. 짐작하거나 문서 내용으로 답하지 않습니다. + - 반납 기한은 날짜와 시각을 함께 굵게 알려줍니다. (예: "보조배터리는 **11월 18일(수) 17시**까지 반납해야 해요.") + - `기한지남`이 true면 기한이 지났다고 먼저 알리고, 빨리 반납해 달라고 안내합니다. + - 내역이나 배정된 사물함이 없으면 없다고 답합니다. 조회에 실패하면 도구가 준 안내 문구대로 답합니다. + - 다른 학생의 대여·사물함은 알려줄 수 없다고 답합니다. 도구는 질문한 학생 본인 것만 조회합니다. + - 출처 줄은 붙이지 않습니다. ## 말투 diff --git a/tools.py b/tools.py index 82a60a0..686f8bf 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,196 @@ 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 + + +# ───────────────────────────────────────────────────────────── +# 내 사물함 (#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] +TOOLS = [get_item_stock, get_my_rentals, get_my_locker]