diff --git a/CLAUDE.md b/CLAUDE.md
index df2762a..a267364 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -40,6 +40,8 @@ Claude Code는 이 저장소에서 작업을 시작하기 전에 **반드시 아
- 실적 (`app/modules/performance/`, `performance_db`) — 쇼핑몰 통합 매출. 네 영역 분리: ① 수집 `adapters/`(쇼핑몰 하나 = 어댑터 파일 하나 + `registry.py` 한 줄 + SQL seed 한 줄) + `sync.py`(공통 동기화, 같은 쇼핑몰 동시 실행 차단, 쇼핑몰별 실패 격리) ② 보안 `security/`(AES-256-GCM, 키 버전, 비밀값 가리기) + `credentials.py` ③ 계산 `calc.py`(주=월~일, 수수료 반올림은 `commission()` 한 곳, 요율 이력) + `db.py` ④ 화면 `dashboard.py`/`router.py`/템플릿. 쇼핑몰 API 인증정보는 `.env` 가 아니라 **설정 화면에서 입력 → 마스터 키 `APP_ENCRYPTION_KEY` 로 암호화해 DB 저장**, secret 원문은 화면으로 다시 보내지 않는다. 쇼핑몰 API 는 백엔드에서만 호출, 오류·로그·raw 는 `redact` 후 저장. 매출 기준일: 결제=결제일, 취소·반품=발생일(`sync.sales_date_for`). 금액은 원 단위 정수. 권한키 `performance`, 설정 화면은 모듈 권한자 누구나(일반 사용자는 수수료율만), 수수료 외 설정 API 는 `is_admin`. 매출 업데이트 진행 창에서 쇼핑몰별 [중지](그 쇼핑몰만 멈추고 다음 쇼핑몰로). 카페24 어댑터는 기존 `app/integrations/cafe24` 토큰 재사용. 1단계는 모의 데이터(`is_sample`)·구조까지, 실제 수집은 쇼핑몰별로 공식 문서 확인 후 순차 구현. 상세는 `docs/PERFORMANCE_MODULE.md`
+- 긴급 공지 (`app/modules/notice/`, `project_db` 마이그레이션 024 `urgent_notice*`) — 수퍼관리자만 작성(`/notice/`, ERP 왼쪽 아래·Project ⚙ 옵션). 제목·내용(이미지 bytea)·띄울 시각·전체/고른 사람 → ERP 모든 화면(`erp_base.html`·`main.html`·`admin.html` 의 `static/erp-notice.js`) 가로·세로 정가운데에 [확인] 누를 때까지(Esc·바깥 클릭 무시), 확인 기록. 연결 풀은 `ProjectStore.pool` 공유, 새 환경변수 없음. PC 알림 프로그램은 아직 미지원. 상세는 `docs/NOTICE_MODULE.md`
+
상세는 `docs/PROJECT_OVERVIEW.md`.
---
diff --git a/app/main.py b/app/main.py
index b2c14e3..2c1c310 100644
--- a/app/main.py
+++ b/app/main.py
@@ -26,6 +26,8 @@ from .modules.expense import CategoryStore, build_expense_store
from .modules.expense import router as expense_router
from .modules.malaysia import build_malaysia_itemcode, build_malaysia_store
from .modules.malaysia import router as malaysia_router
+from .modules.notice import build_notice_store
+from .modules.notice import router as notice_router
from .modules.performance import build_performance_store
from .modules.performance import router as performance_router
from .modules.project import build_project_store
@@ -146,6 +148,7 @@ _MODULE_TEMPLATE_DIRS = [
BASE_DIR / "modules" / "cafe24" / "templates",
BASE_DIR / "modules" / "performance" / "templates",
BASE_DIR / "modules" / "asset" / "templates",
+ BASE_DIR / "modules" / "notice" / "templates",
]
templates = Jinja2Templates(directory=str(BASE_DIR / "templates"))
templates.env.loader = ChoiceLoader(
@@ -209,6 +212,8 @@ app.state.cafe24_store = build_cafe24_store(dsn=env("CAFE24_DB_URL") or None)
# 쇼핑몰 API 인증정보는 설정 화면에서 입력 → APP_ENCRYPTION_KEY 로 암호화해 performance_db 에 저장.
app.state.performance_store = build_performance_store(dsn=env("PERFORMANCE_DB_URL") or None)
app.state.asset_store = build_asset_store(dsn=env("ASSET_DB_URL") or None)
+# 긴급 공지(ERP 전체 화면 가운데): project_db 024 — 프로젝트 저장소의 연결 풀을 같이 쓴다(없으면 None → 503).
+app.state.notice_store = build_notice_store(app.state.project_store)
# 모듈 라우터 등록 — 신규 모듈 추가 시 여기 한 줄.
app.include_router(expense_router)
@@ -220,6 +225,7 @@ app.include_router(project_router)
app.include_router(cafe24_router)
app.include_router(performance_router)
app.include_router(asset_router)
+app.include_router(notice_router)
def public_url_for(request: Request, route_name: str) -> str:
diff --git a/app/modules/notice/__init__.py b/app/modules/notice/__init__.py
new file mode 100644
index 0000000..19c3a61
--- /dev/null
+++ b/app/modules/notice/__init__.py
@@ -0,0 +1,23 @@
+"""긴급 공지 — ERP 전체 화면 가운데에 띄우는 공지(2026-10-12).
+
+- 라우터: `router.py` (prefix=/notice) — 만들기·고치기는 수퍼관리자만, 받기·[확인]은 로그인 사용자 누구나
+- 저장소: `db.py` (project_db 마이그레이션 024 의 urgent_notice* 표 — 프로젝트 저장소의 연결 풀을 같이 쓴다)
+- 검증: `store.py`
+- 화면: 관리 `templates/notice/admin.html` + `static/erp-notice-admin.js`, 표시 `static/erp-notice.js`(erp_base.html 공용)
+상세는 docs/NOTICE_MODULE.md.
+"""
+
+from typing import Any
+
+from .router import router
+
+__all__ = ["router", "build_notice_store"]
+
+
+def build_notice_store(project_store: Any) -> Any:
+ """프로젝트 저장소(PROJECT_DB_URL)가 있으면 그 연결 풀로 NoticeStore, 없으면 None(공지 API 는 503)."""
+ if project_store is None:
+ return None
+ from .db import NoticeStore # noqa: WPS433
+
+ return NoticeStore(project_store.pool)
diff --git a/app/modules/notice/db.py b/app/modules/notice/db.py
new file mode 100644
index 0000000..77b62c7
--- /dev/null
+++ b/app/modules/notice/db.py
@@ -0,0 +1,208 @@
+"""긴급 공지 저장소 — project_db(마이그레이션 024)의 urgent_notice* 표. 연결 풀은 프로젝트 저장소와 같이 쓴다."""
+
+from __future__ import annotations
+
+from datetime import datetime
+from typing import Any
+
+from psycopg import errors as psycopg_errors
+
+from app.modules.project import store as pj_store
+from app.timezone import KST
+
+from . import store
+
+
+def _iso(v: Any) -> str:
+ return v.astimezone(KST).isoformat(timespec="minutes") if isinstance(v, datetime) else ""
+
+
+class NoticeStore:
+ def __init__(self, pool: Any) -> None:
+ self._pool = pool
+
+ def _conn(self) -> Any:
+ return self._pool.connection()
+
+ @staticmethod
+ def _run(fn: Any) -> Any:
+ try:
+ return fn()
+ except psycopg_errors.UndefinedTable:
+ raise store.NoticeMigrationNeeded()
+
+ # ── 읽기 ────────────────────────────────────────────────
+ @staticmethod
+ def _row(r: dict[str, Any]) -> dict[str, Any]:
+ return {
+ "id": int(r["id"]), "title": r["title"], "body_html": r["body_html"],
+ "show_at": _iso(r["show_at"]), "to_all": bool(r["to_all"]),
+ "created_by": r["created_by"], "created_at": _iso(r["created_at"]),
+ "updated_by": r.get("updated_by") or "", "updated_at": _iso(r.get("updated_at")),
+ "cancelled_at": _iso(r.get("cancelled_at")), "cancelled_by": r.get("cancelled_by") or "",
+ }
+
+ def list_notices(self, *, limit: int = 200) -> list[dict[str, Any]]:
+ """관리 화면 — 최근 것부터. 받는 사람·확인한 사람 목록을 함께."""
+ def run() -> list[dict[str, Any]]:
+ with self._conn() as conn:
+ rows = conn.execute("SELECT * FROM urgent_notices ORDER BY show_at DESC, id DESC LIMIT %s",
+ (int(limit),)).fetchall()
+ ids = [int(r["id"]) for r in rows]
+ targets: dict[int, list[str]] = {i: [] for i in ids}
+ acks: dict[int, dict[str, str]] = {i: {} for i in ids}
+ if ids:
+ for t in conn.execute("SELECT notice_id, user_email FROM urgent_notice_targets "
+ "WHERE notice_id = ANY(%s) ORDER BY user_email", (ids,)).fetchall():
+ targets[int(t["notice_id"])].append(t["user_email"])
+ for a in conn.execute("SELECT notice_id, user_email, acked_at FROM urgent_notice_acks "
+ "WHERE notice_id = ANY(%s) ORDER BY acked_at", (ids,)).fetchall():
+ acks[int(a["notice_id"])][a["user_email"]] = _iso(a["acked_at"])
+ return [{**self._row(r), "targets": targets[int(r["id"])], "acks": acks[int(r["id"])]} for r in rows]
+ return self._run(run)
+
+ def pending_for(self, *, email: str, now: datetime | None = None) -> list[dict[str, Any]]:
+ """이 사람이 지금 봐야 할 공지 — 취소 안 됨·띄울 시각이 지남·받는 사람(전체 또는 지정)·아직 [확인] 안 함. 오래된 것부터."""
+ em = pj_store.norm_str(email, lower=True)
+
+ def run() -> list[dict[str, Any]]:
+ with self._conn() as conn:
+ rows = conn.execute(
+ "SELECT n.* FROM urgent_notices n "
+ "WHERE n.cancelled_at IS NULL AND n.show_at <= %s "
+ " AND (n.to_all OR EXISTS (SELECT 1 FROM urgent_notice_targets t "
+ " WHERE t.notice_id = n.id AND t.user_email = %s)) "
+ " AND NOT EXISTS (SELECT 1 FROM urgent_notice_acks a WHERE a.notice_id = n.id AND a.user_email = %s) "
+ "ORDER BY n.show_at ASC, n.id ASC LIMIT 20",
+ (now or datetime.now(KST), em, em),
+ ).fetchall()
+ return [self._row(r) for r in rows]
+ return self._run(run)
+
+ def get_notice(self, *, notice_id: int) -> dict[str, Any] | None:
+ def run() -> dict[str, Any] | None:
+ with self._conn() as conn:
+ r = conn.execute("SELECT * FROM urgent_notices WHERE id = %s", (notice_id,)).fetchone()
+ if r is None:
+ return None
+ t = [x["user_email"] for x in conn.execute(
+ "SELECT user_email FROM urgent_notice_targets WHERE notice_id = %s ORDER BY user_email",
+ (notice_id,)).fetchall()]
+ return {**self._row(r), "targets": t}
+ return self._run(run)
+
+ def is_recipient(self, *, notice: dict[str, Any], email: str) -> bool:
+ em = pj_store.norm_str(email, lower=True)
+ return bool(notice["to_all"]) or em in notice.get("targets", [])
+
+ # ── 쓰기 ────────────────────────────────────────────────
+ def _link_images(self, conn: Any, notice_id: int, body: str, by: str) -> None:
+ """본문에 든 이미지를 이 공지에 묶는다 — 내가 올린, 아직 어느 공지에도 안 묶인 이미지만(남의 공지 이미지 가로채기 방지)."""
+ ids = store.image_ids_in(body)
+ if ids:
+ conn.execute("UPDATE urgent_notice_images SET notice_id = %s "
+ "WHERE id = ANY(%s) AND notice_id IS NULL AND uploaded_by = %s", (notice_id, ids, by))
+ # 하루 넘게 어느 공지에도 안 묶인 이미지(올렸다가 저장 안 함)는 정리
+ conn.execute("DELETE FROM urgent_notice_images WHERE notice_id IS NULL AND created_at < now() - interval '1 day'")
+
+ def create_notice(self, *, title: Any, body: Any, show_at: Any, to_all: Any, targets: Any, by: str) -> dict[str, Any]:
+ ttl = store.validate_title(title)
+ html = store.sanitize_body(body)
+ when = store.parse_show_at(show_at)
+ all_, emails = store.validate_targets(to_all, targets)
+ who = pj_store.norm_str(by, lower=True)
+
+ def run() -> int:
+ with self._conn() as conn:
+ with conn.transaction():
+ nid = int(conn.execute(
+ "INSERT INTO urgent_notices (title, body_html, show_at, to_all, created_by, updated_by) "
+ "VALUES (%s,%s,%s,%s,%s,%s) RETURNING id", (ttl, html, when, all_, who, who),
+ ).fetchone()["id"])
+ for em in emails:
+ conn.execute("INSERT INTO urgent_notice_targets (notice_id, user_email) VALUES (%s,%s) "
+ "ON CONFLICT DO NOTHING", (nid, em))
+ self._link_images(conn, nid, html, who)
+ return nid
+ return self.get_notice(notice_id=self._run(run)) # type: ignore[return-value]
+
+ def update_notice(self, *, notice_id: int, title: Any, body: Any, show_at: Any, to_all: Any, targets: Any,
+ by: str, reshow: bool = False) -> dict[str, Any]:
+ """고치기 — 받는 사람·시각·내용 전부. reshow=True 면 이미 [확인]한 사람에게도 다시 띄운다(확인 기록 지움)."""
+ ttl = store.validate_title(title)
+ html = store.sanitize_body(body)
+ when = store.parse_show_at(show_at)
+ all_, emails = store.validate_targets(to_all, targets)
+ who = pj_store.norm_str(by, lower=True)
+
+ def run() -> None:
+ with self._conn() as conn:
+ with conn.transaction():
+ row = conn.execute("UPDATE urgent_notices SET title=%s, body_html=%s, show_at=%s, to_all=%s, "
+ "updated_by=%s, updated_at=now() WHERE id=%s RETURNING id",
+ (ttl, html, when, all_, who, notice_id)).fetchone()
+ if row is None:
+ raise KeyError(notice_id)
+ conn.execute("DELETE FROM urgent_notice_targets WHERE notice_id = %s", (notice_id,))
+ for em in emails:
+ conn.execute("INSERT INTO urgent_notice_targets (notice_id, user_email) VALUES (%s,%s) "
+ "ON CONFLICT DO NOTHING", (notice_id, em))
+ if reshow:
+ conn.execute("DELETE FROM urgent_notice_acks WHERE notice_id = %s", (notice_id,))
+ self._link_images(conn, notice_id, html, who)
+ self._run(run)
+ return self.get_notice(notice_id=notice_id) # type: ignore[return-value]
+
+ def cancel_notice(self, *, notice_id: int, by: str, cancel: bool = True) -> dict[str, Any]:
+ """취소(더 띄우지 않음) · 취소 되돌리기. 기록은 남는다."""
+ def run() -> None:
+ with self._conn() as conn:
+ row = conn.execute(
+ "UPDATE urgent_notices SET cancelled_at = CASE WHEN %s THEN now() ELSE NULL END, "
+ "cancelled_by = CASE WHEN %s THEN %s ELSE '' END, updated_at = now() WHERE id = %s RETURNING id",
+ (cancel, cancel, pj_store.norm_str(by, lower=True), notice_id),
+ ).fetchone()
+ if row is None:
+ raise KeyError(notice_id)
+ self._run(run)
+ return self.get_notice(notice_id=notice_id) # type: ignore[return-value]
+
+ def ack(self, *, notice_id: int, email: str) -> bool:
+ """[확인] — 처음이면 True(이미 확인했으면 False). 받는 사람·표시 시각 확인은 라우터가 먼저 한다."""
+ def run() -> bool:
+ with self._conn() as conn:
+ r = conn.execute("INSERT INTO urgent_notice_acks (notice_id, user_email) VALUES (%s,%s) "
+ "ON CONFLICT DO NOTHING RETURNING notice_id",
+ (notice_id, pj_store.norm_str(email, lower=True))).fetchone()
+ return r is not None
+ return self._run(run)
+
+ # ── 이미지 ──────────────────────────────────────────────
+ def add_image(self, *, data: bytes, filename: str, by: str) -> dict[str, Any]:
+ ctype = store.sniff_image(data)
+
+ def run() -> int:
+ with self._conn() as conn:
+ return int(conn.execute(
+ "INSERT INTO urgent_notice_images (filename, content_type, size_bytes, data, uploaded_by) "
+ "VALUES (%s,%s,%s,%s,%s) RETURNING id",
+ (pj_store.norm_str(filename)[:200], ctype, len(data), data, pj_store.norm_str(by, lower=True)),
+ ).fetchone()["id"])
+ iid = self._run(run)
+ return {"id": iid, "url": f"/notice/images/{iid}", "content_type": ctype}
+
+ def get_image(self, *, image_id: int) -> dict[str, Any] | None:
+ def run() -> dict[str, Any] | None:
+ with self._conn() as conn:
+ r = conn.execute("SELECT id, notice_id, content_type, data, uploaded_by FROM urgent_notice_images "
+ "WHERE id = %s", (image_id,)).fetchone()
+ return dict(r) if r else None
+ return self._run(run)
+
+ def enabled(self) -> bool:
+ try:
+ with self._conn() as conn:
+ return bool(conn.execute("SELECT to_regclass('public.urgent_notices') AS r").fetchone()["r"])
+ except Exception: # noqa: BLE001
+ return False
+
diff --git a/app/modules/notice/router.py b/app/modules/notice/router.py
new file mode 100644
index 0000000..86f3058
--- /dev/null
+++ b/app/modules/notice/router.py
@@ -0,0 +1,183 @@
+"""긴급 공지 라우터(/notice) — ERP 전체 화면 가운데 공지.
+
+- 만들기·고치기·취소·이미지 올리기·확인 현황: 수퍼관리자(app.store.SUPER_ADMIN_EMAIL)만.
+- 받기(GET /notice/api/pending)·[확인]: 로그인한 등록 사용자 누구나 — 모듈 권한과 무관(ERP 전체 공지).
+- 저장: project_db 024(urgent_notice*). PROJECT_DB_URL 이 없거나 024 미적용이면 503(화면 스크립트는 조용히 멈춘다).
+- 핸들러는 동기 DB 라 def(프로젝트 라우터와 같은 이유).
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+from fastapi import APIRouter, Body, File, HTTPException, Request, UploadFile
+from fastapi.responses import HTMLResponse, JSONResponse, Response
+
+from . import store
+
+router = APIRouter(prefix="/notice", tags=["notice"])
+
+_MIGRATION_MSG = "긴급 공지 기능이 아직 준비되지 않았습니다(project_db 마이그레이션 024 필요)."
+
+
+def _user(request: Request) -> dict[str, Any]:
+ from app.main import get_current_user_record # noqa: WPS433
+
+ user = get_current_user_record(request)
+ if user is None:
+ raise HTTPException(status_code=401, detail="로그인이 필요합니다.")
+ return user
+
+
+def _is_super(user: dict[str, Any]) -> bool:
+ from app.store import SUPER_ADMIN_EMAIL # noqa: WPS433
+
+ return str(user.get("email") or "").strip().lower() == SUPER_ADMIN_EMAIL
+
+
+def _super(request: Request) -> dict[str, Any]:
+ user = _user(request)
+ if not _is_super(user):
+ raise HTTPException(status_code=403, detail="긴급 공지는 수퍼관리자만 만들 수 있습니다.")
+ return user
+
+
+def _store(request: Request) -> Any:
+ st = getattr(request.app.state, "notice_store", None)
+ if st is None:
+ raise HTTPException(status_code=503, detail=_MIGRATION_MSG)
+ return st
+
+
+def _call(fn: Any, **kw: Any) -> Any:
+ try:
+ return fn(**kw)
+ except store.NoticeMigrationNeeded:
+ raise HTTPException(status_code=503, detail=_MIGRATION_MSG)
+ except ValueError as exc:
+ raise HTTPException(status_code=400, detail=str(exc))
+ except KeyError:
+ raise HTTPException(status_code=404, detail="공지를 찾을 수 없습니다.")
+
+
+def _public(n: dict[str, Any]) -> dict[str, Any]:
+ """받는 사람 화면에 보내는 값 — 받는 사람 목록·확인 현황은 빼고."""
+ return {k: n[k] for k in ("id", "title", "body_html", "show_at", "created_by")}
+
+
+# ── 화면 ─────────────────────────────────────────────────────
+@router.get("/", response_class=HTMLResponse)
+def notice_admin_page(request: Request) -> HTMLResponse:
+ """긴급 공지 관리 — 수퍼관리자만. 목록(예약·표시 중·취소)·확인 현황·새 공지."""
+ from app.main import build_erp_nav, render_template, user_store # noqa: WPS433
+ from app.store import is_admin # noqa: WPS433
+
+ user = _super(request)
+ st = getattr(request.app.state, "notice_store", None)
+ enabled = bool(st) and st.enabled()
+ people = sorted(
+ ({"email": u["email"], "name": u.get("name") or u["email"].split("@")[0]} for u in user_store.list_all()),
+ key=lambda p: p["email"],
+ )
+ return render_template(request, "notice/admin.html", {
+ "user": user, "is_admin": is_admin(user),
+ "nav_items": build_erp_nav(user, active=""),
+ "page_title": "긴급 공지", "page_subtitle": "정한 시각에 받는 사람 화면 가운데에 띄웁니다([확인] 전까지)",
+ "enabled": enabled, "people": people,
+ })
+
+
+# ── 받는 사람 ────────────────────────────────────────────────
+@router.get("/api/pending")
+def api_pending(request: Request) -> JSONResponse:
+ """지금 내가 봐야 할 공지(띄울 시각이 지났고 아직 [확인] 안 한 것, 오래된 것부터)."""
+ user = _user(request)
+ st = _store(request)
+ rows = _call(st.pending_for, email=user["email"])
+ return JSONResponse({"notices": [_public(n) for n in rows]})
+
+
+@router.post("/api/{notice_id}/ack")
+def api_ack(request: Request, notice_id: int) -> JSONResponse:
+ """[확인] — 받는 사람이고 이미 띄워진(취소 안 된) 공지만. 여러 번 눌러도 한 번 기록."""
+ user = _user(request)
+ st = _store(request)
+ n = _call(st.get_notice, notice_id=notice_id)
+ if n is None or not st.is_recipient(notice=n, email=user["email"]):
+ raise HTTPException(status_code=404, detail="공지를 찾을 수 없습니다.")
+ _call(st.ack, notice_id=notice_id, email=user["email"])
+ return JSONResponse({"ok": True})
+
+
+@router.get("/images/{image_id}")
+def notice_image(request: Request, image_id: int) -> Response:
+ """공지 본문 이미지 — 수퍼관리자, 또는 그 공지를 받는 사람(띄울 시각이 지난 공지)만."""
+ from datetime import datetime # noqa: WPS433
+
+ from app.timezone import KST # noqa: WPS433
+
+ user = _user(request)
+ st = _store(request)
+ img = _call(st.get_image, image_id=image_id)
+ if img is None:
+ raise HTTPException(status_code=404, detail="이미지를 찾을 수 없습니다.")
+ if not _is_super(user):
+ n = _call(st.get_notice, notice_id=int(img["notice_id"])) if img["notice_id"] else None
+ if (n is None or n["cancelled_at"] or not st.is_recipient(notice=n, email=user["email"])
+ or datetime.fromisoformat(n["show_at"]) > datetime.now(KST)):
+ raise HTTPException(status_code=404, detail="이미지를 찾을 수 없습니다.")
+ return Response(content=bytes(img["data"]), media_type=img["content_type"], headers={
+ "X-Content-Type-Options": "nosniff", "Cache-Control": "private, max-age=3600",
+ "Content-Security-Policy": "default-src 'none'; img-src 'self'; sandbox",
+ })
+
+
+# ── 수퍼관리자 ───────────────────────────────────────────────
+@router.get("/api/notices")
+def api_list(request: Request) -> JSONResponse:
+ _super(request)
+ st = _store(request)
+ return JSONResponse({"notices": _call(st.list_notices)})
+
+
+def _fields(payload: dict[str, Any]) -> dict[str, Any]:
+ return {"title": payload.get("title"), "body": payload.get("body_html") or "",
+ "show_at": payload.get("show_at"), "to_all": payload.get("to_all", True),
+ "targets": payload.get("targets") or []}
+
+
+@router.post("/api/notices")
+def api_create(request: Request, payload: dict[str, Any] = Body(...)) -> JSONResponse:
+ user = _super(request)
+ st = _store(request)
+ n = _call(st.create_notice, **_fields(payload), by=user["email"])
+ return JSONResponse({"notice": n}, status_code=201)
+
+
+@router.put("/api/notices/{notice_id}")
+def api_update(request: Request, notice_id: int, payload: dict[str, Any] = Body(...)) -> JSONResponse:
+ """고치기 — reshow=true 면 이미 [확인]한 사람에게도 다시 띄운다."""
+ user = _super(request)
+ st = _store(request)
+ n = _call(st.update_notice, notice_id=notice_id, **_fields(payload), by=user["email"],
+ reshow=payload.get("reshow") is True)
+ return JSONResponse({"notice": n})
+
+
+@router.post("/api/notices/{notice_id}/cancel")
+def api_cancel(request: Request, notice_id: int, payload: dict[str, Any] = Body(default={})) -> JSONResponse:
+ """취소(더 띄우지 않음) {cancel: true} · 되돌리기 {cancel: false}."""
+ user = _super(request)
+ st = _store(request)
+ n = _call(st.cancel_notice, notice_id=notice_id, by=user["email"], cancel=payload.get("cancel", True) is not False)
+ return JSONResponse({"notice": n})
+
+
+@router.post("/api/images")
+def api_upload_image(request: Request, file: UploadFile = File(...)) -> JSONResponse:
+ """본문 이미지 올리기 — 저장(공지 만들기·고치기) 때 본문에 든 것만 그 공지에 묶인다."""
+ user = _super(request)
+ st = _store(request)
+ data = file.file.read(store.IMAGE_MAX_BYTES + 1)
+ img = _call(st.add_image, data=data, filename=file.filename or "image", by=user["email"])
+ return JSONResponse({"image": img}, status_code=201)
diff --git a/app/modules/notice/store.py b/app/modules/notice/store.py
new file mode 100644
index 0000000..7e8a8e0
--- /dev/null
+++ b/app/modules/notice/store.py
@@ -0,0 +1,106 @@
+"""긴급 공지 — 순수 검증(DB 없음). 저장은 db.py, 화면·권한은 router.py."""
+
+from __future__ import annotations
+
+import re
+from datetime import datetime
+from typing import Any
+
+from app.modules.project import store as pj_store
+from app.timezone import KST
+
+TITLE_MAX = 200
+BODY_MAX = 100_000 # 정리한 HTML 기준(이미지는 주소만 들어간다)
+IMAGE_MAX_BYTES = 10 * 1024 * 1024
+TARGETS_MAX = 500
+
+# 이미지 형식은 올린 쪽이 정한 Content-Type 이 아니라 파일 앞 바이트로 정한다(svg·html 은 받지 않는다).
+_MAGIC: tuple[tuple[bytes, str], ...] = (
+ (b"\x89PNG\r\n\x1a\n", "image/png"),
+ (b"\xff\xd8\xff", "image/jpeg"),
+ (b"GIF87a", "image/gif"),
+ (b"GIF89a", "image/gif"),
+)
+_IMG_SRC_OK = re.compile(r"^/notice/images/(\d+)$")
+_IMG_TAG = re.compile(r"]*>", re.IGNORECASE)
+_SRC_ATTR = re.compile(r"""\bsrc\s*=\s*"([^"]*)\"""", re.IGNORECASE)
+
+
+class NoticeMigrationNeeded(Exception):
+ """project_db 024 미적용."""
+
+
+def validate_title(v: Any) -> str:
+ t = pj_store.norm_str(v)
+ if not t:
+ raise ValueError("공지 제목을 입력하세요.")
+ if len(t) > TITLE_MAX:
+ raise ValueError(f"제목은 {TITLE_MAX}자 이하로 입력하세요.")
+ return t
+
+
+def sanitize_body(html: Any) -> str:
+ """작업 설명란과 같은 허용 목록으로 정리한 뒤, 이미지는 공지 이미지 주소(/notice/images/{id})만 남긴다
+ (외부 주소·data: 이미지는 뺀다 — 받는 사람 화면에서 다른 곳으로 요청이 나가지 않게)."""
+ out = pj_store.sanitize_description_html(str(html or ""))
+
+ def keep(m: re.Match[str]) -> str:
+ src = _SRC_ATTR.search(m.group(0))
+ return m.group(0) if src and _IMG_SRC_OK.match(src.group(1)) else ""
+ out = _IMG_TAG.sub(keep, out)
+ if len(out) > BODY_MAX:
+ raise ValueError("내용이 너무 깁니다.")
+ return out
+
+
+def image_ids_in(html: str) -> list[int]:
+ """본문에 들어 있는 공지 이미지 id(순서대로, 중복 없이)."""
+ ids: list[int] = []
+ for tag in _IMG_TAG.findall(html or ""):
+ src = _SRC_ATTR.search(tag)
+ m = _IMG_SRC_OK.match(src.group(1)) if src else None
+ if m and int(m.group(1)) not in ids:
+ ids.append(int(m.group(1)))
+ return ids
+
+
+def parse_show_at(v: Any, *, now: datetime | None = None) -> datetime:
+ """띄울 시각 — 'YYYY-MM-DDTHH:MM'(화면 입력, 한국시간) 또는 시간대가 붙은 ISO. 비우면 지금."""
+ s = pj_store.norm_str(v)
+ if not s:
+ return now or datetime.now(KST)
+ try:
+ d = datetime.fromisoformat(s.replace("Z", "+00:00"))
+ except ValueError:
+ raise ValueError("띄울 시각이 올바르지 않습니다.")
+ if d.tzinfo is None:
+ d = d.replace(tzinfo=KST)
+ if not 2000 <= d.year <= 2100:
+ raise ValueError("띄울 시각이 올바르지 않습니다.")
+ return d
+
+
+def validate_targets(to_all: Any, targets: Any) -> tuple[bool, list[str]]:
+ """(전체 여부, 받는 사람 이메일). 전체가 아니면 한 명 이상."""
+ if to_all is True or to_all in ("1", "true", "on"):
+ return True, []
+ emails = pj_store.normalize_emails(targets if isinstance(targets, (list, tuple)) else [])
+ if not emails:
+ raise ValueError("받는 사람을 한 명 이상 고르거나 '전체'를 고르세요.")
+ if len(emails) > TARGETS_MAX:
+ raise ValueError(f"받는 사람은 {TARGETS_MAX}명까지 고를 수 있습니다.")
+ return False, emails
+
+
+def sniff_image(data: bytes) -> str:
+ """파일 앞 바이트로 이미지 형식 — png·jpeg·gif·webp 만. 아니면 ValueError."""
+ if not data:
+ raise ValueError("빈 파일입니다.")
+ if len(data) > IMAGE_MAX_BYTES:
+ raise ValueError("이미지는 10MB 이하만 올릴 수 있습니다.")
+ for magic, ctype in _MAGIC:
+ if data.startswith(magic):
+ return ctype
+ if len(data) >= 12 and data[:4] == b"RIFF" and data[8:12] == b"WEBP":
+ return "image/webp"
+ raise ValueError("이미지(png·jpg·gif·webp)만 올릴 수 있습니다.")
diff --git a/app/modules/notice/templates/notice/admin.html b/app/modules/notice/templates/notice/admin.html
new file mode 100644
index 0000000..9f649cc
--- /dev/null
+++ b/app/modules/notice/templates/notice/admin.html
@@ -0,0 +1,63 @@
+{% extends "erp_base.html" %}
+
+{% block head_extra %}
+
+{% endblock %}
+
+{% block content %}
+{% if not enabled %}
+
project_db 마이그레이션 024(scripts/sql/project_db_024_urgent_notices.sql)를 적용하면 사용할 수 있습니다.
이 브라우저의 모든 Project 화면에 적용됩니다.
+ {% if user and user.is_super_admin %}{% endif %}