뉴스 Spec

화면 경로 /mainPages/knowledgeNews · 작성일 2026-10-12 · 수정일 2026-10-24

뉴스 화면의 기능·데이터·권한을 정리한 원본 문서입니다. 도움말(knowledgeNews-help.html)의 상세 링크가 이 문서의 각 항목으로 연결됩니다.

A1. 업무 흐름

서버의 수집 스케줄러가 지식·경제 RSS 를 모아 AI 로 요약한 묶음 노트를 지식 저장소(GitHub)에 올립니다. 사용자는 이 화면에서 묶음을 골라 읽습니다.

단계	사용 지점	사용 주체	목적
③ 읽기	하루 흐름을 훑고 싶을 때, 주식 기능과 함께 시장을 볼 때	로그인 사용자	요약된 뉴스 확인

항목	내용
화면명	뉴스
화면 경로	/mainPages/knowledgeNews
화면 목적	서버가 수집·요약한 지식·경제 뉴스를 읽는다
화면 유형	조회
프로그램	pages/mainPages/knowledgeNews.js, components/core/client/contents/knowledgeNewsContent.js
API	/api/knowledge-vault/notes?source=rss, /note, /note-view, /translate
주요 테이블 · 저장소	지식 저장소 GitHub 리포(KNOWLEDGE_VAULT_REPO), TB_KV_NOTE_VIEW (조회 수)
도움말 파일	public/help/knowledgeNews-help.html, knowledgeNews-spec.html

영역	영역명	사용자가 하는 일	화면 동작	backend 동작
①	지식 · 경제 탭	분야 고르기	탭을 바꾸면 검색어와 열린 본문을 비움	없음
②	기사 검색	이름 일부 입력	목록을 바로 좁힘	없음
③	뉴스 목록	묶음 열기, 새로고침	본문을 열면 목록을 숨김	notes
④	본문	요약·원문 링크 읽기, 목록으로	원문 언어가 다르면 번역 중 표시 후 번역본	note, note-view, translate

순서	동작
1	로그인하지 않았으면 홈으로 이동
2	RSS 노트 목록 조회, 지식 탭 표시

조건	입력 유형	기본값	설명
탭	탭 (열거형)	지식	노트 이름에 market·cnbc·nasdaq·stock·finance·economy 가 있으면 경제, 아니면 지식
기사 검색	문자	없음	노트 이름 부분 일치(대소문자 무시)

데이터 출처: 서버 수집기가 지식 저장소에 올린 RSS 묶음 노트.

역할	목록 · 본문
로그인 사용자	O
로그인 전	X (홈으로 이동)

해당 없음 — 사용자가 바꾸는 상태 값은 없습니다. 지식 저장소 연결이 거절되면 "뉴스 없음"과 구분된 오류 안내를 표시합니다.

처리	바뀌는 데이터	함께 일어나는 일
서버 수집 (기본 12시간마다)	지식 저장소에 묶음 노트 추가, 10일 지난 RSS 노트 정리	다음 조회부터 목록에 보임
묶음 열기	TB_KV_NOTE_VIEW 조회 수	원문 언어가 다르면 번역 API 호출

수집 주기는 서버 환경변수 RSS_COLLECT_INTERVAL_MIN 으로 바꾸고, RSS_SELF_SCHEDULE=false 면 자동 수집을 끕니다. 수집은 서버 안 스케줄러가 하며 GitHub Actions 로 돌리지 않습니다.

버전	수정일	수정 내용
1.0	2026-10-12	최초 작성
1.1	2026-10-24	실제 화면 기준으로 재작성(지식·경제 탭, 검색, 번역, 조회 수)