S-CORE 사용 설명서

자동 이력 기록 시스템

사원관리에서 부서를 변경하면 dept_history 배열에 이력이 자동으로 기록됩니다. 이를 통해 기사가 작성된 시점의 부서를 정확히 추적할 수 있습니다.

권한 검증 강화 + 세션 만료 통합

• 세션 검증 공통 함수: common.js에 validateSession() 함수 추가. 로그인 체크 + 24시간 세션 만료를 한 번에 처리하여 모든 페이지에서 일관된 세션 관리
• 전 페이지 세션 만료 적용: 기존에 세션 만료 체크가 누락되었던 score-dashboard, score-eval, score-penalties, score-appeals, score-config, dept-manage, score-my 7개 페이지에 24시간 만료 체크 추가
• home.html admin-only 수정: 네비게이션 메뉴에 admin-only 클래스 + IIFE 스크립트 추가. URL 직접 접근 시에도 admin 전용 메뉴가 비로그인 사용자에게 노출되지 않도록 방지
• score-my.html admin-only 추가: admin-only CSS + IIFE 스크립트 추가하여 다른 페이지와 동일한 패턴으로 통일
• list.html manager URL 우회 방지: manager가 URL 파라미터(?dept=다른부서)로 타 부서 접근 시도 시 자기 부서로 강제 변경 + URL 히스토리 교체
• 부서 접근 검증 함수: common.js에 validateDeptAccess() 함수 추가. manager 부서 격리를 공통으로 처리할 수 있는 유틸리티

동기화 자동 재시도 + UI 시각 개선

• 동기화 자동 재시도 시스템: 네트워크 오류로 실패한 동기화를 자동으로 재시도. 페이지 로드 1초 후 즉시 재시도, 30초 주기 자동 재시도(pending 있을 때만), 온라인 복귀 시 즉시 재시도. 최대 3회 실패 시 해당 항목 자동 폐기
• 편집 셀 시각적 피드백: 부서 대시보드에서 점수 편집 후 저장 중 파란색(saving), 저장 완료 시 초록색 플래시(saved) 애니메이션으로 저장 상태를 시각적으로 확인 가능
• 등급 배지 디자인 개선: S/A+/A/B+/B 등급 배지에 그라데이션 배경, 그림자 효과 추가. 호버 시 확대 + 빛 반사 애니메이션
• 통계 카드 디자인 개선: 상단 파란색 악센트 바 추가, 호버 시 부드러운 상승 효과 + 그림자 강화
• 저장 완료 토스트: 자동 저장(셀 편집 후 800ms) 및 수동 저장(저장 버튼) 시 성공 토스트 메시지 표시
• 모바일 테이블 스크롤 인디케이터: 768px 이하에서 테이블 우측에 그라데이션 스크롤 힌트 표시

전체 코드 검증 및 보안 수정

• 전체 코드 자동 검증: Claude API 병렬 처리로 8개 영역(네비게이션 일관성, 권한 체크, JS 로드 순서, 데이터 흐름, HTML 접근성, Lambda 보안, 프론트엔드 버그, CSS 반응형) 동시 검증 수행
• 네비게이션 admin-only 일관성 수정: score-config.html, admin.html, dept-manage.html 3개 admin 전용 페이지에서 대시보드/가중치설정/사원관리/부서관리 메뉴에 admin-only 클래스가 누락되어 있던 문제 수정. IIFE 스크립트 및 CSS도 함께 추가하여 다른 페이지와 동일한 패턴으로 통일
• JS 로드 순서 수정: dept-manage.html에서 score.js 없이 score-data.js만 로드하던 문제 수정. score-data.js가 score.js의 migrateConfigV2toV3, restoreInfinity, DEFAULT_CONFIG_V3를 참조하므로 정상 로드 순서(common.js → config.js → score.js → score-data.js)로 변경
• XSS 취약점 수정: score-dashboard.html의 startEd() 함수에서 기자명이 HTML에 직접 삽입되던 XSS 취약점을 safeName 이스케이프 처리로 수정
• Lambda manager_scores 타입 추가: evaluation_api Lambda의 TYPE_KEY_MAP에 manager_scores 타입이 누락되어 부장 입력 점수가 서버에 저장/조회되지 않던 문제 수정. 병합(merge) 방식 저장 로직도 함께 추가

