본사·현장관리자 가입은 이메일 인증을 먼저 완료한 뒤 비밀번호를 설정합니다. 발송 요청은 POST https://d2f845gr2v9cs2.cloudfront.net/api/v1/auth/team/email-codes에 { "email": "user@example.com" }을 보냅니다. 202는 발송 접수만 뜻하며, 응답 본문이나 발송 성공만으로 인증 완료 처리하지 않습니다.
사용자가 입력한 코드는 같은 CloudFront origin의 POST /api/v1/auth/team/email-codes/verify에 { "email": "user@example.com", "verificationCode": "123456" }으로 확인합니다. 로그인 토큰은 필요하지 않습니다. 200 응답의 data.verified가 true이고, verificationToken이 있으며 expiresAt이 미래인 경우에만 비밀번호 단계로 이동합니다. 프론트는 코드 제한시간 10분과 재발송 간격 60초를 표시합니다. 이메일 또는 코드가 바뀌거나 다시 발송하면 이전 인증 결과가 무효화됩니다.
가입 완료 시 기존 역할별 경로를 사용합니다. 본사는 POST /api/v1/auth/hq/register, 현장관리자는 POST /api/v1/auth/site/register에 기존 회사·담당자·현장 정보를 포함해 email, password, confirmPassword, verificationToken을 보냅니다. 인증 토큰은 브라우저 메모리에만 보관됩니다.
새 비밀번호는 프론트에서 8자 이상, 공백을 제외한 ASCII 영문·숫자·기호를 허용합니다. 반복 문자열, 연속 문자, 흔한 비밀번호 검사는 적용하지 않습니다. 프론트 안내·검증만으로 서버 정책 적용 여부를 뜻하지 않습니다. 비밀번호 입력에는 기존 자물쇠 애니메이션을 사용합니다. 실제 CloudFront CORS 및 운영 API 동작은 이 저장소의 모의 브라우저 검증만으로 확인되지 않았습니다.
현장관리자는 현장 관리 → 팀 관리 → 앱 초대에서 팀별 초대 링크를 발급합니다. 웹은 현장관리자 세션으로 POST /api/v1/site/teams/{teamId}/invitations를 본문 없이 요청하고, 응답의 inviteUrl을 표시·복사하거나 공유합니다. 팀원이 앱에서 초대를 수락하면 참여가 완료됩니다.
본사 관리자는 현장 상세의 앱 연동 상태에서 연결된 계정과 연결 여부를 조회합니다. 이때 본사 세션으로 GET /api/v1/hq/sites/{siteId}/app-links를 사용하며, 본사 화면에서는 초대 링크를 발급하지 않습니다.
개발 서버의 /api 요청은 http://127.0.0.1:8000으로 프록시됩니다. 로컬 백엔드와 프론트엔드를 각각 실행하세요.
heatguard-server 저장소에서 PowerShell로 실행합니다.
python -m venv .venv
.\.venv\Scripts\python.exe -m pip install -r requirements.txt
$env:DB_PATH = "$PWD\data\heatguard.db"
$env:SILO_COMPANY_NAME = "HeatGuard local test"
.\.venv\Scripts\python.exe local_server.py백엔드 저장소의 안내에 따라 본사 계정을 먼저 등록한 후 현장 계정을 생성하세요. 새 로컬 SQLite DB에는 기존 서비스의 현장 ID나 계정이 자동으로 복사되지 않습니다.
이 저장소에서 별도 PowerShell 창으로 실행합니다.
$env:VITE_DEMO_MODE = "false"
npm run dev -- --host 127.0.0.1브라우저에서 http://localhost:5173으로 접속하고, 로그인한 다음 현장 관리 → 시간 설정 → 기상청 수동 입력에서 온도와 습도를 저장해 확인할 수 있습니다. 로컬 백엔드 응답을 데모 데이터로 대체하지 않도록 VITE_DEMO_MODE=false를 사용합니다.