gbpark
68f85f3736
- 첫 로그인 비번 강제 변경 (RUN_082): FORCE_PASSWORD_CHANGE 컬럼, ForcePasswordChangeGuardFilter, /auth/change-password API + 페이지 - 테넌트 일관성 가드: TenantConsistencyGuardFilter 로 JWT.company_code ↔ 서브도메인 company_code 대조, CompanyResolver 가 (db_name, company_code) 동시 반환 - 회사 관리 확장 (RUN_083 audit log, RUN_084 lifecycle 컬럼): CompanyAdmin/Members/Templates/Lifecycle/AuditLog 서비스 + CompanyMgmtController + SuperAdminGuard - 회사 관리 UI: CompanyAccordionRow 탭화 + 모달 4종 (AdminInfo/Deactivate/Delete/RecopyTemplates) + AuditLogDrawer + csvExport - 프로비저닝 마법사: force_password_change 토글 반영 - 프론트 인증: storage 이벤트 멀티탭 동기화, 403 errorCode (PASSWORD_CHANGE_REQUIRED / CROSS_TENANT_REJECTED / TENANT_NOT_RESOLVED) 전역 리다이렉트 - 기타: StartupSchemaMigrator, OS별 도커 기동 스크립트, CLAUDE.md 트래킹 Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
scripts/start — invyone 도커 기동 스크립트
플랫폼별 1-클릭 실행 스크립트. docker/dev/docker-compose.invyone.yml 을 기준으로 프론트엔드 + 백엔드-스프링 컨테이너를 자동 기동합니다.
파일 구성
| 파일 | 플랫폼 | 실행 방법 |
|---|---|---|
invyone-start-docker-all.bat |
Windows | 더블클릭 또는 cmd 에서 실행 |
invyone-start-docker-all.sh |
Linux | ./invyone-start-docker-all.sh |
invyone-start-docker-all.command |
macOS | Finder 더블클릭 (Terminal 자동 오픈) |
하는 일
dockerCLI 설치 여부 + daemon 실행 여부 체크docker compose -f docker/dev/docker-compose.invyone.yml up -d실행- 컨테이너 상태 + 접속 URL 안내 출력
접속 URL (기동 후)
| 대상 | URL |
|---|---|
| Frontend | http://localhost:9772 |
| Backend API | http://localhost:8083/api |
| 테넌트 (서브도메인) | http://<subdomain>.localhost:9772 — 예: http://test01.localhost:9772 |
서브도메인 멀티테넌시는 *.localhost RFC 6761 자동 매핑을 이용합니다 (Chrome / Firefox / Edge 기본 지원, hosts 편집 · DNS 설정 불필요).
리눅스/맥 첫 실행 전 — 실행 권한 1회
chmod +x scripts/start/invyone-start-docker-all.sh
chmod +x scripts/start/invyone-start-docker-all.command
Windows 에서 작성된 파일을 git 으로 받은 경우 executable bit 가 빠질 수 있습니다. 리포에 박아두려면:
git update-index --chmod=+x scripts/start/invyone-start-docker-all.sh
git update-index --chmod=+x scripts/start/invyone-start-docker-all.command
관련 명령 (참고용)
| 용도 | 명령 |
|---|---|
| 로그 실시간 | docker compose -f docker/dev/docker-compose.invyone.yml logs -f |
| 재시작 (볼륨 유지) | docker compose -f docker/dev/docker-compose.invyone.yml restart |
| 컨테이너 내리기 | docker compose -f docker/dev/docker-compose.invyone.yml down |
| 상태 확인 | docker ps |
트러블슈팅
docker daemon 이 실행 중이지 않습니다
Docker Desktop 실행 후 재시도.
포트 충돌 (9772 / 8083)
같은 머신에서 다른 프로젝트가 해당 포트를 점유했는지 확인 (docker ps · 태스크 매니저 · lsof -i :9772). 필요하면 docker-compose.invyone.yml 의 호스트 포트 매핑을 바꿔서 회피.
테넌트 서브도메인 접속 시 META DB 로 떨어지는 경우
현재 백엔드 SubdomainResolverFilter 와 프론트 subdomain.ts / client.ts 는 *.invyone.com 만 서브도메인으로 인식합니다. dev 환경에서 *.localhost 를 허용하는 패치는 별도 작업으로 예정 (TENANT_ALLOWED_SUFFIXES / NEXT_PUBLIC_TENANT_HOST_SUFFIXES 환경변수 기반).
프론트 routes-manifest.json ENOENT
frontend/next.config.mjs 의 output: "standalone" + experimental.webpackMemoryOptimizations: true 가 dev 모드에서 청크/매니페스트를 깨는 이슈. 이미 isDev 분기로 수정됨 (2026-04-07). 재발 시 해당 설정이 prod build 전용인지 확인.
전제 조건
- Docker Desktop (Windows/Mac) 또는 docker-ce + docker-compose-plugin (Linux)
- 프로젝트 루트에
docker/dev/docker-compose.invyone.yml존재 - 본인 로컬 머신에
.env등 필요 설정이 이미 놓여있어야 함 (syncthing 환경이면 자동 동기화)