diff --git a/AGENTS.md b/AGENTS.md index 30fe2e9..6e43d38 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -35,7 +35,7 @@ Python 3.10+ / FastAPI 기반 AI 챗봇 서버. LLM은 학교 AI 게이트웨이 | 문서형 | 학생회 공지, 행사 안내, 빌릴게 이용 방법·품목 목록 | RAG. 인덱싱 후 검색 | | 실시간 | 빌릴게 재고, 행사 모집 현황 | 백엔드 API 호출(function calling) | | 개인별 | 내 대여, 내 신청, 사물함 | 백엔드 API 호출 + 사용자 인증 필요 | -| 학교 공식 | 소융대 학사공지, 수강신청, 장학금, 학사일정 | 링크 안내만. 직접 단정하지 않음 | +| 학교 공식 | 학사공지, 수강신청, 장학금, 학사일정, 졸업요건, 부·복수전공 | 넣지 않음. 답하지 않고 학교 공식 안내에서 확인하도록 안내 | 한 서비스가 두 구분에 걸치기도 한다. "우산 어떻게 빌려요"는 문서형이고 "우산 지금 남았어요"는 실시간이다. 서비스 단위가 아니라 질문 단위로 갈린다. @@ -57,19 +57,18 @@ Python 3.10+ / FastAPI 기반 AI 챗봇 서버. LLM은 학교 AI 게이트웨이 백엔드 API를 기다리지 않는다. 계약에 맞춘 가짜 응답으로 먼저 구현하고 주소만 교체한다. 단 개인별 데이터는 사용자 인증이 필요하므로 인증 헤더가 확정된 뒤에 착수한다. -### 학교 공식 정보를 직접 답하지 않는 이유 +### 학교 공식 정보를 답하지 않는 이유 틀리면 학생에게 실제 피해가 발생하고, 학생회가 책임질 수 없는 영역이다. -날짜·금액을 생성하지 말고 관련 공지의 제목 + 게시일 + 원문 링크를 안내한다. +그래서 학사공지 같은 학교 공식 문서는 인덱스에 넣지 않고, 링크도 주지 않는다(2026-11-17 결정). +학사 질문이 오면 학생회가 다루는 정보가 아니라는 점을 알리고 학교 공식 안내에서 확인하도록 한다. +날짜·금액은 짐작해서 말하지 않는다. 챗봇이 답하는 범위는 `docs/seed/chatbot-scope.md`에 적어 두었다. ``` -수강신청 관련 안내는 학사공지에 있다. -"2026-2학기 수강정정 안내" (9월 3일 게시) → [링크] -정확한 일정은 원문을 확인해 주세요. +수강신청은 학생회가 다루는 정보가 아니라서 답하기 어려워요. +학교 공식 안내에서 확인해 주세요. ``` -운영 로그가 쌓이고 검증된 영역에 한해 단계적으로 직접 답변을 확대한다. - ## 아키텍처 ``` @@ -185,7 +184,7 @@ search(query: str) -> list[dict] # [{"text": ..., "meta": {...}}, ...] - 검색된 문서에 없는 내용은 생성하지 않는다. 모르면 "해당 정보를 찾지 못했어요"라고 답하고 문의처를 안내한다. - 공지·행사를 근거로 답할 때만 출처를 표시한다(제목 + 게시일 + 상세 화면 링크). 시드·FAQ·아카이빙·열린피드백·실시간 조회 답변에는 출처 줄을 붙이지 않는다. 링크가 없는 출처 줄은 번잡하기만 하다. -- 학사 정보는 직접 단정하지 않고 원문으로 안내한다. +- 학사 정보는 답하지 않고 학교 공식 안내에서 확인하도록 안내한다. - 해요체로 간결하게. 토스 UX 라이팅 원칙을 따른다(쉬운 말, 군더더기 제거, 핵심만 굵게). ## 인덱스 갱신 @@ -233,8 +232,7 @@ ID로 하나 꺼내는 것은 DB가 잘하지만, 수백 건 중 관련된 것 - `docs/seed/`는 반대로 반드시 커밋한다. 직접 작성한 문서라 잃으면 복구할 원본이 없고, 이게 없으면 팀원이 개발 환경을 만들 수 없다. - 학사 정보(수강신청 날짜, 장학금 금액 등)를 직접 단정하지 않는다. - 실시간·개인별 데이터를 인덱싱하지 않는다. -- 학교 홈페이지는 공지 목록(제목·게시일·링크)만 수집한다. 본문은 가져오지 않는다. - 수집 전 robots.txt를 확인하고, 주기는 하루 1~2회로 제한한다. 학교가 문제를 제기하면 즉시 중단한다. +- 학교 홈페이지는 수집하지 않는다. 공지 목록·본문 모두 해당한다(2026-11-09 결정, `docs/plans/10-week-roadmap.md`). - 인덱스 디렉터리를 덮어쓰지 않는다. 새로 만들고 링크를 교체한다. ## 배포 전 확인 diff --git a/docs/seed/borrow-guide.md b/docs/seed/borrow-guide.md index bb050f8..22654fe 100644 --- a/docs/seed/borrow-guide.md +++ b/docs/seed/borrow-guide.md @@ -2,15 +2,17 @@ 문서ID: seed-borrow 출처URL: "" 제목: 빌릴게 이용 안내 -게시일: 2026-09-26 +게시일: 2026-11-11 유효기간: "" 문서유형: 안내 --- -빌릴게는 Stream 웹의 빌릴게 메뉴에서 쓴다. 따로 설치할 앱은 없고, 휴대폰에서는 브라우저의 "홈 화면에 추가"로 앱처럼 쓸 수 있다. +빌릴게는 소융대 학생회가 운영하는 복지물품 대여 서비스다. Stream의 빌릴게 탭에서 쓴다. 빌릴게는 학생회비 납부자만 이용할 수 있다. -빌리는 순서는 Stream 빌릴게에서 예약한 뒤 미래관 4층 학생회실에 가서 학생증을 보여주고 받는 것이다. 반납도 같은 학생회실에서 한다. +빌리는 순서는 Stream 빌릴게 탭에서 물품을 신청한 뒤 학생회실에 가서 학생증을 보여주고 받는 것이다. 반납도 같은 학생회실에서 한다. -학생회실 운영 시간은 평일 10:00~17:00이고 주말과 공휴일은 쉰다. 대여 기간은 최대 3일이다. 반납이 늦으면 연체 하루당 3일 동안 대여할 수 없다. +학생회실은 미래관 3층 306호다. 운영 시간은 평일 10:00~17:00이고, 12:00~13:00은 점심시간이라 대여와 반납을 할 수 없다. 주말과 공휴일은 쉰다. -어떤 물품이 있고 지금 몇 개 남았는지는 Stream 빌릴게 화면에서 실시간으로 확인한다. 이 문서에는 재고를 적지 않는다. +반납은 당일이 원칙이다. 다만 개인 사정으로 당일에 돌려주기 어려우면 다음 날 반납할 수 있다. + +어떤 물품이 있는지와 지금 몇 개 남았는지는 Stream 빌릴게 탭에서 실시간으로 확인한다. 수량은 계속 바뀌므로 이 문서에는 적지 않는다. diff --git a/docs/seed/chatbot-scope.md b/docs/seed/chatbot-scope.md index d0da284..eaed96e 100644 --- a/docs/seed/chatbot-scope.md +++ b/docs/seed/chatbot-scope.md @@ -2,15 +2,19 @@ 문서ID: seed-scope 출처URL: "" 제목: 챗봇이 답하는 범위 -게시일: 2026-09-26 +게시일: 2026-11-11 유효기간: "" 문서유형: 안내 --- -이 챗봇은 소프트웨어융합대학 학생회와 Stream에 관한 것을 답한다. 학생회 공지와 아카이빙, 행사 일정과 신청 방법, 빌릴게 대여, 사물함, 학생회비가 그 범위다. +이 챗봇은 소프트웨어융합대학 학생회와 Stream에 관한 것을 답한다. 학생회 공지와 아카이빙, 학생회 행사, 빌릴게 대여, 사물함, 학생회비, 열린피드백, 그리고 미래관 안의 시설 위치가 그 범위다. -졸업요건, 조기졸업, 학사일정, 장학금, 부전공과 복수전공처럼 학교 공식 정보는 학생회가 관리하는 자료가 아니다. 학점이나 요건을 직접 말하지 않고 학교 공식 안내 페이지 링크를 알려준다. +학교 공식 정보는 답하지 않는다. 졸업요건, 조기졸업, 학사일정, 수강신청, 장학금, 부전공과 복수전공은 학생회가 관리하는 자료가 아니다. 학점이나 요건을 짐작해서 말하지 않고, 학생회가 다루는 정보가 아니라는 점을 알리고 학교 공식 안내에서 확인하도록 한다. -개인 성적, 이수 학점, 내가 신청한 내역처럼 로그인해야 알 수 있는 것은 조회하지 않는다. 종합정보시스템이나 Stream에서 직접 확인하도록 안내한다. +학생회 소관이 아닌 것도 답하지 않는다. 기숙사, 학식, 도서관, 셔틀버스, 휴학과 전과, 학점교류, 동아리 가입이 여기 해당한다. -학생회와 관계없는 질문에는 답할 수 있는 범위를 짧게 안내한다. +다른 단과대의 행사는 알지 못한다. 소융대가 다른 단과대와 함께 여는 연합 행사는 학생회 행사이므로 답하지만, 그 단과대가 따로 여는 행사는 알 수 없다는 점을 밝힌다. + +빌릴게 대여 현황과 배정된 사물함은 본인 것만 조회해 준다. 다른 학생의 정보는 알려주지 않는다. 성적, 이수 학점처럼 학교 시스템에 있는 정보는 조회하지 않고 종합정보시스템에서 직접 확인하도록 안내한다. + +자료에 없는 것은 지어내지 않는다. 연락처나 위치처럼 확인되지 않은 정보를 묻는 경우에도 아는 척하지 않고, 찾지 못했다는 점과 어디서 확인할 수 있는지를 알린다. diff --git a/docs/seed/event-guide.md b/docs/seed/event-guide.md index 3fa60b1..205a340 100644 --- a/docs/seed/event-guide.md +++ b/docs/seed/event-guide.md @@ -2,15 +2,15 @@ 문서ID: seed-event 출처URL: "" 제목: 행사 신청·취소 안내 -게시일: 2026-09-26 +게시일: 2026-11-11 유효기간: "" 문서유형: 안내 --- -학생회 행사는 Stream의 행사 탭에서 신청한다. 행사를 고르고 신청하기를 누르면 된다. 체육대회처럼 종목을 골라야 하는 행사, 해커톤처럼 팀을 이뤄 신청하는 행사도 있어서 신청 화면의 안내를 함께 본다. +학생회 행사는 Stream의 행사 탭에서 신청한다. 행사를 고르고 신청하기를 누르면 된다. 체육대회처럼 종목을 먼저 골라야 하는 행사, 해커톤처럼 팀을 이뤄 신청하는 행사도 있어서 신청 화면의 안내를 함께 본다. -간식행사처럼 학생회비 납부자만 신청할 수 있는 행사가 있다. +간식행사처럼 학생회비 납부자만 신청할 수 있는 행사가 있다. 신청 자격은 행사마다 달라서 행사 안내에 적혀 있다. -신청을 취소할 때는 Stream 행사 탭에서 내 신청으로 들어가 취소를 누른다. 행사마다 취소할 수 있는 마감일이 따로 있어서, 그 날짜가 지나면 취소가 되지 않는다. +신청을 취소할 때는 Stream 행사 탭에서 그 행사의 신청 상세로 들어가 취소한다. 행사마다 취소할 수 있는 마감일이 따로 있고, 그 날짜가 지나면 취소되지 않는다. -행사별 신청 기간과 취소 마감일, 정원은 행사마다 다르다. Stream 행사 탭과 학생회 공지에서 확인한다. +신청 기간, 취소 마감일, 정원, 장소는 행사마다 다르다. Stream 행사 탭과 학생회 공지에서 확인한다. 이 문서에는 특정 행사의 날짜를 적지 않는다. diff --git a/docs/seed/fee-guide.md b/docs/seed/fee-guide.md new file mode 100644 index 0000000..f1133f3 --- /dev/null +++ b/docs/seed/fee-guide.md @@ -0,0 +1,16 @@ +--- +문서ID: seed-fee +출처URL: "" +제목: 학생회비 안내 +게시일: 2026-11-11 +유효기간: "" +문서유형: 안내 +--- + +학생회비는 학기당 2만원을 기준으로 계산한다. 처음 낼 때 8학기분을 한 번에 내므로 현재는 16만원이다. + +금액은 해마다 사정에 따라 달라질 수 있다. 이미 낸 사람은 더 내지 않고, 새로 내는 사람만 그해 기준 금액으로 낸다. 그래서 신규 납부자는 그해 공지에서 금액을 확인한다. + +학생회비를 내면 학생회가 주관하는 행사와 간식행사에 참여할 수 있고, 사물함과 빌릴게를 이용할 수 있다. + +납부 방법과 기간은 학생회 공지로 안내한다. diff --git a/docs/seed/feedback-guide.md b/docs/seed/feedback-guide.md new file mode 100644 index 0000000..df2e63c --- /dev/null +++ b/docs/seed/feedback-guide.md @@ -0,0 +1,12 @@ +--- +문서ID: seed-feedback +출처URL: "" +제목: 열린피드백 안내 +게시일: 2026-11-11 +유효기간: "" +문서유형: 안내 +--- + +열린피드백은 학우들의 불편 사항, 행사에 대한 의견, 교학팀에 전달할 건의 사항을 모아 학생회의 답변과 함께 공개하는 제도다. 질문과 답변이 모두 공개되므로 같은 것이 궁금한 다른 학생도 함께 볼 수 있다. 글은 익명으로 올라가서 누가 썼는지는 공개되지 않는다. + +Stream의 게시판 탭에서 열린피드백으로 들어가면 글을 쓰고 지난 글과 답변을 볼 수 있다. diff --git a/docs/seed/locker-guide.md b/docs/seed/locker-guide.md index 129593b..2f299ba 100644 --- a/docs/seed/locker-guide.md +++ b/docs/seed/locker-guide.md @@ -1,18 +1,22 @@ --- 문서ID: seed-locker 출처URL: "" -제목: 사물함 신청·반납 안내 -게시일: 2026-09-26 +제목: 사물함 이용 안내 +게시일: 2026-11-11 유효기간: "" 문서유형: 안내 --- -사물함은 Stream의 사물함 탭에서 구역을 고른 뒤 신청한다. 선착순이라 정원이 차면 그 구역은 더 신청할 수 없다. +사물함은 Stream 홈의 사물함에서 구역을 고른 뒤 신청한다. 선착순이라 정원이 차면 그 구역은 더 신청할 수 없다. -사물함은 미래관에 A, B, C 세 구역이 있다. A구역은 3층 엘리베이터 옆 복도로 전공 강의실과 가장 가깝고, B구역은 4층 학생회실 맞은편으로 빌릴게 수령처와 같은 층이다. C구역은 5층 세미나실 앞이다. +사물함은 A·B·C·D 네 구역이 있고 모두 미래관 2층에 있다. 각 구역이 어디인지는 신청하기 전에 Stream 홈의 사물함에서 확인할 수 있다. -사용료는 학생회비 납부 여부에 따라 다르다. 납부자는 무료이고 미납자는 별도 금액을 낸다. +신청은 학생회비 납부자만 할 수 있다. 한 사람이 신청할 수 있는 사물함은 하나다. -신청을 취소하거나 사물함을 비울 때는 Stream 사물함 탭에서 내 사물함으로 들어가 반납하기를 누른다. +사물함 배정은 1년 단위다. 그 해에 신청한 사물함은 다음 해 1학기가 시작하기 전까지 쓴다. 학기가 끝났다고 바로 비우지 않아도 된다. -학기별 신청 기간과 구역별 잔여 수량은 그때그때 달라진다. 기간은 학생회 공지에서, 잔여 수량은 Stream 사물함 탭에서 확인한다. +신청은 1학기에 받는다. 2학기에는 1학기 신청 뒤 남은 자리가 있을 때만 추가로 받는다. 2학기에 신청해도 쓸 수 있는 기한은 같아서 다음 해 1학기 시작 전까지다. + +신청 기간은 학생회 공지로 안내한다. + +구역별 남은 자리는 그때그때 달라지므로 이 문서에는 적지 않는다. Stream 홈의 사물함에서 확인한다. diff --git a/docs/seed/office-guide.md b/docs/seed/office-guide.md new file mode 100644 index 0000000..d9fb597 --- /dev/null +++ b/docs/seed/office-guide.md @@ -0,0 +1,14 @@ +--- +문서ID: seed-office +출처URL: "" +제목: 학생회실 위치와 운영 시간 +게시일: 2026-11-11 +유효기간: "" +문서유형: 안내 +--- + +소융대 학생회실은 미래관 3층 306호다. 과방 안에 있는 학생회 전용 방이라 과방과 주소가 같다. + +운영 시간은 평일 10:00~17:00이다. 12:00~13:00은 점심시간이라 운영하지 않는다. 주말과 공휴일은 쉰다. + +빌릴게 물품을 받고 돌려주는 곳도 이 학생회실이다. 방문할 때는 학생증을 가져간다. diff --git a/docs/seed/places-guide.md b/docs/seed/places-guide.md new file mode 100644 index 0000000..283b34e --- /dev/null +++ b/docs/seed/places-guide.md @@ -0,0 +1,25 @@ +--- +문서ID: seed-places +출처URL: "" +제목: 미래관 시설 위치 +게시일: 2026-11-11 +유효기간: "" +문서유형: 안내 +--- + +소프트웨어융합대학 학생들이 자주 찾는 미래관 시설의 위치다. + +- 교학팀(행정실, 과사무실, 교무팀, 과사): 신관 6층 631호 +- 자율주행 스튜디오(자주스): 4층 429호 +- 무한상상실(무상실): 4층 446호 +- 과방: 3층 306호 + +과사, 행정실, 교무팀은 모두 교학팀을 가리키는 같은 말이다. 과방은 학생들이 쓰는 공간으로 교학팀과 다른 곳이다. + +학생회실은 과방 안에 있는, 학생회만 쓰는 방이다. 그래서 과방과 학생회실은 주소가 3층 306호로 같다. + +교학팀 운영 시간은 학기 중에는 09:00부터 17:00까지, 방학 중에는 09:30부터 16:00까지다. 점심시간은 12:00부터 13:00까지로 학기 중과 방학이 같다. + +정수기는 세 곳에 있다. 3층은 구관 입구에, 4층과 5층은 신관 계단 앞에 각각 하나씩 있다. + +신관 6층에는 611호 대형 강의실과 대학원 연구실(LaB실)이 있다. diff --git a/docs/seed/seullangje-guide.md b/docs/seed/seullangje-guide.md new file mode 100644 index 0000000..78ac7b3 --- /dev/null +++ b/docs/seed/seullangje-guide.md @@ -0,0 +1,12 @@ +--- +문서ID: seed-seullangje +출처URL: "" +제목: 슬랑제 안내 +게시일: 2026-11-11 +유효기간: "" +문서유형: 안내 +--- + +슬랑제는 교수님과 동문 선배, 재학생이 함께 모이는 소프트웨어융합대학의 행사다. 한 해의 활동을 돌아보고, 함께 식사하며 이야기를 나누는 자리다. + +열리는 날짜와 장소, 신청 기간은 해마다 다르다. 학생회 공지와 Stream 행사 탭에서 확인한다. diff --git a/docs/seed/stream-guide.md b/docs/seed/stream-guide.md new file mode 100644 index 0000000..a5e18d3 --- /dev/null +++ b/docs/seed/stream-guide.md @@ -0,0 +1,19 @@ +--- +문서ID: seed-stream +출처URL: "" +제목: Stream 안내 +게시일: 2026-11-11 +유효기간: "" +문서유형: 안내 +--- + +Stream은 소프트웨어융합대학 학생회가 만든 통합 플랫폼이다. 학생회 공지를 보는 것부터 행사 신청, 빌릴게 대여까지 흩어져 있던 일을 한곳에서 한다. + +화면은 홈, 행사, 게시판, 빌릴게 네 탭으로 나뉜다. + +- 홈: 여러 기능을 한눈에 본다. 사물함 신청도 홈에서 들어간다 +- 행사: 진행 중인 행사를 보고 신청한다. 내가 신청한 내역도 여기서 확인한다 +- 게시판: 학생회 공지와 열린피드백을 본다 +- 빌릴게: 복지물품을 신청하고 남은 수량을 본다 + +각 기능을 쓰는 방법과 조건은 기능별 안내에 따로 적혀 있다.