Skip to content

About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

SEBU Brain

SEBU의 기능, 구조, 설계 이유와 운영 지식을 연결하는 팀용 Obsidian 보관함입니다.

기준: 2026-10-10 확인 · 백엔드 develop 7d4839b · 백엔드 운영 main 3c7445e · 프론트 운영 dev e7e54de

서비스는 www.sebu.kr, 운영 API는 api.sebu.kr입니다. 운영 Grafana 대시보드·장애 알림, 지표 해석과 항공우주공학과 홈페이지 12건 보완까지 반영했습니다. 코드 확인, 실제 실행 결과, 아직 구현하지 않은 제안을 구분합니다.

처음 읽는 팀원

git clone https://github.com/greedy-team/SEBU-brain.git
cd SEBU-brain

Obsidian에서 **기존 폴더를 보관함으로 열기(Open folder as vault)**를 선택하고 복제된 SEBU-brain 루트를 엽니다. 그 안의 SEBU/00 시작/SEBU 홈.md에서 시작합니다. 추가 플러그인은 필요하지 않습니다.

이후 같은 폴더에서 아래 명령으로 갱신합니다.

git pull --ff-only

별도 폴더로 복사하지 않고 clone한 폴더 자체를 보관함으로 사용합니다. 직접 수정한 노트가 있으면 먼저 브랜치에서 커밋하고 팀 문서 변경과 조정합니다.

질문에서 시작하기

질문 문서
무엇을 만드는 서비스인가? 프로젝트 개요
백엔드 docs와 실행 안내는 어디에 있는가? 백엔드 문서 모음 · 이전 기록
운영 전환과 전체 연구 정보 이관은 어떻게 하는가? SEBU 운영 전환과 연구 정보 이관 · 검증 기록
지금까지 무엇을 반영했고 무엇이 남았는가? 10월 10일 갱신 기록 · 운영 배포 기록
운영 중 급한 코드·데이터 수정은 어떻게 하는가? 운영 핫픽스와 데이터 보정 · 물리천문학과 링크 보완
운영 상태·알림과 요청 그래프는 어떻게 읽는가? 운영 모니터링과 대시보드 해석 · 구축 기록
최근 항공우주공학과 링크 보완 결과는? V51 보완 기록
지금 구현된 것은 무엇인가? 구현 현황
검색·단과대·랩실평가가 같은 API를 쓰는가? 화면과 API 공유
공개 API를 외부 주소창에서 열 수 있는 이유는? 공개 API와 CORS
로그인·북마크는 어떻게 동작하는가? 인증과 CSRF · 마이페이지와 북마크
다음에 확인할 과제는? 변경 검토 목록
AI와 FE·BE의 작업 범위는? 협업과 AI 작업 원칙
문서를 언제, 어떻게 갱신하는가? 팀 공유와 업데이트 · 갱신 방법

전체 문서 목록 · SEBU 홈 · 연결 지도

Markdown 안의 [[노트]] 연결과 Canvas는 Obsidian에서 사용합니다. GitHub에서는 위 링크와 전체 문서 목록을 이용하면 됩니다.

코드가 바뀐 뒤

  1. 코드 PR을 머지하고 해당 저장소의 원격 ref를 갱신합니다.
  2. 달라진 기능·API·정책의 관련 노트를 검토합니다.
  3. 원본 기준 커밋·근거 링크를 갱신하고 검사합니다.
  4. 문서 브랜치의 PR을 검토·머지합니다.
  5. 팀원이 Pull해서 읽습니다.

노트는 자동으로 코드와 동기화되지 않습니다. 코드에서 확인한 사실, 실행 검증, 제안을 구분합니다. 운영 배포 버전은 코드 기준과 별도로 확인합니다.

문서 검증과 원본 변경 확인

문서를 읽는 데 개발 도구는 필요하지 않습니다. 갱신 도구는 Node.js 20 이상과 Git만 사용하고 외부 npm 패키지는 설치하지 않습니다.

npm run check
npm test

코드와 비교하려면 sources.example.json을 sources.local.json으로 복사하고 경로를 맞춥니다. PowerShell에서는 Copy-Item sources.example.json sources.local.json을 사용할 수 있습니다.

npm run sources:check
# 노트 검토와 수정이 끝났을 때만 기준 및 근거 링크 기록
npm run sources:record -- --reviewed
npm run check

원본 코드 레포의 경로·ref 설정은 각자 관리하며 Git에서 제외합니다. 비교 기준은 source-baseline.json에 기록합니다. 새 파일·삭제·이름 변경도 비교하며, 문장 내용의 정확성은 리뷰로 확인합니다.

기여 방법에서 갱신 순서와 검증 범위를 확인하세요.

About

No description, website, or topics provided.

Resources

Contributing

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages