ca9beab729
보안 - 첨부 /inline: 업로드한 쪽이 정한 content-type 을 그대로 띄워 HTML/SVG 첨부로 저장형 XSS 가능 → 안전한 이미지 형식만 인라인, 나머지는 다운로드. nosniff + CSP sandbox 헤더 추가. - 설명란 sanitizer: URL 금지 목록이 "jav	ascript:" 로 우회됨 → 허용 목록(http/https/mailto/tel/상대경로, img 는 data: 이미지)으로 변경. 권한 - 업무 생성 시 parent_task_id 로 권한 없는 프로젝트에 하위 업무 생성 가능 → 거부. - 세션 수정/순서/삭제 API 가 세션이 URL 프로젝트 소속인지 안 봄 → 404. - 업무 생성·수정·연결 시 세션이 해당 프로젝트 것인지 검증. - 멤버/세션/업무/활동 조회 API 와 프로젝트 화면을 멤버·owner·admin 만. users/tasks 전체 조회는 볼 수 있는 프로젝트 업무만. 데이터 - 연결(멀티호밍) 업무를 연결된 프로젝트에서 열어 저장하면 세션 선택이 비어 stage_id=null 이 전송돼 원래 세션·완료 상태가 지워짐 → home_stage_id 사용, 빈 세션은 보내지 않음. - mergeTask 가 같은 id 의 첫 행만 고쳐 연결 업무 카드가 중복/사라짐 → 모든 맥락 행을 고치되 맥락별 세션 필드는 보존. 새 업무가 다음 동기화까지 안 보이던 문제도 수정. - 삭제·세션 이름변경·첨부 추가가 실시간 반영 안 됨 → 트리거 카운터 (마이그레이션 007, 미적용 시 MAX 폴백). 화면 열자마자 기준값을 잡아 첫 8초 사이 변경 누락도 해결. 동기화 시 이 프로젝트 행을 통째로 교체. - 사이드바 "내 업무" 개수가 화면마다 다르던 것 → count_my_open 하나로 통일. - 업무/프로젝트/댓글 삭제 시 디스크 첨부 파일 정리. 성능 - 라우터 핸들러 async def → def (동기 psycopg 가 이벤트 루프를 막음). - 프로젝트 화면 N+1 → 업무·세션 각각 쿼리 1회. - live-version 풀스캔 → PK 한 줄 조회. 탭 숨김 시 폴링 중지. - 동기화 API 3개 → /snapshot 1개, 배지 숫자는 /my-tasks/open-count. - 순서 변경 UPDATE N번 → unnest 1번. 첨부는 한도+1 바이트만 읽음. 기타 - 마이그레이션 003 번호 중복 → project_db_003b_task_times.sql. - CLAUDE.md 의 옛 권한 설명 정정, PROJECT_MODULE.md 갱신. 캐시 버전 20260923b. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
456 lines
19 KiB
Python
456 lines
19 KiB
Python
"""프로젝트 관리 모듈 — 상수 / 기본값 / 순수 검증 로직.
|
|
|
|
DB I/O 는 db.py(ProjectStore)가 담당하고, 여기서는 상수와 입력 검증 등
|
|
DB 없이 단위 테스트 가능한 순수 함수만 둔다(malaysia.store 패턴).
|
|
"""
|
|
|
|
from __future__ import annotations
|
|
|
|
import re
|
|
from html.parser import HTMLParser
|
|
from typing import Any
|
|
|
|
# 참고용 기본 세션(칸반 컬럼) 이름 목록 — 프로젝트 생성 시 자동으로 만들지는
|
|
# 않는다(세션은 아사나처럼 사용자가 직접 추가한다). 보드 컬럼 정렬 시 이
|
|
# 이름들을 우선순위로만 쓴다(router.py `_order`).
|
|
# (name, is_done_stage) — 마지막 '완료' 단계로 옮기면 업무 완료 처리.
|
|
DEFAULT_STAGES: tuple[tuple[str, bool], ...] = (
|
|
("할 일", False),
|
|
("진행 중", False),
|
|
("검토", False),
|
|
("완료", True),
|
|
)
|
|
|
|
# 업무 우선순위
|
|
PRIORITIES: tuple[str, ...] = ("low", "normal", "high")
|
|
PRIORITY_LABELS: dict[str, str] = {"low": "낮음", "normal": "보통", "high": "높음"}
|
|
|
|
# 프로젝트 상태
|
|
PROJECT_STATUSES: tuple[str, ...] = ("active", "completed", "archived")
|
|
|
|
# 멤버 역할
|
|
MEMBER_ROLES: tuple[str, ...] = ("manager", "member")
|
|
|
|
# 활동(activity) 종류 — 메일 트리거/타임라인 표시용
|
|
ACTION_CREATED = "created"
|
|
ACTION_ASSIGNED = "assigned"
|
|
ACTION_COMPLETED = "completed"
|
|
ACTION_STAGE_CHANGED = "stage_changed"
|
|
ACTION_REOPENED = "reopened"
|
|
|
|
# 프로젝트 색상 팔레트(아사나 느낌) — UI 선택지
|
|
COLOR_PALETTE: tuple[str, ...] = (
|
|
"#4573d2", # blue
|
|
"#37a3a3", # teal
|
|
"#62a420", # green
|
|
"#e8a33d", # amber
|
|
"#e8384f", # red
|
|
"#aa62e3", # purple
|
|
"#f06a6a", # coral
|
|
"#5a6772", # slate
|
|
)
|
|
|
|
# 세션(칸반 컬럼) 색상 팔레트 — 아사나 태그/커스텀필드에서 쓰는 10색.
|
|
# 세션 생성/편집 팝업의 색상표가 이 순서 그대로 노출된다.
|
|
STAGE_COLOR_PALETTE: tuple[str, ...] = (
|
|
"#4573d2", # blue
|
|
"#37a3a3", # teal
|
|
"#62a420", # green
|
|
"#e8a33d", # amber
|
|
"#e8384f", # red
|
|
"#aa62e3", # purple
|
|
"#f06a6a", # coral
|
|
"#5a6772", # slate
|
|
"#e8398a", # pink
|
|
"#a15c43", # brown
|
|
)
|
|
|
|
# ════════════════════════════════════════════════════════════
|
|
# 대한민국 국경일·공휴일(2026~2030) — 프로젝트 달력 표시 전용.
|
|
#
|
|
# vacation 모듈도 공휴일을 관리하지만(vacation_holidays 테이블) 그건
|
|
# 휴가 일수 계산용으로 vacation_db 에 강하게 결합돼 있고, 여기는 달력에
|
|
# 빨간 글씨로 "보여만" 주면 되는 용도라 별도 DB 연결 없이 정적 표로 둔다.
|
|
# 근로자의 날(5/1)·제헌절(7/17)은 관공서 공휴일이 아니라서 제외했다
|
|
# (vacation 모듈의 기존 2026년 시드와 동일 기준). 대체공휴일은 실제
|
|
# "관공서의 공휴일에 관한 규정" 대체공휴일 규정을 그대로 반영함(설날·
|
|
# 추석·어린이날·삼일절/광복절/개천절/한글날·부처님오신날·성탄절 대상,
|
|
# 신정·현충일은 대체 없음). 새 연도가 필요하면 이 표에 추가한다.
|
|
# ════════════════════════════════════════════════════════════
|
|
KR_HOLIDAYS: dict[str, str] = {
|
|
# 2026
|
|
"2026-01-01": "신정",
|
|
"2026-02-16": "설날 연휴", "2026-02-17": "설날", "2026-02-18": "설날 연휴",
|
|
"2026-03-01": "삼일절", "2026-03-02": "삼일절 대체",
|
|
"2026-05-05": "어린이날",
|
|
"2026-05-24": "부처님오신날", "2026-05-25": "부처님오신날 대체",
|
|
"2026-06-06": "현충일",
|
|
"2026-08-15": "광복절", "2026-08-17": "광복절 대체",
|
|
"2026-09-24": "추석 연휴", "2026-09-25": "추석", "2026-09-26": "추석 연휴",
|
|
"2026-09-28": "추석 대체",
|
|
"2026-10-03": "개천절", "2026-10-05": "개천절 대체",
|
|
"2026-10-09": "한글날",
|
|
"2026-12-25": "성탄절",
|
|
# 2027
|
|
"2027-01-01": "신정",
|
|
"2027-02-06": "설날 연휴", "2027-02-07": "설날", "2027-02-08": "설날 연휴",
|
|
"2027-02-09": "설날 대체",
|
|
"2027-03-01": "삼일절",
|
|
"2027-05-05": "어린이날",
|
|
"2027-05-13": "부처님오신날",
|
|
"2027-06-06": "현충일",
|
|
"2027-08-15": "광복절", "2027-08-16": "광복절 대체",
|
|
"2027-09-14": "추석 연휴", "2027-09-15": "추석", "2027-09-16": "추석 연휴",
|
|
"2027-10-03": "개천절", "2027-10-04": "개천절 대체",
|
|
"2027-10-09": "한글날", "2027-10-11": "한글날 대체",
|
|
"2027-12-25": "성탄절", "2027-12-27": "성탄절 대체",
|
|
# 2028
|
|
"2028-01-01": "신정",
|
|
"2028-01-26": "설날 연휴", "2028-01-27": "설날", "2028-01-28": "설날 연휴",
|
|
"2028-03-01": "삼일절",
|
|
"2028-05-02": "부처님오신날",
|
|
"2028-05-05": "어린이날",
|
|
"2028-06-06": "현충일",
|
|
"2028-08-15": "광복절",
|
|
"2028-10-02": "추석 연휴", "2028-10-03": "추석·개천절", "2028-10-04": "추석 연휴",
|
|
"2028-10-05": "개천절 대체",
|
|
"2028-10-09": "한글날",
|
|
"2028-12-25": "성탄절",
|
|
# 2029
|
|
"2029-01-01": "신정",
|
|
"2029-02-12": "설날 연휴", "2029-02-13": "설날", "2029-02-14": "설날 연휴",
|
|
"2029-03-01": "삼일절",
|
|
"2029-05-05": "어린이날", "2029-05-07": "어린이날 대체",
|
|
"2029-05-20": "부처님오신날", "2029-05-21": "부처님오신날 대체",
|
|
"2029-06-06": "현충일",
|
|
"2029-08-15": "광복절",
|
|
"2029-09-21": "추석 연휴", "2029-09-22": "추석", "2029-09-23": "추석 연휴",
|
|
"2029-09-24": "추석 대체",
|
|
"2029-10-03": "개천절",
|
|
"2029-10-09": "한글날",
|
|
"2029-12-25": "성탄절",
|
|
# 2030
|
|
"2030-01-01": "신정",
|
|
"2030-02-02": "설날 연휴", "2030-02-03": "설날", "2030-02-04": "설날 연휴",
|
|
"2030-02-05": "설날 대체",
|
|
"2030-03-01": "삼일절",
|
|
"2030-05-05": "어린이날", "2030-05-06": "어린이날 대체",
|
|
"2030-05-09": "부처님오신날",
|
|
"2030-06-06": "현충일",
|
|
"2030-08-15": "광복절",
|
|
"2030-09-11": "추석 연휴", "2030-09-12": "추석", "2030-09-13": "추석 연휴",
|
|
"2030-10-03": "개천절",
|
|
"2030-10-09": "한글날",
|
|
"2030-12-25": "성탄절",
|
|
}
|
|
|
|
|
|
def holiday_name(iso_date: str) -> str:
|
|
"""해당 날짜(YYYY-MM-DD)가 공휴일이면 이름을, 아니면 빈 문자열을 반환."""
|
|
return KR_HOLIDAYS.get(iso_date, "")
|
|
|
|
|
|
def norm_str(s: Any, *, lower: bool = False) -> str:
|
|
out = str(s or "").strip()
|
|
return out.lower() if lower else out
|
|
|
|
|
|
def validate_priority(p: Any) -> str:
|
|
v = norm_str(p, lower=True)
|
|
return v if v in PRIORITIES else "normal"
|
|
|
|
|
|
def validate_role(r: Any) -> str:
|
|
v = norm_str(r, lower=True)
|
|
return v if v in MEMBER_ROLES else "member"
|
|
|
|
|
|
def validate_project_name(name: Any) -> str:
|
|
v = norm_str(name)
|
|
if not v:
|
|
raise ValueError("프로젝트 이름은 필수입니다.")
|
|
if len(v) > 200:
|
|
raise ValueError("프로젝트 이름이 너무 깁니다(200자 이내).")
|
|
return v
|
|
|
|
|
|
def validate_task_title(title: Any) -> str:
|
|
v = norm_str(title)
|
|
if not v:
|
|
raise ValueError("업무 제목은 필수입니다.")
|
|
if len(v) > 300:
|
|
raise ValueError("업무 제목이 너무 깁니다(300자 이내).")
|
|
return v
|
|
|
|
|
|
def validate_color(color: Any) -> str:
|
|
v = norm_str(color)
|
|
if not v:
|
|
return COLOR_PALETTE[0]
|
|
# 매우 단순한 hex 검증 — #RGB / #RRGGBB
|
|
if v.startswith("#") and len(v) in (4, 7):
|
|
try:
|
|
int(v[1:], 16)
|
|
return v.lower()
|
|
except ValueError:
|
|
pass
|
|
return COLOR_PALETTE[0]
|
|
|
|
|
|
def validate_stage_color(color: Any) -> str | None:
|
|
"""세션 색상 — 팔레트 밖 값/빈값은 저장 안 함(NULL, 기본 회색 표시)."""
|
|
v = norm_str(color).lower()
|
|
return v if v in STAGE_COLOR_PALETTE else None
|
|
|
|
|
|
def validate_date(d: Any) -> str | None:
|
|
"""'YYYY-MM-DD' 형식만 통과. 빈값은 None."""
|
|
from datetime import date as _date # noqa: WPS433
|
|
|
|
v = norm_str(d)
|
|
if not v:
|
|
return None
|
|
try:
|
|
_date.fromisoformat(v[:10])
|
|
except (ValueError, TypeError):
|
|
raise ValueError(f"날짜 형식이 올바르지 않습니다: {d}")
|
|
return v[:10]
|
|
|
|
|
|
def validate_time(t: Any) -> str | None:
|
|
"""'HH:MM' 형식만 통과(초는 버림). 빈값/None 은 None(=종일)."""
|
|
v = norm_str(t)
|
|
if not v:
|
|
return None
|
|
parts = v.split(":")
|
|
try:
|
|
hh = int(parts[0])
|
|
mm = int(parts[1]) if len(parts) > 1 else 0
|
|
except (ValueError, IndexError):
|
|
raise ValueError(f"시간 형식이 올바르지 않습니다: {t}")
|
|
if not (0 <= hh <= 23 and 0 <= mm <= 59):
|
|
raise ValueError(f"시간 범위가 올바르지 않습니다: {t}")
|
|
return f"{hh:02d}:{mm:02d}"
|
|
|
|
|
|
def build_subject_assigned(*, project_name: str, task_title: str, assignee: str) -> str:
|
|
return f"[DBX 프로젝트] 업무 배정: {project_name} · {task_title} → {assignee}"
|
|
|
|
|
|
def build_subject_completed(*, project_name: str, task_title: str) -> str:
|
|
return f"[DBX 프로젝트] 업무 완료: {project_name} · {task_title}"
|
|
|
|
|
|
def build_subject_project_done(*, project_name: str) -> str:
|
|
return f"[DBX 프로젝트] 프로젝트 완료: {project_name}"
|
|
|
|
|
|
# ════════════════════════════════════════════════════════════
|
|
# 업무 설명 HTML 정리 (이미지 붙여넣기/업로드 삽입 지원)
|
|
#
|
|
# 업무 편집창의 설명란은 contenteditable 이라 브라우저가 임의의 HTML을
|
|
# 만들어 보낼 수 있다. 여기서 허용 태그만 남기고 스크립트/이벤트 속성/위험
|
|
# URL 스킴을 제거한다 — 외부 라이브러리(bleach 등) 없이 표준 라이브러리
|
|
# html.parser 만으로 구현한다(카페24 모듈 자체호스팅 원칙과 동일).
|
|
#
|
|
# 기존에 일반 텍스트로 저장돼 있던 설명은 마이그레이션(project_db_003)에서
|
|
# 한 번에 안전한 HTML로 변환해뒀다 — 여기서는 "이게 HTML이냐 텍스트냐"를
|
|
# 런타임에 추측하지 않는다(추측은 오탐이 난다). description 컬럼은 이제
|
|
# 항상 HTML이라고 가정한다.
|
|
# ════════════════════════════════════════════════════════════
|
|
_DESC_ALLOWED_TAGS: frozenset[str] = frozenset({
|
|
"p", "br", "b", "strong", "i", "em", "u", "a", "img",
|
|
"ul", "ol", "li", "blockquote", "code", "pre", "span", "div",
|
|
})
|
|
_DESC_VOID_TAGS: frozenset[str] = frozenset({"br", "img"})
|
|
# a: target/rel 은 "새 탭에서 열기"용. 화면(설명란)에서 링크를 클릭하면
|
|
# 새 탭으로 여는데, 저장했다 다시 열었을 때도 같은 동작이어야 해서 허용한다.
|
|
# span: 멘션 칩(@이름) 전용 — class="pj-mention" + data-email 만 남긴다.
|
|
_DESC_ALLOWED_ATTRS: dict[str, frozenset[str]] = {
|
|
"a": frozenset({"href", "target", "rel"}),
|
|
"img": frozenset({"src", "alt", "width", "height"}),
|
|
"span": frozenset({"class", "data-email"}),
|
|
}
|
|
# URL 은 금지 목록이 아니라 허용 목록으로 검사한다. 금지 목록(javascript: 등)은
|
|
# "jav	ascript:" 처럼 중간에 탭/개행을 끼우면 통과하는데, 브라우저는 URL 을
|
|
# 해석할 때 그 문자들을 지워버려 그대로 스크립트가 실행된다.
|
|
_DESC_SAFE_SCHEMES: frozenset[str] = frozenset({"http", "https", "mailto", "tel"})
|
|
# <img src> 에만 허용하는 data: 이미지(붙여넣기 폴백). svg 는 스크립트를 품을 수 있어 제외.
|
|
_DESC_SAFE_DATA_IMAGE = re.compile(r"^data:image/(png|jpe?g|gif|webp|bmp);", re.I)
|
|
_URL_SCHEME_RE = re.compile(r"^([a-z][a-z0-9+.\-]*):", re.I)
|
|
_C0_AND_SPACE = "".join(chr(i) for i in range(0x21)) # 브라우저가 URL 앞뒤에서 떼는 문자
|
|
|
|
# 첨부를 브라우저 안에서 바로 보여줘도 되는 형식(`/inline`). 그 밖의 형식(HTML·SVG
|
|
# 등)은 같은 도메인에서 열리면 스크립트가 돌 수 있어 항상 다운로드로 내려준다.
|
|
INLINE_SAFE_CONTENT_TYPES: frozenset[str] = frozenset({
|
|
"image/png", "image/jpeg", "image/jpg", "image/gif", "image/webp", "image/bmp",
|
|
})
|
|
|
|
|
|
def inline_safe_content_type(content_type: Any) -> bool:
|
|
return norm_str(content_type, lower=True).split(";", 1)[0].strip() in INLINE_SAFE_CONTENT_TYPES
|
|
# 멘션 칩: <span class="pj-mention" data-email="...">@이름</span>
|
|
_MENTION_CLASS = "pj-mention"
|
|
# script/style 은 태그 자체는 물론 그 안의 텍스트(코드)도 통째로 버린다 —
|
|
# 허용 태그 목록에 없어 태그는 이미 안 남지만, HTMLParser는 이 둘의 내용을
|
|
# 별도 데이터로 넘기므로 handle_data 에서 따로 걸러야 한다.
|
|
_DESC_RAW_TEXT_TAGS: frozenset[str] = frozenset({"script", "style"})
|
|
|
|
|
|
def _desc_escape_text(text: str) -> str:
|
|
return text.replace("&", "&").replace("<", "<").replace(">", ">")
|
|
|
|
|
|
def _desc_escape_attr(value: str) -> str:
|
|
return _desc_escape_text(value).replace('"', """)
|
|
|
|
|
|
def desc_url_is_safe(value: str, *, allow_data_image: bool = False) -> bool:
|
|
"""href/src 허용 여부. 스킴이 없으면(상대경로·#앵커) 허용, 있으면 허용 목록만.
|
|
|
|
브라우저와 같은 방식으로 정규화한 뒤 검사한다 — 앞뒤 공백/제어문자를 떼고,
|
|
중간의 탭·개행(\\t \\n \\r)은 지운다(WHATWG URL 파서 동작).
|
|
"""
|
|
v = re.sub(r"[\t\n\r]", "", value or "").strip(_C0_AND_SPACE)
|
|
m = _URL_SCHEME_RE.match(v)
|
|
if not m:
|
|
# "javascript:..." 같은 건 convert_charrefs 로 이미 풀려 여기 오지
|
|
# 않는다. 스킴이 없는 값 중 ':' 가 첫 '/' 보다 앞에 있으면 해석이 모호하니 막는다.
|
|
head = v.split("/", 1)[0]
|
|
return ":" not in head
|
|
scheme = m.group(1).lower()
|
|
if scheme in _DESC_SAFE_SCHEMES:
|
|
return True
|
|
return allow_data_image and bool(_DESC_SAFE_DATA_IMAGE.match(v))
|
|
|
|
|
|
class _DescriptionSanitizer(HTMLParser):
|
|
"""허용 태그/속성만 통과시키는 최소 HTML 정리기."""
|
|
|
|
def __init__(self) -> None:
|
|
super().__init__(convert_charrefs=True)
|
|
self.out: list[str] = []
|
|
self._open: list[str] = []
|
|
self._raw = False # <script>/<style> 내부(태그 자체와 별개로 텍스트도 버림)
|
|
|
|
def _emit_start(self, tag: str, attrs: list[tuple[str, str | None]]) -> None:
|
|
if tag in _DESC_RAW_TEXT_TAGS:
|
|
self._raw = True
|
|
return
|
|
if tag not in _DESC_ALLOWED_TAGS:
|
|
return
|
|
allowed = _DESC_ALLOWED_ATTRS.get(tag, frozenset())
|
|
# span 은 멘션 칩일 때만 속성을 갖는다 — class 가 pj-mention 이 아니면
|
|
# data-email 까지 통째로 버린다(평범한 span 으로만 남는다).
|
|
if tag == "span" and (dict(attrs).get("class") or "").strip() != _MENTION_CLASS:
|
|
allowed = frozenset()
|
|
kept: list[str] = []
|
|
for name, value in attrs:
|
|
if name not in allowed:
|
|
continue
|
|
value = value or ""
|
|
if name == "href" and not desc_url_is_safe(value):
|
|
continue
|
|
if name == "src" and not desc_url_is_safe(value, allow_data_image=True):
|
|
continue
|
|
# class 는 멘션 칩 하나만 허용한다(임의 클래스로 화면 스타일을
|
|
# 흔들 여지를 남기지 않는다).
|
|
if name == "class" and value.strip() != _MENTION_CLASS:
|
|
continue
|
|
kept.append(f'{name}="{_desc_escape_attr(value)}"')
|
|
attr_text = (" " + " ".join(kept)) if kept else ""
|
|
self.out.append(f"<{tag}{attr_text}>")
|
|
if tag not in _DESC_VOID_TAGS:
|
|
self._open.append(tag)
|
|
|
|
def handle_starttag(self, tag: str, attrs: list[tuple[str, str | None]]) -> None:
|
|
self._emit_start(tag, attrs)
|
|
|
|
def handle_startendtag(self, tag: str, attrs: list[tuple[str, str | None]]) -> None:
|
|
self._emit_start(tag, attrs)
|
|
|
|
def handle_endtag(self, tag: str) -> None:
|
|
if tag in _DESC_RAW_TEXT_TAGS:
|
|
self._raw = False
|
|
return
|
|
if tag not in _DESC_ALLOWED_TAGS or tag in _DESC_VOID_TAGS:
|
|
return
|
|
if tag not in self._open:
|
|
return
|
|
# 짝이 안 맞는 깨진 HTML 방어 — 스택에서 같은 태그가 나올 때까지 닫는다.
|
|
while self._open:
|
|
top = self._open.pop()
|
|
self.out.append(f"</{top}>")
|
|
if top == tag:
|
|
break
|
|
|
|
def handle_data(self, data: str) -> None:
|
|
if self._raw:
|
|
return
|
|
self.out.append(_desc_escape_text(data))
|
|
|
|
def close(self) -> None:
|
|
super().close()
|
|
while self._open:
|
|
self.out.append(f"</{self._open.pop()}>")
|
|
|
|
|
|
def sanitize_description_html(html: str) -> str:
|
|
"""업무 설명 HTML을 허용 태그만 남기고 정리한다.
|
|
|
|
스크립트·이벤트 속성(onerror 등)·위험 URL 스킴(javascript: 등)을 제거한다.
|
|
저장 직전 항상 이 함수를 거친다 — 화면에서 붙여넣은 이미지/서식은 거의
|
|
그대로 남고, 위험한 부분만 사라진다.
|
|
"""
|
|
parser = _DescriptionSanitizer()
|
|
parser.feed(html or "")
|
|
parser.close()
|
|
return "".join(parser.out).strip()
|
|
|
|
|
|
# ════════════════════════════════════════════════════════════
|
|
# 멘션(@태그)
|
|
#
|
|
# 설명란은 HTML이라 멘션 칩(<span class="pj-mention" data-email="...">)에서
|
|
# 이메일을 그대로 꺼낼 수 있다 — 클라이언트가 따로 알려주는 목록을 믿지 않고
|
|
# 저장될 본문에서 직접 읽는다(본문과 알림이 어긋나지 않는다).
|
|
# 댓글은 평문이라 칩을 넣을 수 없으므로, 그쪽만 클라이언트가 보낸 이메일
|
|
# 목록을 받아 normalize_emails 로 정리해 쓴다.
|
|
# ════════════════════════════════════════════════════════════
|
|
class _MentionCollector(HTMLParser):
|
|
def __init__(self) -> None:
|
|
super().__init__(convert_charrefs=True)
|
|
self.emails: list[str] = []
|
|
|
|
def handle_starttag(self, tag: str, attrs: list[tuple[str, str | None]]) -> None:
|
|
if tag != "span":
|
|
return
|
|
attr = dict(attrs)
|
|
if (attr.get("class") or "").strip() != _MENTION_CLASS:
|
|
return
|
|
email = norm_str(attr.get("data-email") or "", lower=True)
|
|
if email and email not in self.emails:
|
|
self.emails.append(email)
|
|
|
|
|
|
def extract_mentions_from_html(html: str) -> list[str]:
|
|
"""설명 HTML 안의 멘션 칩에서 이메일을 뽑는다(중복 제거, 순서 유지)."""
|
|
parser = _MentionCollector()
|
|
parser.feed(html or "")
|
|
parser.close()
|
|
return parser.emails
|
|
|
|
|
|
def normalize_emails(values: Any) -> list[str]:
|
|
"""임의 입력(리스트/문자열)을 소문자 이메일 목록으로 정리한다."""
|
|
if isinstance(values, str):
|
|
values = values.split(",")
|
|
if not isinstance(values, (list, tuple)):
|
|
return []
|
|
out: list[str] = []
|
|
for v in values:
|
|
e = norm_str(str(v or ""), lower=True)
|
|
if e and "@" in e and e not in out:
|
|
out.append(e)
|
|
return out
|