보안 강화

• 로그인 서버 인증 전환: 기존에 프론트엔드에서 users.json을 직접 fetch하여 비밀번호를 비교하던 방식을 Lambda 서버 인증으로 전환. 브라우저 개발자도구(Network 탭)에서 비밀번호 목록이 노출되지 않음
• 비밀번호 변경 서버 처리: 비밀번호 변경도 Lambda에서 검증 및 저장 처리. 프론트엔드에서 users.json 전체를 다운로드하지 않음
• Lambda users_api 확장: 기존 GET(조회)/POST(저장) 외에 action: 'login'(로그인 인증), action: 'change_password'(비밀번호 변경) 엔드포인트 추가. 기존 사원관리 저장 기능은 그대로 유지
• 로그인 응답 최소화: 로그인 성공 시 비밀번호를 제외한 사용자 정보(사번, 이름, 권한, 부서, 직급)만 반환

대시보드 UI 정리

• 관리자 대시보드(home.html) 불필요 섹션 제거: 기사수 TOP 10 테이블, 일별 기사수 추이 차트 제거. 월 변경 시 2월 데이터만 표시되던 버그가 있었으며, 기자 점수 TOP 10과 정보가 중복되어 삭제
• 부서 대시보드(score-dashboard.html) 불필요 섹션 제거: 부서 기사수 TOP 10, 최근 일별 기사수 테이블, 일별 기사수 추이 차트 제거. 점수표와 가감점 현황에 집중하도록 간소화
• Chart.js 의존성 제거: 차트 섹션 제거에 따라 home.html, score-dashboard.html에서 Chart.js CDN 로드 및 관련 변수(dailyChart) 제거. 페이지 로딩 속도 개선
• 가감점 현황 레이아웃 확장: home.html에서 가감점 현황 카드를 col-md-6에서 col-12(전체 너비)로 변경하여 가독성 향상

신규 기능 및 개선

• 비밀번호 변경 기능: 로그인 페이지 하단에 비밀번호 변경 링크 추가. 사번과 현재 비밀번호 확인 후 새 비밀번호 설정 가능. 변경 후 자동 로그아웃되어 재로그인 필요
• 관리자 대시보드 개편: 기존 기사수 통계만 표시하던 대시보드에 기자 점수 TOP 10, 부서별 평균 점수, 가감점 현황, 평가 완료율 등 점수 관련 정보 추가. 월별 필터 지원

신규 기능 및 개선

