Initial import

2026-04-21 03:33:23 +09:00
commit 9e4b70f1f1
495 changed files with 94680 additions and 0 deletions
--- a/README.md
+++ b/README.md
@@ -0,0 +1,121 @@
+# AI Code App
+
+React + Vite + TypeScript 기반의 문서/샘플 허브 애플리케이션입니다. 현재 저장소는 공통 컴포넌트, 위젯 샘플, Markdown 문서 뷰어, Plan 게시판을 하나의 앱에서 탐색할 수 있도록 구성되어 있습니다.
+
+## 임시 운영 메모
+
+- 현재 저장소는 당분간 **로컬 전용 작업 모드**로 사용합니다.
+- Git 원격 동기화, 브랜치 운영, 자동 병합/자동화는 잠시 중지한 상태로 간주합니다.
+- Codex나 자동화 도구는 기본적으로 Git 작업 없이 **현재 프로젝트 루트의 `main` 작업본을 바로 수정**합니다.
+- `채팅`, `Codex Live`, `작업메모`, `메모 반영` 요청도 같은 기준으로 해석합니다.
+- 채팅 리소스와 첨부 파일은 `public/.codex_chat/<chat-session-id>/resource/...` 기준으로 제공하며, 업로드 파일은 `public/.codex_chat/<chat-session-id>/resource/uploads/...` 아래를 사용합니다.
+
+## 시작하기
+
+```bash
+npm install
+npm run dev
+```
+
+## PhotoPrism
+
+루트 `docker-compose.yml`에는 PhotoPrism와 MariaDB 서비스가 포함되어 있습니다.
+
+```bash
+cp .env.example .env
+docker compose up -d photoprism photoprism-db
+```
+
+- 기본 접속 포트: `127.0.0.1:2342`
+- 기본 사이트 URL: `https://photo.sm-home.cloud/`
+- 원본 사진 경로: `/mnt/usb/photos`
+- 원본 경로는 읽기 전용으로 마운트됩니다.
+- `/mnt/usb/photos`가 호스트에 없으면 bind mount를 자동 생성하지 않고 기동이 실패합니다.
+
+## 주요 스크립트
+
+```bash
+npm run dev
+npm run build
+npm run build:lib
+npm run build:app
+npm run preview
+npm run docs:daily
+npm run capture:component
+npm run capture:menu
+npm run capture:feature
+npm run capture:fullscreen
+npm run capture:plan-mobile
+npm run plan:codex:once
+```
+
+## 프로젝트 구조
+
+```text
+src/
+├─ app/
+│  ├─ main/                # 메인 레이아웃과 상단/사이드 UI
+│  └─ manifests/           # 문서/샘플 로딩 매니페스트
+├─ components/
+│  ├─ markdownPreview/     # Markdown 문서 목록/카드 렌더링
+│  ├─ navigation/          # 섹션 메뉴와 폴더 트리
+│  ├─ previewer/           # text/json/code/image/markdown 미리보기
+│  ├─ search/              # 통합 검색 모달
+│  ├─ status-badge/        # 상태 표현 UI
+│  └─ window/              # 드래그/리사이즈 가능한 윈도우 UI
+├─ features/
+│  ├─ dashboard/           # 프로젝트 전용 대시보드 샘플
+│  ├─ layout/              # 프로젝트 전용 레이아웃 문서
+│  ├─ markdownPreview/     # 기능 레벨 Markdown 카드
+│  └─ planBoard/           # Plan 게시판 화면과 API 연동
+├─ layer/                  # 제스처/검색 레이어
+├─ samples/                # 샘플 엔트리 레지스트리
+├─ store/                  # 앱 전역 상태
+└─ widgets/                # 위젯 단위 샘플과 공통 셸
+docs/
+├─ components/             # 컴포넌트 문서
+├─ features/               # 기능 문서
+├─ templates/              # 문서 템플릿
+└─ worklogs/               # 날짜별 작업일지
+```
+
+## 앱 구성
+
+- `APIs / Components`: 공통 컴포넌트 샘플 탐색
+- `APIs / Widgets`: 위젯 샘플 탐색
+- `Docs`: `docs/**/*.md`와 일부 `src/features/**/*.md` 문서 탐색
+- `Plans`: 작업 항목, 조치 이력, 이슈 이력을 관리하는 Plan 게시판
+
+## 문서 위치
+
+- 전체 문서 가이드: `docs/README.md`
+- 작업일지: `docs/worklogs`
+- 기능 문서: `docs/features`
+- 컴포넌트 문서: `docs/components`
+
+## 운영 메모
+
+- 앱 문서는 Vite `import.meta.glob`으로 Markdown 파일을 수집합니다.
+- 작업일지는 날짜별 파일로 누적하며 캡처 이미지는 `docs/assets/worklogs/YYYY-MM-DD/` 기준으로 관리합니다.
+- Plan 자동화 스크립트는 `scripts/run-plan-codex-once.mjs`를 사용합니다.
+- 서버 재기동을 호스트 프로젝트 루트 기준으로 처리하려면 `npm run server-command:runner`를 실행합니다.
+- 문서/작업일지 일일 정리는 `npm run docs:daily`와 `.github/workflows/daily-docs-maintenance.yml` 기준으로 실행합니다.
+
+## 프로젝트 현황
+
+<!-- AUTO_DAILY_DOCS:README_START -->
+- 기준 일자: `2026-04-07` (Asia/Seoul)
+- 작업일지: 9개
+- 기능 문서: 2개
+- 컴포넌트 문서: 8개
+- 스크린샷 보관 폴더: 7개
+
+최근 작업일지
+- `2026-04-07` 작업일지
+- `2026-04-06` 작업일지
+- `2026-04-05` 작업일지
+- `2026-04-04` 작업일지
+- `2026-04-03` 작업일지
+- `2026-04-02` 작업일지
+- `2026-04-01` 작업일지
+<!-- AUTO_DAILY_DOCS:README_END -->