설정 마법사
TYDRB 초기 설정 마법사의 단계별 입력 항목과 점검 사항
TYDRB는 설정 파일이 없는 상태로 처음 실행하면 웹 기반 설정 마법사를 자동으로 표시합니다. 이 마법사는 최초 부팅 시점의 필수 값을 빠르게 채우기 위한 흐름이며, 완료 후에는 일반 설정 파일 관리 체계로 전환됩니다.
언제 사용하나
- 신규 인스턴스를 처음 부팅할 때
- 검증 환경에서 최소 설정으로 빠르게 실행할 때
- 운영자가 텍스트 설정 파일보다 웹 UI 기반 초기화가 더 안전한 경우
이미 설정 파일이 존재한다면 마법사는 다시 열리지 않으며, 이후 변경은 설정 파일 또는 관리 기능을 통해 수행합니다.
전체 흐름
설정 마법사는 일반적으로 다음 3단계로 구성됩니다.
- 기관 정보 입력
- 관리자 계정 생성
- 시스템 기본 설정 저장
완료 후 서버가 재시작되거나 초기화 단계를 마무리한 뒤 로그인 화면으로 이동합니다.
1. 기관 정보 입력
이 단계에서는 시스템 기본 식별값을 입력합니다.
- 기관명 또는 서비스 표시 이름
- 기본 URL 또는 접속 주소
- 운영자 연락처 또는 대표 메일 주소
- 시간대, 언어 등 기본 로케일 설정
권장 사항:
- 기관명은 사용자에게 그대로 노출되므로 약칭보다 공식 표기를 권장합니다.
- 운영 URL이 확정되지 않았다면 검증 환경 주소를 임시로 사용하되, 운영 전 다시 확인하십시오.
2. 관리자 계정 생성
최초 관리자 계정은 시스템 전체 설정과 사용자 관리를 담당하므로 가장 신중하게 입력해야 합니다.
- 관리자 이름
- 로그인 ID 또는 이메일
- 초기 비밀번호
권장 사항:
- 공용 계정보다는 개인 식별이 가능한 관리자 계정으로 시작하십시오.
- 초기 비밀번호는 테스트용으로 끝내지 말고 바로 운영 기준에 맞게 설정하십시오.
- 가능하면 최초 로그인 직후 비밀번호 정책과 추가 관리자 계정을 함께 정리하십시오.
3. 시스템 기본 설정
이 단계에서는 애플리케이션이 바로 동작하는 데 필요한 최소 인프라 값을 저장합니다.
- 데이터베이스 종류와 연결 정보
- 파일 저장 경로 또는 스토리지 설정
- 메일 발송 여부와 발신자 정보
- 보안 관련 기본 옵션
검증 환경에서는 SQLite와 로컬 스토리지로 시작할 수 있지만, 운영 환경에서는 기관 표준 스토리지와 백업 전략을 고려해야 합니다.
완료 후 확인 사항
설정 마법사가 끝나면 아래 항목을 바로 점검하는 편이 안전합니다.
- 로그인 화면으로 정상 이동하는지
- 생성한 관리자 계정으로 로그인 가능한지
- 대시보드 또는 첫 화면에 치명적인 설정 오류가 없는지
- 업로드 경로, 메일, 외부 URL이 운영 환경과 맞는지
자주 놓치는 부분
- 검증 환경 주소를 운영 주소로 착각한 채 배포하는 경우
- 공용 관리자 계정 하나만 만들고 책임 추적 체계를 나중으로 미루는 경우
- 로컬 스토리지를 운영 환경에 그대로 두는 경우
- 메일 미설정 상태로 승인 알림 워크플로우를 검증하지 않는 경우