Files
dbx-main/docs/NOTICE_MODULE.md
T
king c69bc0e9f3 feat(notice): reuse project editor, date popup and member picker on the notice page
- Notice body uses the task description editor (createDescEditor, shared toolbar partial
  project/_desc_fmtbar.html): bold/italic/underline/strike, text color/size, lists, checklist,
  quote, link, clear format, image button/paste with resize; images upload to /notice/api/images
- Show date uses the project date popup (enhanceDateInput) plus a time field
- Recipients rendered like the project member picker (icon + name + check)
- project.js exposes window.PJLib; PJ_LIB_ONLY runs only shared tooltips on non-project pages
- Centered notice renders checklist/quote/list styles outside project pages too
- Task window editor behavior unchanged (jsdom + Chrome regressions pass)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-12 14:44:33 +09:00

5.1 KiB

긴급 공지 — app/modules/notice/ (2026-10-12)

수퍼관리자가 만든 공지를 정한 시각에, 전체 또는 고른 사람의 ERP 화면 가로·세로 정가운데에 띄운다. 받는 사람이 [확인]을 누를 때까지 화면을 열 때마다 다시 뜬다(알림 팝업과 달리 닫기·Esc·바깥 클릭으로 안 닫힘).

권한

할 일 누가
공지 만들기·고치기·취소·이미지 올리기·확인 현황(/notice/) 수퍼관리자(SUPER_ADMIN_EMAIL)만 — Admin 도 안 됨
공지 받기·[확인] 로그인한 등록 사용자(모듈 권한과 무관) — 전체 공지면 모두, 아니면 고른 사람만
본문 이미지 보기(/notice/images/{id}) 수퍼관리자, 또는 그 공지를 받는 사람(띄울 시각이 지난, 취소 안 된 공지)

들어가는 곳: ERP 왼쪽 아래 긴급 공지(수퍼관리자만 보임), Project 화면 오른쪽 위 ⚙(Project 옵션) 안 긴급 공지 만들기·관리.

화면

  • 관리(/notice/) — 프로젝트 화면 부품을 그대로 쓴다(project.js 를 window.PJ_LIB_ONLY 로 불러 window.PJLib 만 — 프로젝트 알림 팝업·실시간 동기화 등은 이 화면에서 돌지 않는다): · 내용 = 작업 설명란과 같은 편집기(createDescEditor, 서식 도구 project/_desc_fmtbar.html 공용 — 굵게·기울임·밑줄·취소선· 글자 색/크기·글머리/번호 목록·체크리스트·인용·링크·서식 지우기·이미지 버튼/붙여넣기·크기 조절·더블클릭 크게 보기). @태그만 뺐다 (공지는 작업이 아니라 수신함에 쌓일 곳이 없다). 이미지는 /notice/api/images 로 올린다. · 띄울 날짜 = 프로젝트 날짜 팝업(enhanceDateInput — 일요일·공휴일 빨강·오늘·지우기), 시각은 옆 칸(5분 단위). 날짜를 비우면 바로. · 받는 사람 = 전체 / 고른 사람 — 프로젝트 멤버 고르기와 같은 아이콘 + 이름 + 체크(memberPickHtml, 등록 사용자 전원). · [미리 보기](받는 사람 화면과 같은 모양). 목록 = 상태(예약 · 표시 중 · 취소됨) · 받는 사람 · 확인 현황(확인한 사람·시각, 아직 안 한 사람). [고치기]([이미 확인한 사람에게도 다시 띄우기] 선택 가능) · [취소](더 띄우지 않음, 기록은 남음) · [취소 되돌리기].
  • 표시(static/erp-notice.js) — erp_base.html 을 쓰는 모든 화면 + 업무 모듈 첫 화면(main.html)·관리자 페이지(admin.html). 본문 서식(목록·체크리스트·인용)은 erp-notice.css 가 작업 설명란과 같게 그린다(프로젝트 밖 화면에서도). GET /notice/api/pending 을 열 때·30초마다·창을 다시 볼 때 확인(띄울 시각 정밀도 ≈30초). 여러 건이면 오래된 것부터 차례대로(1/3). document.body 에 붙여 화면 배율(.erp-app zoom)과 무관하게 정가운데. [확인] 저장이 실패하면 창을 그대로 두고 알린다. 다른 탭·다른 곳에서 확인·취소되면 다음 확인 때 닫힌다(같은 브라우저 다른 탭은 localStorage 신호로 바로). iframe(수신함 오른쪽 작업 창) 안에선 안 돈다. 024 미적용(503)·로그아웃(401)이면 조용히 멈춘다.

저장 — project_db 마이그레이션 024 (scripts/sql/project_db_024_urgent_notices.sql)

표 용도
urgent_notices 제목·본문 HTML(서버 정리)·show_at·to_all·만든/고친 사람·cancelled_at
urgent_notice_targets 받는 사람(to_all = FALSE 일 때)
urgent_notice_acks [확인] 기록(한 사람 한 번, 시각)
urgent_notice_images 본문 이미지(bytea, png·jpeg·gif·webp 10MB 이하 — 파일 앞 바이트로 형식 판단, svg·html 거절)
  • 연결 풀은 프로젝트 저장소(PROJECT_DB_URL)와 같이 쓴다(ProjectStore.pool). 새 환경변수 없음.
  • 본문은 작업 설명란과 같은 허용 목록으로 정리한 뒤 이미지는 /notice/images/{id} 만 남긴다(외부 주소·data: 이미지 제거).
  • 이미지는 올릴 때 공지 없이(notice_id NULL) 저장 → 공지 저장 때 본문에 든 내가 올린 이미지만 그 공지에 묶는다. 하루 넘게 안 묶인 이미지는 다음 저장 때 지운다.
  • 이미지 응답: nosniff · sandbox CSP · Cache-Control: private.

PC 알림 프로그램

아직 긴급 공지를 띄우지 않는다(웹만). 붙이려면 desktop/notifier 에 공지 창(가운데)·[확인] 호출을 추가하고 exe 를 다시 빌드해야 한다.

테스트

  • tests/test_notice.py — 본문 정리·이미지 형식·시각(한국시간)·받는 사람 검증, API 권한(수퍼관리자만 관리·받는 사람만 확인/이미지·503). DB 없음.
  • tests/test_notice_db.py — 실제 PostgreSQL(로컬 테스트 DB): 예약 시각·고른 사람·확인 한 번·취소/되돌리기·고치기·다시 띄우기·남의 이미지 안 묶임.
  • tests/js/notice_ui.test.js — jsdom: 가운데 창·차례대로·Esc/바깥 클릭 무시·확인 실패 유지·다른 곳 확인 반영·503 멈춤.