문서 레인
기준 문서와 정책
제품 방향, 정보구조, 운영 규칙을 먼저 고정해 라우트나 API가 제각각 흘러가지 않게 합니다.
docs/PROGRAM-STRUCTURE.mddocs/PRD.mddocs/MENU.mddocs/ARCHITECTURE.md
기대 결과
제품 방향과 시스템 구조를 위한 공통 기준선
Program operating map
Mirucoder를 문서 기준으로 만들고 운영하는 체계형 허브
이제 이 문서 허브는 `docs` 폴더, 제품 모듈, 실제 코드 경로, 진행 추적 문서를 한 구조로 연결해 다음 작업이 바로 보이도록 정리합니다.
4
문서 레인
8
제품 모듈
5
편집 표면
7
운영 로케일
실행 순서
이 순서로 시작합니다
구조 문서를 먼저 확인하고, 관련 task/track 문서를 연 뒤, 맞는 코드 표면을 수정하고, 마지막에 빌드 검증과 작업 로그까지 닫는 흐름입니다.
01
기준 문서 확인
제품 동작을 바꾸기 전에 구조 문서, PRD, 메뉴, 아키텍처 문서를 먼저 엽니다.
PROGRAM-STRUCTURE.mdPRD.mdMENU.mdARCHITECTURE.md
02
paired tracker 선택
수정하는 모듈에 해당하는 development-track 문서와 task 문서를 함께 엽니다.
docs/DEVELOPMENT-TRACK/NN-*.mddocs/task/NN-*.md
03
맞는 레이어에서 구현
변경이 정말 필요할 때만 라우트에서 쿼리, DB 레이어로 내려갑니다.
src/app/[locale]/*src/server/queries/*sql/mssql/*
04
검증과 문서 마감
빌드와 스모크를 확인하고, 진행률과 작업 로그까지 함께 갱신해 문서를 코드와 같은 최신 상태로 둡니다.
npm run buildWORKLOG.mddocs/README.mdtask progress
문서 레인
문서 레인
전략, 화면 설계, 구현 추적, 운영 기준이 각자 흩어지지 않도록 네 개의 레인으로 문서를 묶어 관리합니다.
문서 레인
경험 설계와 프리미엄 디자인
퍼블릭 페이지의 분위기, 시각 언어, 실사/SVG 자산 전략, 사용자 경험 기대치를 정의합니다.
docs/HOMEPAGE-DESIGN-RULES.mddocs/HOMEPAGE-WIREFRAME.mddocs/images/PAGE-IMAGE-ASSET-MASTER-PLAN.mddocs/LIVE-WEBRTC-ROOM-ARCHITECTURE.md
기대 결과
브랜드와 기능 의도에 맞는 프리미엄 UI 방향
문서 레인
실행 트랙과 완성도 관리
체크리스트 문서와 task 문서를 함께 운용해 진행 상태와 완성 품질을 동시에 추적합니다.
docs/DEVELOPMENT-TRACK/README.mddocs/DEVELOPMENT-TRACK/00-MASTER-CHECKLIST.mddocs/task/README.mddocs/DEVELOPMENT-TRACK/WORKLOG.md
기대 결과
진행률 가시성, 완료 우선 운영, 작업 로그 축적
문서 레인
인프라와 플랫폼 운영
개발 환경, DB 규칙, 배포 흐름, 복구 기준까지 재현 가능하게 유지합니다.
docs/WEB-SETUP.mddocs/DB-SETUP.mddocs/DATABASE-RULES.mddocs/DEPLOYMENT_NGINX_SSL_ROADMAP.md
기대 결과
개발, DB, 배포 작업의 운영 일관성
프로그램 모듈 아틀라스
프로그램 모듈 아틀라스
각 모듈은 실제 라우트, 주 코드 경로, 그리고 함께 갱신해야 할 추적 문서까지 한 카드 안에서 연결됩니다.
Home
/랜딩 구조, 플랫폼 서사, 프리미엄 브랜드 방향, 주요 진입 동선.
주 코드 경로
src/app/[locale]/page.tsx
추적 문서
docs/task/01-home.md
모듈 열기->
Posts
/posts게시글 발행, 공식 뉴스, 튜토리얼, 상세 페이지, 에디토리얼 UX.
주 코드 경로
src/app/[locale]/posts/*
추적 문서
docs/task/02-posts.md
모듈 열기->
Projects
/projects협업 보드, 팀 모집 흐름, 프로젝트 참여 중심 발견 구조.
주 코드 경로
src/app/[locale]/projects/*
추적 문서
docs/task/03-projects.md
모듈 열기->
Live
/live라이브 룸 탐색, 실시간 참여, 스트리밍 중심 협업 경험.
주 코드 경로
src/app/[locale]/live/*
추적 문서
docs/task/04-live.md
모듈 열기->
Community
/community채팅룸, 언어별 공간, 룰과 운영 기준, 대화 중심 합류 동선.
주 코드 경로
src/app/[locale]/community/*
추적 문서
docs/task/05-community.md
모듈 열기->
Docs
/docs가이드, 제품 이해, 기여자용 구조화된 시작 지점.
주 코드 경로
src/app/[locale]/docs/*
추적 문서
docs/task/06-docs-guide.md
모듈 열기->
Volunteer
/volunteer사람 중심 캠페인, 프리미엄 신뢰 레이어, 투명한 지원 흐름.
주 코드 경로
src/app/[locale]/volunteer/*
추적 문서
docs/task/10-volunteer.md
모듈 열기->
Dashboard
/dashboard로그인 사용자 개요, 내 작업, 프로필, 라이브 제어, 워크스페이스 도구.
주 코드 경로
src/app/[locale]/dashboard/*
추적 문서
docs/task/07-auth-profile.md
모듈 열기->
실제 수정 표면
실제 수정 표면
라우트, 데이터 정책, 카피, 이미지, 검증이 뒤엉키지 않도록 변경은 항상 맞는 표면 안에서 처리합니다.
라우트와 페이지 표면
페이지 구성, 로딩/빈 상태, 메타데이터, UI 수준 동작을 다룹니다.
src/app/[locale]/*src/components/*
쿼리와 데이터 정책
조회 조합, 권한을 고려한 데이터 흐름, 서버 비즈니스 규칙을 다룹니다.
src/server/queries/*src/app/api/*
DB와 스키마
스키마, 프로시저, 재현 가능한 SQL, 데이터 운영 기준을 유지합니다.
sql/mssql/*docs/DB-SETUP.mddocs/DATABASE-RULES.md
카피와 다국어
로케일별 메시지, 폴백 품질, 기여자 관점의 명확한 문구를 관리합니다.
messages/*.jsondocs/I18N-CHECKLIST.md
비주얼 자산 시스템
공식 퍼블릭 페이지용 로컬 이미지, SVG 보조 그래픽, 소싱 이력을 관리합니다.
public/images/*docs/images/*
실행 순서
실행 순서
문서, 구현, 검증이 늘 같은 방향으로 움직이도록 Mirucoder는 아래 순서로 작업을 닫습니다.
01
기준 문서 확인
제품 동작을 바꾸기 전에 구조 문서, PRD, 메뉴, 아키텍처 문서를 먼저 엽니다.
PROGRAM-STRUCTURE.mdPRD.mdMENU.mdARCHITECTURE.md
02
paired tracker 선택
수정하는 모듈에 해당하는 development-track 문서와 task 문서를 함께 엽니다.
docs/DEVELOPMENT-TRACK/NN-*.mddocs/task/NN-*.md
03
맞는 레이어에서 구현
변경이 정말 필요할 때만 라우트에서 쿼리, DB 레이어로 내려갑니다.
src/app/[locale]/*src/server/queries/*sql/mssql/*
04
검증과 문서 마감
빌드와 스모크를 확인하고, 진행률과 작업 로그까지 함께 갱신해 문서를 코드와 같은 최신 상태로 둡니다.
npm run buildWORKLOG.mddocs/README.mdtask progress