AI Safety Lab 사용자 매뉴얼
안전관리시스템 통합 가이드
10. FAQ 및 문제해결
AI Safety Lab 안전관리시스템 사용 중 자주 묻는 질문과 문제 해결 방법을 제공합니다.
10.1 로그인 관련
해결 방법: 사용자 계정의 권한 레벨을 확인하세요. 현장 관리자에게 권한 상향을 요청하거나, 올바른 현장에 배정되었는지 확인하세요.
해결 방법: JWT 토큰은 10시간 유효합니다. 만료 시 다시 로그인하시거나, 리프레시 토큰(24시간)을 사용하여 자동 갱신됩니다.
템플릿 관련
해결 방법: 브라우저 캐시를 새로고침(Ctrl+F5)하고, 템플릿 저장 후 활성화 상태를 확인하세요.
해결 방법: 네,
/app/templates/
에서 공용 템플릿을 복사한 후 현장별 수정이 가능합니다.
데이터 입력 관련
해결 방법: 파일 크기(10MB 이하)와 형식(JPG, PNG)을 확인하세요. 시스템에서 자동으로 2000x2000px, 70% 품질로 압축됩니다.
해결 방법: 필수 항목이 모두 입력되었는지 확인하고, 네트워크 연결 상태를 점검하세요.
권한 관련
해결 방법: 현장별 접근 권한 설정을 확인하세요.
/app/site_access_auth/
에서 메뉴별 접근 권한이 활성화되어 있어야 합니다.
해결 방법: 사용자는 소속된 현장(SC_ID)의 데이터만 볼 수 있습니다. 현재 선택된 현장을 확인하거나 관리자에게 문의하세요.
기술적 문제
해결 방법: 다음을 확인하세요:
- 브라우저 JavaScript 활성화
- API 호출 권한 확인
- 네트워크 연결 상태
- 콘솔 에러 메시지 확인
해결 방법: 차트 라이브러리 로딩을 확인하고, 데이터 형식이 올바른지 검증하세요. 차트는 데이터 변경 시 전체 재생성됩니다.
성능 개선
해결 방법: 다음을 시도해보세요:
- 브라우저 캐시 정리
- 불필요한 브라우저 확장 프로그램 비활성화
- 네트워크 연결 상태 확인
- 대용량 데이터 조회 시 기간 제한
문의 및 지원
기술 지원
시스템 관련 문의
연락처: IT 담당자
계정 관리
현장 관리자 또는 시스템 운영자
권한: 사용자 계정 관련 문의
기능 개선
개발팀 문의
목적: 새로운 기능 요청
부록
시스템 요구사항
- 브라우저: Chrome 90+, Firefox 88+, Safari 14+
- 해상도: 최소 1280x720 권장
- 네트워크: 안정적인 인터넷 연결
- JavaScript: 필수 활성화
용어 정리
- SC_ID: Site Company ID, 현장-회사 관계 식별자
- CAT_ID: Category ID, 현장 분류 식별자
- Template Type: 1(평가서), 2(체크리스트), 3(겸용)
- User Level: 0-10 권한 레벨 체계
- JWT: JSON Web Token, 인증 토큰
단축키
- Ctrl+S: 현재 작업 저장 (일부 폼에서)
- Ctrl+F5: 페이지 새로고침 (캐시 무시)
- Tab: 다음 필드로 이동
- Shift+Tab: 이전 필드로 이동