Fix: Restore unified Topics folder and reorganize specialized category folders

2026-05-02 23:25:02 +09:00
parent b71a0b82d3
commit fdfbc83535
6241 changed files with 147626 additions and 194 deletions
@@ -0,0 +1,50 @@
+# Datacollector Mac Windows Launcher [[Scripts|Scripts]]
+
+Date: 2026-04-25 21:09:42 KST
+Project: Datacollector
+[[Repository|Repository]]: `/Volumes/Data/project/Antigravity/Datacollector`
+
+## Summary
+
+Datacollector 실행 시 Vite 프런트엔드만 뜨고 MCP Bridge 서버가 뜨지 않아 `ERR_CONNECTION_REFUSED`가 발생할 수 있었다.  
+이를 막기 위해 맥용과 윈도우용 실행 파일을 명확히 정리했다.
+
+## Main Launchers
+
+- macOS: `/Volumes/Data/project/Antigravity/Datacollector/run_mac.command`
+- Windows: `/Volumes/Data/project/Antigravity/Datacollector/run_win.bat`
+
+두 실행 파일 모두 아래를 수행한다.
+
+1. 프로젝트 폴더로 이동
+2. `node_modules`가 없으면 `npm install`
+3. 기존 `3000`, `3002` 포트 프로세스 정리
+4. MCP Bridge 서버 실행
+5. Vite 앱 실행
+
+## Compatibility Wrappers
+
+기존 실행 파일과의 호환성을 위해 아래 파일은 메인 실행 파일로 위임하도록 단순화했다.
+
+- `run_app.sh` -> `run_mac.command`
+- `run_app.bat` -> `run_win.bat`
+
+## Verification
+
+실행한 검증:
+
+```bash
+bash -n run_mac.command
+bash -n run_app.sh
+npm run lint
+```
+
+검증 결과:
+
+- macOS shell script 문법 통과
+- TypeScript 타입체크 통과
+
+## [[Opera|Opera]]tional Note
+
+앞으로 맥에서는 `run_mac.command`, 윈도우에서는 `run_win.bat`만 실행하면 된다.  
+`npm run dev` 단독 실행은 프런트엔드만 켜므로 NotebookLM, Wiki save, 인증 복구 API가 동작하지 않는다.