docs: record 2026-07-22 acs test log

docs/ACS작업일지.md

@@ -843,3 +843,52 @@
   - `ACS_MAIL_HOST`, `ACS_MAIL_PORT`, `ACS_MAIL_FROM`, `ACS_MAIL_USERNAME`, `ACS_MAIL_PASSWORD`, `ACS_MAIL_SMTP_AUTH`, `ACS_MAIL_STARTTLS`, `ACS_MAIL_TIMEOUT_MS` 환경변수를 서버에서 읽도록 추가.
   - 실제 메일 발송 없이 서버 컨테이너에서 SMTP host/port TCP 연결만 점검.
   - 시스템관리 화면에 `Email 점검` 탭을 추가하고 host, port, 발신자, 인증/STARTTLS 설정 여부, 계정/비밀번호 설정 여부, 연결 성공/실패, 소요시간, 오류 메시지를 표시.
+- 2026-07-22 발표자료 화면 캡처 테스트 및 ACS 운영 흐름 보정:
+  - 개발/배포 원칙 재확인:
+    - 소스 변경은 반드시 로컬에서 수정 및 테스트 완료 후 서버 배포.
+    - 서버에서만 소스 수정하는 방식은 금지.
+    - 운영 DB 데이터 정리는 필요 시 서버 DB 또는 운영 UI에서 별도 수행.
+  - 로컬/서버 버전 정렬:
+    - 서버에 반영된 변경이 로컬과 어긋난 상태를 확인하고, 로컬 저장소를 원격 최신 기준으로 맞춤.
+    - 이후 모든 변경은 로컬 수정, 로컬 검증, 커밋, push, Coolify Redeploy 순서로 진행.
+  - 운영 테스트 데이터 정리:
+    - `시스템관리 > 데이터 정리 > 출입신청 테스트 데이터 초기화` 기능으로 비정상 테스트 데이터를 정리.
+    - 출입신청, 방문자, 승인 기록, 입/퇴장 기록, 출입증 발송 기록을 삭제하고 사용자/팀/권한/목적 코드/시스템 설정/블랙리스트는 유지.
+  - 승인대기 화면 UX 보정:
+    - 승인 버튼 클릭 시 반려 버튼까지 함께 처리 중처럼 보이는 문제 수정.
+    - 행 단위 busy 상태를 `approve`/`reject` 액션별로 분리.
+    - 커밋: `ed972a3 fix: align access console status actions`.
+  - 출입콘솔 상태 및 수기 입장 기능 보정:
+    - `입장대기` 별도 표시를 제거하고 `승인완료`로 통일.
+    - 출입콘솔 금일 출입 현황 목록에서도 관리자/담당자가 승인완료 건을 직접 `입장` 처리할 수 있도록 보정.
+    - 입장/퇴장 처리 성공 메시지에 출입구역을 함께 표시하도록 보정.
+    - 커밋: `3efe493 fix: show access action zone`.
+  - 키오스크 QR 처리 보정:
+    - QR에 토큰만이 아니라 `/pass/{token}` 전체 URL이 들어오는 경우를 처리.
+    - 키오스크에서 스캔한 전체 URL에서 토큰만 추출하도록 수정.
+    - public pass API 호출 시 토큰을 URL 인코딩하도록 수정.
+    - 키오스크에서 입장 후 같은 QR을 다시 입력하면 퇴장 처리 버튼이 표시되는 흐름 확인.
+    - 커밋: `7c57960 fix: parse kiosk qr pass urls`.
+  - 대시보드 출입 상태 반영 보정:
+    - 키오스크/출입콘솔 입퇴장 후 대시보드가 최초 조회 상태에 머무르는 문제 수정.
+    - 대시보드를 3초 주기로 자동 갱신하도록 변경.
+    - 커밋: `7cbc660 fix: refresh dashboard access state`.
+  - 출입신청 목록 상태 반영 보정:
+    - 신청 자체의 상태만 표시하여 실제 입퇴장 후에도 `승인완료`로 남던 문제 수정.
+    - 오늘 출입 현황을 함께 조회하고 `재실중`/`퇴장`을 신청 상태보다 우선 표시.
+    - 3초 주기 자동 갱신 추가.
+    - 커밋: `dee612f fix: show access state in request list`.
+  - 보고서 상태 반영 보정:
+    - 보고서 화면에서도 실제 입퇴장 상태가 아닌 신청 상태만 보이던 문제 수정.
+    - 오늘 출입 현황을 함께 조회하고 `재실중`/`퇴장`을 우선 표시.
+    - 커밋: `eec18e7 fix: show access state in reports`.
+  - 검증:
+    - 각 수정마다 `npm --prefix frontend exec tsc -- --noEmit` 통과.
+    - 각 수정마다 `npm run typecheck` 통과.
+    - Vite/esbuild는 샌드박스에서 `spawn EPERM`이 발생하여 권한 밖에서 `npm run build` 재실행 후 통과.
+    - Coolify Redeploy 후 서버 화면에서 주요 흐름 재확인.
+  - 발표자료 캡처:
+    - `C:\ai-bok\20260729\AIdev2.pptm` 12~45페이지 화면 캡처 완료.
+  - 비고:
+    - 서버 URL: `https://acs.apps.bokdev.in`.
+    - 테스트 중 발견된 화면 상태 불일치는 대시보드, 출입신청 목록, 보고서 순으로 동일 원칙에 맞춰 보정.