尚未检测到更新。GitHub 发布版本后会显示在这里。
个人 GitHub 账号下公开仓库的所有者可以登录并验证所有权,自行管理介绍,无需管理员批准。
登录并生成验证文件,在 30 分钟内将其提交到此仓库的默认分支。其他分支或分叉仓库中的文件无效。然后在下方检查文件,即可无需管理员批准直接管理项目。请保留文件以维持管理权限。
如需登录,将前往登录页面。登录后请回到此处,再次点击所选的验证按钮。
在项目文件夹中运行 /nomorevibe verify,即可验证所有权并自行管理介绍。
一分钟完成验证正在加载完整 README。 以下为已保存的摘录。
서울에서 이번 주 / 지금 무슨 행사가 있는지 알려주는 웹앱. 두 공공 API가 하루 1회만 갱신되므로 서버 런타임도 DB도 두지 않습니다. 배치가 데이터를 모아 data/*.json으로 커밋하고, 정적 웹앱이 그걸 읽습니다. • 설계: docs/superpowers/specs/2026-08-13-seoul-events-webapp-design.md • 구현 계획: docs/superpowers/plans/2026-08-13-batch-pipeline.md • API 실측: docs/api-findings.md — 필드명·호출 규약의 유일한 근거 .env와 .env.local을 둘 다 읽습니다(나중 것이 이김). 실제 키는 .env.local에 두세요 — 둘 다 .gitignore에 있습니다. 첫 실행은 40분 넘게 걸립니다. 비짓서울 상세 2,199건을 받아야 하고, 그쪽이 레이트 리밋을 500으로 위장해 돌려주기 때문에 400ms 간격이 필요합니다. 캐시(data/cache/visitseoul.json)가 커밋돼 있으므로 이후 실행은 5분 안에 끝납니다. 매일 KST 06:00에 GitHub Actions가 돌며 data/를 갱신 커밋합니다.查看完整 README ↗
서울에서 이번 주 / 지금 무슨 행사가 있는지 알려주는 웹앱.
두 공공 API가 하루 1회만 갱신되므로 서버 런타임도 DB도 두지 않습니다.
배치가 데이터를 모아 data/*.json으로 커밋하고, 정적 웹앱이 그걸 읽습니다.
docs/superpowers/specs/2026-08-13-seoul-events-webapp-design.mddocs/superpowers/plans/2026-08-13-batch-pipeline.mddocs/api-findings.md — 필드명·호출 규약의 유일한 근거npm ci
cp .env.example .env.local # API 키 채우기
npm test
npm run batch # data/*.json 생성
npm run batch -- 2026-W33 # 특정 주차 (지난 주차는 거절됨)
.env와 .env.local을 둘 다 읽습니다(나중 것이 이김). 실제 키는 .env.local에 두세요 —
둘 다 .gitignore에 있습니다.
첫 실행은 40분 넘게 걸립니다. 비짓서울 상세 2,199건을 받아야 하고, 그쪽이
레이트 리밋을 500으로 위장해 돌려주기 때문에 400ms 간격이 필요합니다.
캐시(data/cache/visitseoul.json)가 커밋돼 있으므로 이후 실행은 5분 안에 끝납니다.
| 이름 | 설명 |
|---|---|
SEOUL_API_KEY | 서울열린데이터광장 인증키 (발급) |
VISITSEOUL_API_KEY | 비짓서울 API 키 (발급) |
KOPIS_API_KEY | KOPIS 공연예술통합전산망 서비스키 (발급) |
VISITSEOUL_CATEGORIES | 수집 대상 카테고리 (쉼표 구분). 확정 목록은 docs/api-findings.md |
| 파일 | 내용 |
|---|---|
data/events/YYYY-Www.json | 그 주에 열리는 행사 |
data/places.json | "언제 가도 좋은 곳" 후보 (주에 묶이지 않음) |
data/meta.json | 갱신 시각, 소스별 건수 |
data/cache/visitseoul.json | 상세 응답 캐시. 변경분만 다시 받기 위한 것 |
data/cache/kopis.json | KOPIS 상세·시설 캐시와 lastRun. 변경분만 다시 받기 위한 것 |
매일 KST 06:00에 GitHub Actions가 돌며 data/를 갱신 커밋합니다.
레포 Settings → Secrets and variables → Actions에 등록해야 합니다:
SEOUL_API_KEY, VISITSEOUL_API_KEY, KOPIS_API_KEYVISITSEOUL_CATEGORIESTDD로 진행합니다. 계획의 각 태스크에 테스트와 구현이 함께 들어 있습니다.
npm test # 전체
npx vitest run tests/lib/week.test.ts # 파일 하나
npx vitest run tests/lib/week.test.ts -t '연말 경계'
npm run probe # API 실측 스파이크