Skip to content

[Docs/#71] 슬랑제 전 확정 범위·9주차 재배치와 에이전트·내부 API 설계 문서 - #78

Merged
seungbye merged 3 commits into
mainfrom
docs/#71-agent-plan
Nov 17, 2026
Merged

seungbye merged 3 commits into
mainfrom
docs/#71-agent-plan

Conversation

@overhyeon

Copy link
Copy Markdown
Contributor

#️⃣연관된 이슈

#71

📝작업 내용

11/8~9에 정한 계획을 문서로 남깁니다. 코드 변경은 없습니다.

1. docs/plans/10-week-roadmap.md

  • 「슬랑제 전 확정 범위 (2026-11-09 재조정)」 (8주차 뒤)
    • 반드시 할 것 7가지: 공지·행사 실데이터, 원문 링크, 재고, 내 대여·반납 기한, 내 사물함, 변하지 않는 안내 정리, 골든셋 재매핑·점수
    • 백엔드 데이터를 읽는 두 갈래: 인덱싱은 내부 API(/v1/ai/**), 질문할 때 조회는 학생 JWT(X-User-Token)
    • 서버 안 주기 갱신 방식 (이미지 재빌드가 아님, 10분마다, 실패 시 기존 인덱스 유지)
    • 학교 홈페이지 공지 수집 제외 (학생회가 학사 공지를 Stream에 다시 올림. 학사 정보 단정 금지 규칙은 유지)
    • 9주차 일정 재배치 (11/10~11/16 날짜별 담당). 밀리면 링크를 먼저 빼고 실데이터 인덱싱과 점수 측정은 지킨다
  • 「발표 이후: 에이전트 기능」 (교수님 미팅 요청: "우산 빌려줘"로 대여 신청 등)
    • 설계: 모델은 제안만, 실행은 학생이 확인 버튼을 눌러 프론트가 직접 호출. AI 서버는 쓰기 API를 부르지 않는다
    • 학생 토큰 전달 방식과 "읽기만"을 토큰이 아니라 코드로 지키는 이유
    • 프롬프트 인젝션 방어 8단계
    • 설계만 했고 구현은 발표 이후
  • 5·6주차 학교 공지 수집 항목에 취소선, 「10주에서도 빼는 것」에 에이전트 기능·학교 홈페이지 수집 추가

2. docs/plans/ai-internal-api-proposal.md (신규)

💬리뷰 요구사항(선택)

승빈: 9주차 일정표와 담당을 봐 주세요. sync.py는 일정 때문에 제가 #73에서 먼저 만들었고, 시드 정리(#75)·골든셋 재매핑이 승빈 쪽 항목으로 남아 있습니다.
날짜는 11/9 기준이라 백엔드 리뷰가 늦어진 만큼(#310·#312 아직 리뷰 전) 뒤로 밀려 있습니다.

@coderabbitai

coderabbitai Bot commented Nov 11, 2026

Copy link
Copy Markdown

Important

  • Trigger review

This repository does not receive automatic reviews because it has fewer than 10 stars.

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: defaults
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: b92cb801-1a15-479b-a91c-66569c8dcb2b
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@seungbye seungbye left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

9주차 일정표와 담당 확인했어요. 승인하고 머지할게요 👍

  • 백엔드 데이터를 읽는 두 갈래(내부 API로 인덱싱 / 학생 JWT로 조회) 정리가 깔끔해요
  • 에이전트 기능을 "모델은 제안만, 실행은 학생 버튼"으로 둔 거 좋아요. 인젝션이 와도 쓰기가 안 일어나요
  • 일정은 #310·#312 리뷰가 늦어진 만큼 밀려 있는 거 알고 있어요. 제 쪽 항목인 시드 정리(#75)는 리뷰 반영해서 마무리할게요

@seungbye
seungbye merged commit 580fc63 into main Nov 17, 2026
1 check passed
@seungbye
seungbye deleted the docs/#71-agent-plan branch November 17, 2026 11:43
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants