Files
sam-docs/dev/changes/20251225_employee_user_linkage.md
권혁성 db63fcff85 refactor: [docs] 팀별 폴더 구조 재편 (공유/개발/프론트/기획)
- 개발팀 전용 폴더 dev/ 생성 (standards, guides, quickstart, changes, deploys, data, history, dev_plans 이동)
- 프론트엔드 전용 폴더 frontend/ 생성 (api/ → frontend/api-specs/)
- 기획팀 폴더 requests/ 생성
- plans/ → dev/dev_plans/ 이름 변경
- README.md 신규 (사람용 안내), INDEX.md 재작성 (Claude Code용)
- resources.md 신규 (노션 링크용, assets/brochure 이관 예정)
- CURRENT_WORKS.md 삭제, TODO.md → dev/ 이동
- 전체 참조 경로 업데이트

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-05 16:46:03 +09:00

2.0 KiB

변경 내용 요약

날짜: 2025-12-25 작업자: Claude Code 이슈: employee-user-linkage-plan.md 구현

📋 변경 개요

사원-회원 연결 기능의 핵심 API 구현:

  • 사원 전용 등록 (시스템 계정 없이)
  • 계정 해제 기능 (revokeAccount)

📁 수정된 파일

1. api/app/Services/EmployeeService.php

  • store(): password 생성 로직 수정 - create_account=false면 password=NULL 허용
  • revokeAccount(): 신규 메서드 추가 - 시스템 계정 해제 (password=NULL, 토큰 무효화)

2. api/app/Http/Controllers/Api/V1/EmployeeController.php

  • revokeAccount(): 신규 액션 추가
  • createAccount(): 응답 메시지 i18n 키로 변경

3. api/routes/api.php

  • POST /employees/{id}/revoke-account 라우트 추가

4. api/lang/ko/employee.php (신규)

  • 사원 관련 메시지 키 정의

5. api/lang/en/employee.php (신규)

  • 영문 메시지 키 정의

🔧 상세 변경 사항

1. EmployeeService::store() 수정

변경 전:

'password' => Hash::make($data['password'] ?? Str::random(16)),

변경 후:

$password = null;
$createAccount = $data['create_account'] ?? false;
if ($createAccount && ! empty($data['password'])) {
    $password = Hash::make($data['password']);
}
// ...
'password' => $password,

이유: 사원 전용 등록 지원 (로그인 불가)

2. EmployeeService::revokeAccount() 추가

public function revokeAccount(int $id): TenantUserProfile
{
    // tenant_id 격리 적용
    // password=NULL로 설정 (로그인 불가)
    // 기존 토큰 무효화
}

이유: 시스템 계정 해제 기능

테스트 체크리스트

  • PHP 문법 검사 통과
  • Pint 코드 포맷 통과
  • 라우트 등록 확인
  • Swagger 문서 작성 (추후)
  • API 통합 테스트 (추후)

⚠️ 배포 시 주의사항

  • users.password 컬럼이 nullable인지 확인 필요
  • 기존 사원 데이터에 영향 없음

🔗 관련 문서

  • docs/dev_plans/employee-user-linkage-plan.md