{"id":51676211,"url":"https://github.com/mow-coding/basic-website-cms","last_synced_at":"2026-07-15T06:05:04.988Z","repository":{"id":370406419,"uuid":"1288077146","full_name":"mow-coding/basic-website-cms","owner":"mow-coding","description":null,"archived":false,"fork":false,"pushed_at":"2026-07-09T05:00:51.000Z","size":1830,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-07-09T06:18:29.679Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mow-coding.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-07-03T08:54:33.000Z","updated_at":"2026-07-09T05:00:59.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mow-coding/basic-website-cms","commit_stats":null,"previous_names":["mow-coding/basic-website-cms"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/mow-coding/basic-website-cms","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mow-coding%2Fbasic-website-cms","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mow-coding%2Fbasic-website-cms/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mow-coding%2Fbasic-website-cms/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mow-coding%2Fbasic-website-cms/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mow-coding","download_url":"https://codeload.github.com/mow-coding/basic-website-cms/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mow-coding%2Fbasic-website-cms/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":35493174,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-15T02:00:06.706Z","response_time":131,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-07-15T06:05:04.113Z","updated_at":"2026-07-15T06:05:04.980Z","avatar_url":"https://github.com/mow-coding.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Basic Website CMS\n\nBasic Website CMS는 작은 조직이 사용할 수 있는 **AI-ready 웹사이트 CMS 스타터 키트**입니다.\n\n이 저장소는 단순히 완성된 웹사이트 껍데기를 전시하기 위한 것이 아닙니다. Claude, Codex 같은 AI 코딩 도우미에게 이 저장소를 맡기면, 초보자도 자기 컴퓨터에서 실행하고 GitHub, Vercel, Neon, Google OAuth를 연결해 실제 웹사이트와 관리자 콘솔을 배포할 수 있도록 돕는 키트입니다.\n\n## AI가 먼저 읽어야 할 문서\n\nAI 코딩 도우미로 이 폴더를 열었다면, 바로 명령어부터 실행하지 말고 아래 입구 문서를 먼저 읽으세요.\n\n- `AGENTS.md`: Codex와 여러 AI 코딩 도우미를 위한 공통 접객 매뉴얼\n- `CLAUDE.md`: Claude Code / Claude Desktop 계열을 위한 프로젝트 지침\n- `GEMINI.md`: Gemini CLI 계열을 위한 프로젝트 지침\n- `.github/copilot-instructions.md`: GitHub Copilot을 위한 저장소 지침\n- `docs/AI_RESPONSE_GUIDE.md`: 사용자를 어떻게 설명하고 보고하며 안내할지 정리한 본문 매뉴얼\n\n이 키트의 목표는 사용자가 GitHub, Vercel, Neon, GCP/Google OAuth를 무작정 클릭하게 만드는 것이 아니라, 자기 웹사이트가 어떤 부품으로 조립되는지 이해하면서 AI와 함께 완성하게 돕는 것입니다.\n\n## 무엇을 만들 수 있나요?\n\n이 키트는 두 개의 Next.js 앱으로 구성됩니다.\n\n- `apps/site`: 방문자가 보는 공개 웹사이트\n- `apps/admin`: 믿을 수 있는 관리자가 게시글, 일정, 페이지, 첨부파일을 관리하는 관리자 콘솔\n\n관리자 콘솔에서 내용을 저장하면 공개 웹사이트에 반영됩니다.\n\n중요한 백엔드 설계는 이미 준비되어 있습니다. 이 키트를 사용하는 초심자가 인증, 데이터베이스 구조, 업로드 보안, 캐시 재검증 같은 핵심 구조를 직접 다시 설계할 필요는 없습니다. 대신 이 키트는 **어디까지 자유롭게 바꿔도 되는지**, **어디부터는 조심해야 하는지**를 AI가 잘 안내할 수 있게 만들어야 합니다.\n\n## 네 가지 주요 서비스\n\n웹개발 전문가가 될 필요는 없지만, 이 키트가 어떤 부품으로 조립되는지는 이해하는 것이 좋습니다. 이케아 가구를 조립할 때 드라이버와 나사가 무엇인지 정도는 아는 것과 같습니다.\n\n| 서비스 | 쉬운 설명 |\n| --- | --- |\n| GitHub | 코드 창고입니다. 프로젝트 코드와 변경 기록을 보관합니다. |\n| Vercel | 포장·배송 센터입니다. GitHub의 코드를 실제 웹사이트로 포장하고 인터넷 주소로 배송합니다. |\n| Neon | 데이터 금고입니다. 관리자에 의해 바뀔 수 있는 게시글, 일정, 설정을 안전하게 저장합니다. |\n| GCP / Google OAuth | 관리자 출입증 발급소입니다. 관리자 콘솔에 Google 로그인으로 들어갈 수 있게 출입증을 만듭니다. |\n\nGitHub, Vercel, Neon은 보통 AI가 CLI 설치와 로그인 흐름을 많이 도와줄 수 있습니다. 반면 Google OAuth 설정은 Google Cloud Console 화면에서 사용자가 직접 클릭하고 값을 입력해야 하는 단계가 많습니다. AI는 옆에서 안내하고 확인하는 역할을 합니다.\n\n## AI와 함께 시작하기\n\n이 키트를 AI 코딩 도우미와 함께 사용한다면 아래 문서부터 읽게 하세요.\n\n- [AI 설정 가이드](docs/AI_SETUP_GUIDE.md)\n- [AI 응답 가이드](docs/AI_RESPONSE_GUIDE.md)\n- [첫 실행 체크리스트](docs/FIRST_RUN_CHECKLIST.md)\n- [환경변수 안내](docs/ENVIRONMENT_VARIABLES.md)\n- [Google OAuth 설정](docs/GOOGLE_OAUTH_SETUP.md)\n- [배포 검증 체크리스트](docs/DEPLOYMENT_VERIFICATION.md)\n- [서비스 설정 노트](docs/SERVICE_SETUP_NOTES.md)\n- [커스터마이즈 경계](docs/CUSTOMIZATION_BOUNDARIES.md)\n- [안전한 커스터마이즈 레시피](docs/SAFE_CUSTOMIZATION_RECIPES.md)\n- [AI에게 붙여넣을 프롬프트](docs/AI_ASSISTANT_PROMPT.md)\n\n추천 흐름은 다음과 같습니다.\n\n1. AI에게 이 저장소와 위 문서들을 먼저 읽게 합니다.\n2. AI가 GitHub, Vercel, Neon, Google OAuth의 역할을 쉬운 말로 설명하게 합니다.\n3. AI가 현재 단계, 사용자가 직접 할 일, 확인 근거, 남은 일을 보이게 보고하게 합니다.\n4. [첫 실행 체크리스트](docs/FIRST_RUN_CHECKLIST.md)에 따라 내 컴퓨터에 필요한 도구가 설치되어 있는지 확인하게 합니다.\n5. [환경변수 안내](docs/ENVIRONMENT_VARIABLES.md)를 보며 로컬과 Vercel 환경변수를 채웁니다.\n6. AI 안내에 따라 GitHub, Vercel, Neon에 로그인합니다.\n7. [Google OAuth 설정](docs/GOOGLE_OAUTH_SETUP.md)은 사용자가 Google Cloud Console에서 직접 만들고, AI가 옆에서 안내합니다.\n8. 로컬에서 공개 사이트와 관리자 콘솔을 실행합니다.\n9. Vercel에 두 앱을 배포하고 [배포 검증 체크리스트](docs/DEPLOYMENT_VERIFICATION.md)로 확인합니다.\n10. 먼저 [안전한 커스터마이즈 레시피](docs/SAFE_CUSTOMIZATION_RECIPES.md)에 있는 문구, 이미지, 색상, 메뉴, 샘플 데이터부터 커스터마이즈합니다.\n\n## 로컬 개발\n\n필요한 것:\n\n- Node.js 20.9 이상\n- npm\n- PostgreSQL 데이터베이스. 실제 사용에서는 보통 Neon을 씁니다.\n\n의존성 설치:\n\n```bash\nnpm --prefix apps/site install\nnpm --prefix apps/admin install\n```\n\n환경변수 예시 파일 복사:\n\n```bash\ncp apps/site/.env.example apps/site/.env.local\ncp apps/admin/.env.example apps/admin/.env.local\n```\n\nWindows PowerShell에서는:\n\n```powershell\nCopy-Item apps/site/.env.example apps/site/.env.local\nCopy-Item apps/admin/.env.example apps/admin/.env.local\n```\n\n환경변수를 채운 뒤 관리자 데이터베이스를 준비합니다.\n\n```bash\nnpm run admin:db:push\nnpm run admin:seed\nnpm run admin:seed:sample\n```\n\n두 앱 실행:\n\n```bash\nnpm run admin:dev\nnpm run site:dev\n```\n\n기본 로컬 주소:\n\n- 공개 사이트: `http://localhost:3000`\n- 관리자 콘솔: `http://localhost:3001`\n\n`localhost`는 내 컴퓨터 안에서만 열리는 임시 웹사이트 주소입니다. Vercel로 인터넷에 배송하기 전에 화면과 기능을 미리 확인할 때 씁니다.\n\n## 구조\n\n```text\napps/\n  site/   공개 웹사이트\n  admin/  관리자 콘솔, 데이터베이스 연결, Google 로그인, 콘텐츠 관리\ndocs/\n  AI와 초심자를 위한 설정/커스터마이즈 안내\n```\n\n## 배포 구조\n\nVercel에서는 같은 GitHub 저장소에서 프로젝트를 두 개 만듭니다.\n\n- 공개 사이트 프로젝트: Root Directory를 `apps/site`로 설정\n- 관리자 콘솔 프로젝트: Root Directory를 `apps/admin`으로 설정\n\n공개 사이트는 관리자 콘솔의 공개 API에서 콘텐츠를 읽습니다. 관리자 콘솔은 Neon PostgreSQL 데이터베이스를 사용하고, Google OAuth로 관리자 로그인을 보호합니다.\n\n## 라이선스\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmow-coding%2Fbasic-website-cms","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmow-coding%2Fbasic-website-cms","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmow-coding%2Fbasic-website-cms/lists"}