• 부서 대시보드 통합 레이아웃: 기존 탭 구조(점수표/가감점/통계)를 제거하고 한 페이지에 점수표 → 가감점 현황 → 통계(TOP10, 일별 기사수, 차트) 순서로 통합 배치
• 네비게이션 순서 통일: 전체 9개 페이지의 메뉴 순서를 통일 (부서 대시보드 → 가감점 관리 → 기자 목록 → 기사 평가 → 소명 관리)
• 네비게이션 깜빡임 해결: admin 전용 메뉴가 페이지 로드 시 깜빡이던 현상을 CSS 클래스 + head 인라인 스크립트 방식으로 완전 해결
• admin 전용 페이지 메뉴 정리: 대시보드, 가중치 설정, 사원 관리, 부서 관리 페이지에서 모든 메뉴를 즉시 표시 (admin만 접근 가능하므로 숨김 불필요)
• 카드 헤더 색상 통일: 가감점 현황, 통계 카드 헤더를 점수표와 동일한 파란색(#2c5282)으로 통일
• 정보보고 직접 점수 입력: 가감점 관리의 정보보고 모달에서 등급 선택 외에 점수를 직접 입력할 수 있는 필드 추가

신규 기능

• 전체 데이터 서버 동기화: 기존에 기사 평가만 서버 저장되던 것을 6개 타입 전체로 확장
  • 기사 평가(evals), 가감점(penalties), 소명(appeals), 가중치 설정(config), Feature Flags(flags), 부서 가중치(dept_groups)
  • 서로 다른 브라우저/기기에서 동일한 데이터 공유 가능
• evaluation_api Lambda 확장: GET ?type=all로 6개 타입 한번에 조회, POST {type, data}로 타입별 저장
• 자동 병합 로직: 페이지 로드 시 서버 데이터와 로컬 데이터를 타임스탬프 기준으로 자동 병합
• 실패 재시도 큐: 네트워크 오류 시 pending 큐에 저장, 다음 접속 시 자동 재시도
• 부서 이동 이력 관리 (dept_history): 사원관리에서 부서 변경 시 이력 자동 기록
  • users.json에 dept_history 배열 자동 생성 (예: [{dept:'경제부', from:'2025-12-01'}, {dept:'금융부', from:'2026-02-11'}])
  • SCore.getDeptAtDate(user, date): 특정 날짜 기준 소속 부서 조회
  • SCore.getArticleDept(name, date, users): 기사 게재일 기준 부서 판별
  • 기자 목록, 부서 대시보드, 기사 평가에서 기사 게재일 기준 부서 분리 집계

신규 기능

• 절대평가/상대평가 전환: 기자 목록에서 절대점수(입력점수)와 상대점수(표준편차 기반 정규화, 평균 85 / 표준편차 7.5)를 동시에 표시
• 부서 가중치 (가군/나군): 가중치 설정 페이지에서 부서를 가군(1.0)/나군(1.1)으로 분류, 클릭으로 이동 가능. 최종점수 = 상대점수 × 부서가중치
• 정량평가 7대 항목 표시: 기자 목록에 조회수, 단독기사, 면톱기사, 기획기사, 서경기자상, 정보보고, 온라인기사수 칸 추가 (데이터 연동 예정)
• 정보보고 전용 등록: 가감점 관리에 파란색 '정보보고' 버튼 추가, 6단계 등급(10/8/6/4/2점) + 핵심 정보보고 가점(+2점) 전용 모달
• 가감점 버튼 순서 변경: 가점 등록 → 감점 등록 순서로 변경 (모달 토글 포함)

신규 기능

• 동적 가중치 설정 (v3 엔진): 가중치 설정 페이지에서 면 범위, 글자수 범위, 품질 가점 항목을 자유롭게 추가/삭제 가능
  • 면 가중치: 시작면~끝면 범위와 가중치를 행 단위로 추가/삭제
  • 분량 가중치: 최소~최대 글자수 범위와 가중치를 행 단위로 추가/삭제
  • 품질 가점: 항목명과 가점을 자유롭게 추가/삭제 (기존 면톱/단독/기획/S등급/A등급 외 커스텀 항목 가능)
• v2→v3 자동 마이그레이션: 기존 고정 키-값 방식(v2)에서 배열 기반(v3)으로 자동 변환
  • 기존 localStorage 설정 데이터가 자동으로 v3 포맷으로 마이그레이션
  • 마이그레이션 후에도 기존 가중치 값 유지
• Config 강제 초기화: score-config.html?reset=1 접속 시 설정 데이터 초기화 (문제 발생 시 복구용)

신규 기능

• A등급 품질 가점 추가: 기존 S등급 외에 A등급(+2점) 품질 가점 신설
  • 기사 평가 페이지에 A등급 버튼 추가 (파란색)
  • 소명 관리에서 A등급 인정 요청 가능
  • 내 점수 페이지에 A등급 배지 표시
• 가감점 관리 개편: 기존 고정 3종 감점 → 자유 입력 방식으로 전면 개편
  • 가점(+)과 감점(-) 모두 등록 가능
  • 항목명, 점수, 적용 기간을 부장이 직접 입력
  • 예시 항목 프리셋 제공 (클릭으로 자동 입력)
  • 적용 기간 선택 (1~12개월)
• 면톱(자동) 기능: XML 자동 감지 면톱 기사의 수동 해제 지원
  • is_auto_top 기사에 자동 라벨 표시
  • 자동 감지된 면톱을 부장이 수동으로 해제 가능 (면톱 버튼 토글)
  • 해제 시 기자 화면에 "톱(자동해제)" 취소선 배지 표시

신규 기능

• 부서 대시보드 월별 필터: 월 선택하여 해당 월 통계만 조회
  • 드롭다운에서 월 선택 (좌우 화살표로 이동 가능)
  • "부서 총점 (2026년 2월)" 형식으로 기간 표시
• 기자 목록 총점 기간 표시: 선택한 기간에 따라 "총점 (1월)", "총점 (01-05)" 등 표시
• 기사 평가 상태 개선: 미평가(-), 평가, 확정 3단계로 구분
  • 아무 버튼도 안 누름 → "-" (회색)
  • 면톱/단독/기획/S등급/A등급 중 하나라도 누름 → "평가" (파란색)
  • 확정 버튼 누름 → "확정" (초록색)
• 사원 추가 기능: 사원관리에서 신규 기자 추가 가능
  • 사번 6자리 입력 (중복 체크)
  • 이름, 부서, 직급, 권한, 이메일 입력
  • 초기 비밀번호: 1234
• 퇴사 처리 기능: 사원관리에서 퇴사자 삭제 가능
  • 확인 모달로 실수 방지
  • 기본 admin 계정은 삭제 불가
  • 기존 기사 데이터는 유지됨
• 동기화 자동 캐시 무효화: 동기화 버튼 클릭 시 CloudFront 캐시 자동 무효화
  • Lambda 역할에 CloudFrontFullAccess 권한 추가
  • 동기화 후 즉시 최신 데이터 반영

신규 기능

• 가감점 관리 시스템: 기자별 가점/감점 등록/관리 기능 추가
  • 시말서(부서): -2점, 1개월간 해당 월 한번만 감점
  • 시말서(반복): -5점, 동일 사안 2회 이상 반복 시, 1개월
  • 편집국장: -5점, 6개월간 매월 감점
• 가감점 관리 페이지: score-penalties.html 신규 생성
  • 가감점 목록 조회 (부서/구분/상태 필터)
  • 가감점 등록 모달 (기자 선택, 항목명/점수 직접 입력, 사유 입력)
  • 가감점 삭제 기능
  • 통계 대시보드 (감점 건수, 가점 건수, 대상 기자 수, 순 가감점)
• 내 점수 페이지 가감점 표시: score-my.html에 본인 가감점 내역 표시
• 월별 점수 계산에 가감점 반영: calculateMonthlyScore() 함수 추가

신규 기능

• 로딩 스피너 추가: 데이터 로드 시 전체 화면 로딩 오버레이 표시
• 인라인 로딩: 테이블 내 데이터 로딩 시 스피너 표시
• 버튼 로딩 상태: 저장/확정 버튼 클릭 시 로딩 상태 표시 및 중복 클릭 방지
• 공통 CSS/JS 모듈화: common.css, common.js 파일 분리

신규 기능

• 확정 기능 구현: 기사별 PENDING/CONFIRMED 상태 관리, 확정 후 수정 불가
• 소명 처리 후 점수 재계산: 소명 승인 시 자동으로 가점 반영 및 점수 재계산
• Feature Flags 기자 페이지 적용: reporter.html에 Feature Flags 완전 적용
  • SHOW_MY_SCORE: OFF 시 점수 "-"로 표시
  • SHOW_DEPT_AVERAGE: ON 시 부서 평균 카드 표시
  • SHOW_DEPT_RANKING: ON 시 부서 내 순위 표시
• 실시간 동기화 준비: Lambda API 연동 구조 추가 (SYNC_ENABLED 플래그)
• 부서 평균/순위 실제 계산: 하드코딩 제거, 실제 데이터 기반 계산

신규 기능

• S-CORE 점수 산출 시스템: 면 가중치 × 분량 가중치 × 10 + 품질 가점
• 부서 대시보드 탭 기능: 드롭다운 → 부서별 탭 버튼으로 변경
• 기사 평가 페이지: 품질 가점 체크박스 (면톱, 단독, 기획, S등급)
• 소명 관리 페이지: 기자 이의제기 접수 및 처리
• 가중치 설정 페이지: 면/분량/품질 가중치 조정, 변경 이력 관리
• 기자 내 점수 페이지: 본인 기사 목록, 점수 확인, 검토 요청