직원 앱 도입·안내·이용 현황
담당자와 진입 위치
| 항목 | 내용 |
|---|---|
| 관리자 | 시작하기의 「직원 앱 도입」. 목표 달성 또는 완료 처리 후에는 「설정 > 직원 앱 도입」에서 다시 엽니다. |
| 직원 | 처음 로그인한 뒤 사용 안내. 나중에는 「더보기 > 사용 안내 다시 보기」 |
| 사전 조건 | 올바른 회사 코드·직원 수신처·임시 비밀번호 정책. 실제 문자·이메일 발송에는 별도 발송 연동이 필요합니다. |
| 완료 판정 | 재직 직원 중 첫 로그인 이상인 비율과 목표값. 설치·로그인·비밀번호 변경·튜토리얼의 단계는 따로 확인합니다. |
도입 준비·현황 확인
- 「직원 앱 도입」에서 완료 기준과 현재 인원·진행률을 봅니다. 팀별·직원별 현황을 좁혀 미완료 대상을 확인합니다.
- 「설정」에서 완료 목표, 회사 코드, 안내 문구, 직원 안내 단계와 체크리스트를 확인·저장합니다. 회사 코드는 운영자가 조직에 연결한 값을 기본으로 쓰고, 직접 입력하면 그 값이 우선합니다. 취소하거나 저장하지 않고 닫은 값이 반영됐다고 가정하지 않습니다.
- 체크리스트의 수신처·비밀번호 정책·안내 발송·이용 현황·재안내·공지·완료 판정을 차례로 확인하고 해당 화면 바로가기로 부족한 설정을 보완합니다.
- 「미안내·안내 발송됨·앱 설치됨·첫 로그인·비밀번호 변경·튜토리얼 완료」를 구분합니다. 앞 단계가 충족되지 않으면 뒤 단계 기록이 있어도 진행 단계는 앞에 머무를 수 있습니다. 웹 접속을 휴대폰 앱 설치로 보지 않습니다.
안내 발송·재안내·출력
- 직원 관리에서 직원을 선택해 안내를 보내거나 도입 화면에서 선택·전체·미안내·미완료·실패 대상을 고릅니다.
- 문자 또는 이메일, 받는 직원 수와 수신처, 회사 코드·앱 링크·로그인 정보를 포함한 문구를 미리 확인합니다. 나에게 테스트 발송도 실제 외부 발송입니다.
- 발송을 확정하고 접수 결과·실패한 직원과 사유를 확인합니다. 수신처가 없거나 실패한 직원을 고쳐 다시 안내하며 이미 성공한 대상에게 중복 발송하지 않도록 범위를 확인합니다.
- 연락처가 없는 직원에게는 QR이 포함된 종이 안내문을 출력할 수 있습니다. 배포물에 로그인 정보가 들어가므로 해당 직원에게 전달합니다.
- 비밀번호를 이미 바꾼 직원의 안내에는 임시 비밀번호가 포함되지 않습니다. 새 임시 비밀번호는 안내 발송 접수가 성공한 뒤 저장됩니다. 실패 결과를 비밀번호 변경 완료로 설명하지 않습니다.
- 필요하면 앱 이용 안내 공지를 등록하고, 「배포 완료 보고」에서 요약·팀별·직원별 결과를 내려받습니다. 공지와 발송은 별도 조작입니다.
「완료 처리」 확인창은 이후 메뉴 위치를 안내합니다. 완료 후 화면이 사라진 것이 아니라 설정으로 이동한 것입니다. 목표를 이미 달성한 경우에는 「다시 열기」를 눌러도 시작하기 메뉴가 돌아오지 않습니다.
직원의 연결·첫 사용 안내
- 안내받은 회사 코드가 포함된 연결 링크를 엽니다. 앱이 없으면 설치 안내를 따르고, 앱이 열리면 회사 코드 화면의 코드를 확인합니다.
- 조직 연결을 확인한 뒤 로그인합니다. 링크를 열었다는 이유만으로 조직이 바뀌지 않습니다. 다른 배포 환경의 링크·설치된 앱 버전·운영자가 등록한 연결 정보가 맞아야 합니다.
- 비밀번호 변경이 필요하면 먼저 변경합니다. 이후 실제 화면 위 안내에서 알림, 근무표·출퇴근, 신청, 급여명세서, 불편 신고 위치를 확인합니다.
- 안내를 건너뛰어도 나중에 더보기에서 다시 볼 수 있습니다. 조직이 켠 안내 단계에 따라 순서가 달라질 수 있습니다. 알림 허용 여부는 기기 설정과 별개로 확인합니다.
연결·구현과 확인 범위
관리자는 apps/admin/src/onboarding.ts, 직원 단계는 직원 앱 셸과 app-onboarding 서비스, 단계 계산은 core의 resolveAppOnboardingStage가 담당합니다. 직원 목록의 앱 상태·필터와 같은 판정을 사용합니다. 발송 기록은 임시 비밀번호 평문을 보관하지 않습니다. 권한 미리보기에서는 실제 직원의 설치·안내 완료 기록을 남기지 않습니다.
PR #923·#935·#973·#1018과 현재 소스·화면을 대조했습니다. 외부 문자·이메일 발송, 스토어 설치와 iOS/Android 링크 실행은 이 로컬 환경에서 검증하지 않았습니다. 사용자용 절차는 관리자 가이드의 조직 설정과 직원 앱의 첫 로그인 절에 함께 반영합니다.