[Auth] 사업장 회원가입·초기 ADMIN 계정 생성 API 구현

[hywznn]

한 줄 목표

회원가입 화면에서 사업장과 최초 담당자 계정을 실제로 등록하고, 가입한 이메일로 바로 로그인할 수 있게 합니다.

확인된 문제

Client의 SignupPage는 화면 유효성 검사만 한 뒤 /?signup=success로 이동합니다.

TODO(backend): POST /api/auth/signup

Server에는 로그인·재발급·로그아웃 API는 있지만 회원가입 API가 없습니다. 따라서 현재 화면에서 가입해도 company와 user_account가 생성되지 않습니다.

공식 API

POST /api/v1/auth/signup

요청

{
  "company_name": "한빛정밀",
  "display_name": "김경민",
  "email": "name@company.com",
  "password": "8자 이상의 비밀번호"
}

화면의 workplace는 company_name, name은 display_name으로 매핑합니다. confirmPassword는 Client에서 일치 여부만 확인하며 Server에 전송하지 않습니다.

성공 응답

• 201 Created
• 생성된 user_id, company_id, 사업장명, 담당자 표시 이름, 이메일, ADMIN 역할 반환
• Access/Refresh Token을 자동 발급하지 않고 기존 로그인 화면으로 이동

구현 범위

• Signup request/response DTO와 Bean Validation
• Company와 최초 ADMIN UserAccount를 같은 transaction에서 생성
• 비밀번호 BCrypt hash 저장과 원문 비저장
• user_account.display_name 후속 Flyway migration
• 이메일 소문자·공백 정규화와 전역 중복 방지
• 중복 이메일의 안정적인 409 EMAIL_ALREADY_REGISTERED
• 회원가입 성공·거부 privacy-safe Auth audit event
• POST /api/v1/auth/signup Public Security 경로 등록
• 가입 직후 기존 /api/v1/auth/login 성공 확인
• OpenAPI 요청·응답·오류 예시와 README 갱신

보안·개인정보 규칙

• 비밀번호, password hash, 이메일 원문을 일반 로그·감사로그에 남기지 않습니다.
• 비밀번호는 8~128자, BCrypt 한계 때문에 UTF-8 72바이트 이하로 제한합니다.
• Client가 보낸 role과 companyId는 받지 않습니다. 최초 계정은 Server가 항상 ADMIN으로 결정합니다.
• 사업장과 계정 중 하나만 생성되는 상태가 없도록 transaction rollback을 검증합니다.
• 자동 로그인하지 않으며 Refresh Token을 응답 본문에 넣지 않습니다.
• 이메일 인증·초대·MFA·비밀번호 재설정은 별도 후속 기능입니다.
• 외부 공개 운영 전에는 API Gateway 또는 배포 경계의 회원가입 Rate Limit 정책을 추가로 확정합니다.

완료 조건

• 정상 가입에서 Company와 ADMIN이 한 번씩 생성됩니다.
• 저장된 비밀번호가 원문이 아니며 가입한 비밀번호로 로그인됩니다.
• 같은 이메일을 대소문자·공백만 바꿔 다시 가입해도 409이고 새 Company가 남지 않습니다.
• 잘못된 이메일·짧거나 긴 비밀번호·빈 사업장명·빈 담당자명은 400입니다.
• 요청으로 role, company_id, 알 수 없는 field를 보내면 반영되지 않고 안전하게 거부됩니다.
• OpenAPI와 전체 테스트·PostgreSQL migration validation이 통과합니다.

경계

• Server는 사업장과 초기 계정 생성만 담당합니다.
• Client는 workplace/name을 공식 API field로 변환하고 오류를 화면에 표시합니다.
• 이용약관·개인정보 처리방침의 실제 동의 UI·버전·시각 보존 정책은 제품 정책 확정 후 별도 이슈로 다룹니다.

관계

• 기반: [Auth & Security] JWT 인증·사업장 권한·멀티테넌시 구현 #4 Auth·Company
• 화면 연결: fowoco/client SignupPage
• 후속: [Settings] 사업장 설정 조회·수정 API 구현 #16 Settings, 담당자 초대·이메일 인증
• Parent: [EPIC] FOWOCO Server Roadmap · Controlled AI Workflow MVP #2

[hywznn]

구현 PR을 연결했습니다: #44

완료한 서버 범위:

• POST /api/v1/auth/signup 추가
• 사업장과 최초 ADMIN 계정을 하나의 트랜잭션으로 생성
• 이메일 중복·동시 가입 충돌 처리
• 비밀번호 BCrypt 해시 저장 및 민감값 응답·로그 제외
• display_name Flyway V6 마이그레이션 추가
• 회원가입 후 기존 로그인까지 이어지는 통합 테스트 추가
• README와 OpenAPI 계약 갱신

서버는 회원가입 성공 시 토큰을 자동 발급하지 않습니다. 프론트에서는 성공 후 로그인 화면으로 이동하고, workplace → company_name, name → display_name으로 매핑하면 됩니다. confirmPassword는 서버에 보내지 않고 화면에서만 일치 여부를 검사합니다.

현재 상태: Draft PR 검토 및 CI 확인 중 · Reviewer: @chaeliki

[hywznn]

CI 확인 완료: Test and build가 통과했습니다. 이제 #44의 코드 리뷰와 Draft 해제 후 병합하면 이 이슈가 자동으로 닫힙니다.

[BcKmini]

다되면 확인함--연결해야줴

• POST /api/v1/auth/signup 실제 호출로 교체해야함
• 이미 #100/#101에서 만든 apiFetch/ApiError 공통 인프라 재사용
• 409 EMAIL_ALREADY_REGISTERED → 이메일 필드 예외처리
• 400 필드 검증 오류 → 기존 fieldErrors 표시 방식에 매핑
• 성공(201) 시 자동 로그인 없이 기존과 동일하게 로그인 화면 + 성공 배너로 이동