Percentin DEV HUB
PRIVATE · CEO ONLY
AI 프롬프트 — 클릭 → 복사 → AI에게 붙여넣기
프롬프트 로딩 중...
개발 시스템 v2.0 업그레이드
포트
로컬 서버 포트 구성
▾
| 포트 | 서버 | 설명 |
|---|---|---|
| 3001 | 개발 대시보드 | _logs/server.js — 메인 개발 시스템 |
| 5173 | Flutter 웹 (고객) | percentin-app — 고객 계정 프리뷰
OAuth(카카오/네이버) redirect URI 여기에 등록됨
|
| 5175신규 | Flutter 웹 (관리자) | percentin-app — 관리자 계정 프리뷰
devpreview=admin mock 모드 전용 — OAuth 사용 안 함
|
| 3002 | Next.js 관리자웹 | percentin-admin-web — 관리자 대시보드 |
| 3000 | Saybl 시스템 | saybl-system (별도 프로젝트) |
START.bat이 3001, 5173, 3000 포트를 자동 정리 후 서버 시작.
v2.0 업그레이드 후 5175 포트도 자동 정리 대상에 추가됩니다.
v2.0 업그레이드 후 5175 포트도 자동 정리 대상에 추가됩니다.
체크리스트
대표님이 직접 해야 할 일
▾
개발 시스템 v2.0 업그레이드 전
✓
안티에게 업그레이드 승인
ANTI_DEV_SYSTEM_UPGRADE_PROMPT.md 검토 완료 → 승인 시 안티가 작업 시작
업그레이드 진행 중 (안티/코드가 처리)
—
5175 포트 Flutter 서빙 추가
flutter-watch.js 수정 — 안티/코드가 자동 처리, 대표님 개입 불필요
—
dashboard.html 멀티패널 UI 교체
Node.js 스크립트 방식으로 안티가 단계별 작업
—
preview-presets.json 생성
_config/ 폴더에 프리셋 6개 이상 정의 — 안티가 생성
카카오 / 네이버 개발자 센터
결론: 추가 등록 불필요
5175 포트는 devpreview=admin mock 모드 전용입니다. 이 모드에서는 실제 OAuth(카카오/네이버 로그인)를 사용하지 않고 mock 인증으로 자동 로그인됩니다. 따라서 개발자 센터에 5175 Redirect URI를 등록하지 않아도 됩니다.
5175 포트는 devpreview=admin mock 모드 전용입니다. 이 모드에서는 실제 OAuth(카카오/네이버 로그인)를 사용하지 않고 mock 인증으로 자동 로그인됩니다. 따라서 개발자 센터에 5175 Redirect URI를 등록하지 않아도 됩니다.
—
카카오 개발자 센터 → 5175 Redirect URI 등록
불필요 — mock 모드는 OAuth를 사용하지 않음
—
네이버 개발자 센터 → 5175 Redirect URI 등록
불필요 — 동일한 이유
!
만약 5175에서 실제 로그인이 필요해지면
카카오: developers.kakao.com → 앱 → 플랫폼 → Web → http://localhost:5175 추가
네이버: developers.naver.com → 앱 → API 설정 → Callback URL → http://localhost:5175 추가
네이버: developers.naver.com → 앱 → API 설정 → Callback URL → http://localhost:5175 추가
업그레이드 완료 후 확인
→
START.bat 재실행 후 대시보드 확인
localhost:3001 → 프리뷰 모드 탭에서 멀티패널 정상 작동 확인
→
고객/관리자 패널 세션 독립 확인
왼쪽 패널(5173 고객)과 오른쪽 패널(5175 관리자)이 각각 다른 계정으로 표시되는지 확인
→
프리셋 6개 이상 작동 확인
드롭다운 또는 버튼 그룹에서 프리셋 선택 시 패널들이 동시에 이동하는지 확인
참고
알아두어야 할 것들
▾
devpreview 파라미터 (기존 시스템)
✓
?devpreview=customer → 5173 (고객 mock 모드)
이미 구현된 파라미터. 고객 목 데이터로 자동 로그인. Firebase 호출 없음
✓
?devpreview=admin → 5175 (관리자 mock 모드)
이미 구현된 파라미터. 관리자 목 데이터로 자동 로그인. 5175 포트로 세션 독립
절대 하지 말아야 할 것
!
firebase_config.dart의 useMockMode 로직 수정 금지
이 파일을 건드리면 기존 devpreview 모드 전체가 망가짐
!
Flutter 웹앱 포트 5173 변경 금지
카카오/네이버 OAuth Redirect URI에 5173이 이미 등록되어 있음
!
?mock=true 파라미터 새로 만들지 말 것
기존 ?devpreview 파라미터를 그대로 사용해야 함. 중복 생성 금지
마우스 드래그 스크롤 (슬라이더 카드 문제)
코드에게 Flutter ScrollBehavior 수정 프롬프트를 전달하면 해결됩니다.
MaterialApp에 AppScrollBehavior() 추가 — 실기기 동작 영향 없음.
코드에게 Flutter ScrollBehavior 수정 프롬프트를 전달하면 해결됩니다.
MaterialApp에 AppScrollBehavior() 추가 — 실기기 동작 영향 없음.
서비스 링크
Firebase
스토어 · 배포
결제 · 도메인
OAuth · API
서비스 · 기타