# SE-Brief (가칭) — OA 소프트웨어공학 논문 요약 봇 (설계 계획)

작성일: 2026-09-01
상태: 계획 확정 대기 (구현 미착수) · US2KR과 **별도 프로젝트/repo**

## 1. 목표

오픈액세스(OA) 소프트웨어공학 논문을 주기적으로 수집하고, MiniMax LLM으로 한국어 요약
다이제스트를 만들어 **내부 게시**(파일 아카이브 + tailnet 대시보드)하는 상주 프로그램.
US2KR의 파이프라인 철학을 그대로 따른다:

```
수집(OpenAlex · RSS) → SQLite 저장(DOI 중복 방지) → MiniMax 요약(JSON 스키마)
  → LLM 교차 검증 → Markdown 렌더 → 파일 아카이브 + 대시보드
```

## 2. 확정된 결정사항

| 항목 | 결정 |
|---|---|
| OA 기준 | **논문 단위 OA** (저널 단위 아님) — 하이브리드 저널의 OA 논문 포함 |
| MDPI | **전면 제외** (ISSN 블랙리스트로 명시적 차단) |
| IEEE Access | **포함하되 SE 토픽 필터 적용** (메가저널 노이즈 차단) |
| TOSEM | 완전 OA (2026-01 ACM Open 전환) — 전량 수집 |
| 게시 | **내부 전용**: reports/ 파일 + tailnet 대시보드. Blogger/공개는 나중 옵션 |
| 프로젝트 | US2KR과 별도 repo (US2KR 코드를 복제 후 도메인 교체로 시작) |

## 3. 미결정 사항

- [ ] 주기 — **주간(월요일 아침) 추천**. 저널 볼륨(주 10~20편)상 일간은 얇아짐
- [ ] 프로젝트/repo 이름 (후보: `sebrief`, `se-digest`, `seweekly`)
- [ ] 대시보드 포트 (US2KR이 :8090 사용 중 → :8091 제안)

## 4. 소스

**백본: OpenAlex API** — 전 저널 통합 색인, 무료·API 키 불필요.
필터: `is_oa=true` + 발행일 범위 + (저널 ISSN 화이트리스트 ∪ SE 토픽).

| 소스 | 수집 방식 |
|---|---|
| TOSEM (ACM, 완전 OA) | ISSN 화이트리스트, 전량 |
| TSE · EMSE · IST · JSS (하이브리드) | ISSN 화이트리스트 + 논문 단위 OA 필터 |
| IEEE Access | ISSN + **SE 토픽/키워드 이중 필터** |
| PeerJ Computer Science | 전량 (SE 토픽 필터) |
| SoftwareX, JOSS | 전량 (도구/소프트웨어 논문) |
| e-Informatica SEJ | RSS 보조 |
| MDPI 전 저널 | **제외** — 블랙리스트 |

- 보조/검증용: Crossref API (메타데이터 보강), Unpaywall (OA PDF URL 확인)
- Phase 3 후보: ACM 학회 프로시딩(FSE·ISSTA·ASE — ACM Open으로 전부 OA),
  arXiv cs.SE (일 20~40편, 일간 포맷 필요)

## 5. 데이터 모델 (SQLite)

```
papers(doi PK, title, abstract, authors, venue, published_date, oa_url, pdf_url,
       topics, collected_at)
digests(week PK, markdown, result_json, created_at)     -- 주간 다이제스트 아카이브
deliveries(digest_week, channel, receipt, sent_at)       -- US2KR reports/deliveries 패턴
```

- 중복 방지: DOI 기준 upsert. 한 논문은 한 번만 요약 (재수집돼도 스킵)
- 다이제스트 idempotency: 주(week) 기준 — US2KR의 krx_date 역할

## 6. LLM 요약 (US2KR llm 레이어 재사용)

- 입력: 논문별 제목 + 초록 + 메타데이터 (Phase 1은 초록 기반 — 토큰 저렴·안정)
- 출력 JSON 스키마 (주간 다이제스트 단위):
  - `overview` — 이번 주 흐름 총평 2~3문장
  - `highlights[3]` — 논문당 {문제, 방법, 결과, 실무 시사점} 4~5문장
  - `by_topic{}` — LLM4SE·테스팅·실증연구·보안·유지보수 등 주제별 그룹, 논문당 1~2문장 + 링크
  - `worth_reading[]` — "읽어볼 논문" 픽 (US2KR watchlist 격)
- **검증 패스 재사용**: 요약이 초록과 모순되는지 팩트체크 → major면 1회 수정 → 재검증
- 프롬프트 규칙: 초록에 없는 결과 수치 창작 금지, 저자 주장 vs 검증된 결과 구분,
  실무 시사점은 "초록 근거 내"로 한정

## 7. 게시 (내부 전용)

- `reports/YYYY-Wnn.md` + `.json` — 주차 기준 아카이브 (FileDeliverer 재사용)
- 대시보드: US2KR 대시보드 구조 복제 (TypeScript, reports/*.json 읽기 전용)
  - 좌측: 주차 목록 / 본문: 다이제스트 렌더 / 상단: 주간 논문 수·소스별 통계
  - tailnet 전용 (:8091), 컨테이너 분리
- Blogger 발행: 코드는 US2KR BloggerDeliverer 그대로 이식 가능 —
  공개 전환 결정 시 BLOG_ID만 발급 (OAuth 계정·클라이언트 재사용)

## 8. 운영

- 맥미니 Apple container 배포 (US2KR install 스크립트 패턴 복제)
- 스케줄: 거래소 캘린더 불필요 → 단순 주간 스케줄 (예: 월 07:00 KST) + 재시작 따라잡기
- 비용: 주 1회, 논문 10~20편 초록 요약 + 검증 = MiniMax 호출 2~4회 수준 (미미)

## 9. 저작권

- OA 논문 요약 + 출처·DOI 링크 표기는 안전. CC-BY는 저자·출처 표기 준수
- 초록 원문 전재 금지 — 자기 언어의 한국어 요약으로 재구성 (내부 게시라 리스크 낮지만
  공개 전환 대비 처음부터 지킴)

## 10. 단계

1. **Phase 1 (MVP)**: OpenAlex 수집 → 초록 기반 주간 다이제스트 → 파일 아카이브
2. **Phase 2**: 검증 패스, 대시보드(:8091), 주제 분류 고도화, 맥미니 상주 배포
3. **Phase 3 (옵션)**: 풀텍스트 딥다이브(주 1편), ACM 학회 특집, arXiv cs.SE 일간,
   Blogger 공개 전환

## 11. US2KR에서 재사용하는 것

| 재사용 | 새로 작성 |
|---|---|
| `llm/`(minimax·검증 구조), `deliver/`(file·blogger), Store·run_safely 패턴 | 수집기(OpenAlex/RSS), 논문용 프롬프트 |
| 대시보드 골격(TS 서버+클라이언트), 배포 스크립트, 로깅 | 주간 스케줄러, 다이제스트 렌더러 |