feat(project): Project 옵션 시스템 전체 적용 + 모달 안 말풍선 가림 수정

- 프로젝트 화면(처음 여는 탭)·보드(카드 표지)는 서버 저장(project_db.project_options, 마이그레이션 029)
  → 수퍼관리자·Admin 이 바꾸면 모든 사용자에게 적용. 일반(폰트)은 그대로 이 브라우저(localStorage).
- GET/PUT /project/api/options(쓰기는 Admin 이상, 보낸 키만, 029 미적용 503). 검사·기본값은
  store.normalize/validate_project_options 한 곳. 프로젝트 화면은 data-default-view·data-board-cover 로 받음
  (읽기 실패해도 기본값으로 열림).
- 옵션 창: 열 때 서버 최신값 읽기(실패 시 시스템 칸 잠금·폰트만 저장), 바뀐 키만 PUT, 실패면 창 유지.
  분류 제목 옆 적용 범위 배지(이 브라우저에만 / 모든 사용자에게).
- 공용 말풍선: 모달 대화창(showModal) 안에서는 popover(top layer)로 띄워 대화창 뒤에 가려지지 않게.
- 테스트: tests/test_project_options_api.py, jsdom 옵션 테스트 갱신. 도움말·문서·DEPLOYMENT(029) 갱신.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-16 10:29:37 +09:00
parent 1cabad8e3b
commit 94fac65238
22 changed files with 501 additions and 144 deletions
+1 -1
View File
File diff suppressed because one or more lines are too long
@@ -2,7 +2,7 @@
{% block head_extra %}
{# 프로젝트 화면 부품(설명 편집기·날짜 팝업·멤버 고르기)을 그대로 쓴다 — project.js 는 PJ_LIB_ONLY 로 부품만 #}
<link rel="stylesheet" href="/static/project.css?v=20261016a" />
<link rel="stylesheet" href="/static/project.css?v=20261016b" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
<script>window.PJ_LIB_ONLY = true; window.PJ_HOLIDAYS = {{ (pj_kr_holidays or {}) | tojson }};</script>
{% endblock %}
@@ -64,7 +64,7 @@
</section>
</div>
<script>window.NTC_PEOPLE = {{ people | tojson }};</script>
<script src="/static/project.js?v=20261016c" defer></script>
<script src="/static/project.js?v=20261016d" defer></script>
<script src="/static/erp-notice-admin.js?v=20261012b" defer></script>
{% endif %}
{% endblock %}
+24
View File
@@ -1842,6 +1842,30 @@ class ProjectStore:
return False
return row is not None
# ── Project 옵션(시스템 전체, 마이그레이션 029) — 키 하나 = 행 하나, 값 검사는 store 한 곳 ──
def get_project_options(self) -> dict[str, Any]:
"""저장된 시스템 옵션 원본 {key: value}. 029 미적용이면 {}(화면은 기본값)."""
try:
with self._pool.connection() as conn:
rows = conn.execute("SELECT key, value FROM project_options").fetchall()
except psycopg_errors.UndefinedTable:
return {}
return {r["key"]: r["value"] for r in rows}
def set_project_options(self, *, values: dict[str, Any], updated_by: str) -> None:
"""검사를 마친 값만 넣는다(store.validate_project_options). 한 트랜잭션 — 전부 아니면 전무.
029 미적용이면 psycopg_errors.UndefinedTable(라우터가 503)."""
by = store.norm_str(updated_by, lower=True)
with self._pool.connection() as conn:
with conn.transaction():
for key, value in values.items():
conn.execute(
"INSERT INTO project_options (key, value, updated_by, updated_at) VALUES (%s, %s, %s, now()) "
"ON CONFLICT (key) DO UPDATE SET value = EXCLUDED.value, updated_by = EXCLUDED.updated_by, "
"updated_at = now()",
(key, Jsonb(value), by),
)
def notifier_revoke_token(self, *, token: str) -> None:
with self._pool.connection() as conn:
conn.execute("UPDATE notifier_tokens SET revoked_at = now() WHERE token_hash = %s AND revoked_at IS NULL",
+38
View File
@@ -899,6 +899,7 @@ def project_page(request: Request, project_id: int) -> HTMLResponse:
{
"user": user,
**_role_ctx(user),
"pj_options": _project_options(st),
"can_manage": can_manage,
"nav_items": build_erp_nav(user, active="project"),
"page_title": project["name"],
@@ -967,6 +968,43 @@ def _db_or_503(request: Request) -> Any:
return st
def _project_options(st: Any) -> dict[str, Any]:
"""시스템 Project 옵션(처음 여는 탭·보드 카드 표지) — 읽기 실패해도 화면은 기본값으로 연다."""
if st is None:
return store.normalize_project_options(None)
try:
return store.normalize_project_options(st.get_project_options())
except Exception: # noqa: BLE001 — 옵션 때문에 프로젝트 화면이 안 열리면 안 된다
logger.warning("Project 옵션 읽기 실패 — 기본값 사용", exc_info=True)
return store.normalize_project_options(None)
@router.get("/api/options")
def api_get_options(request: Request) -> JSONResponse:
"""Project 옵션 창 — 시스템 전체 설정(모든 사용자에게 적용)과 내가 바꿀 수 있는지(Admin 이상)."""
user = _require_user(request)
st = _db_or_503(request)
return JSONResponse({"options": _project_options(st), "can_edit": access.is_project_admin(user)})
@router.put("/api/options")
def api_put_options(request: Request, payload: dict[str, Any] = Body(...)) -> JSONResponse:
"""시스템 Project 옵션 저장 — 수퍼관리자·Admin 만. 보낸 키만 바꾼다. 029 미적용이면 503."""
user = _require_user(request)
if not access.is_project_admin(user):
raise HTTPException(status_code=403, detail="수퍼관리자·Admin 만 바꿀 수 있습니다.")
st = _db_or_503(request)
try:
values = store.validate_project_options(payload)
except ValueError as e:
raise HTTPException(status_code=400, detail=str(e))
try:
st.set_project_options(values=values, updated_by=user.get("email", ""))
except UndefinedTable:
raise HTTPException(status_code=503, detail="DB 마이그레이션 029(Project 옵션)가 아직 적용되지 않았습니다.")
return JSONResponse({"options": _project_options(st)})
@router.get("/api/projects")
def api_list_projects(request: Request) -> JSONResponse:
user = _require_user(request)
+41
View File
@@ -375,6 +375,47 @@ def validate_time(t: Any) -> str | None:
return f"{hh:02d}:{mm:02d}"
# ════════════════════════════════════════════════════════════
# Project 옵션 — 시스템 전체 설정(마이그레이션 029 project_options, 수퍼관리자·Admin 수정)
# 폰트 같은 "일반" 옵션은 브라우저별(localStorage)이라 여기 없다.
# ════════════════════════════════════════════════════════════
PROJECT_VIEWS: tuple[str, ...] = ("board", "list", "calendar", "timeline", "dashboard")
PROJECT_OPTION_DEFAULTS: dict[str, Any] = {
"default_view": "board", # 왼쪽에서 프로젝트를 열 때 처음 보이는 탭
"board_cover": True, # 보드 카드 표지(설명의 첫 이미지)
}
def normalize_project_options(raw: dict[str, Any] | None) -> dict[str, Any]:
"""DB 에서 읽은 값 → 화면용. 모르는 키는 버리고, 이상한 값·없는 키는 기본값(읽기는 실패하지 않는다)."""
out = dict(PROJECT_OPTION_DEFAULTS)
raw = raw or {}
if raw.get("default_view") in PROJECT_VIEWS:
out["default_view"] = raw["default_view"]
if isinstance(raw.get("board_cover"), bool):
out["board_cover"] = raw["board_cover"]
return out
def validate_project_options(payload: Any) -> dict[str, Any]:
"""저장 요청 검사 — 보낸 키만 돌려준다(일부만 바꿀 수 있게). 모르는 키·잘못된 값·빈 요청은 ValueError."""
if not isinstance(payload, dict) or not payload:
raise ValueError("바꿀 옵션이 없습니다.")
unknown = set(payload) - set(PROJECT_OPTION_DEFAULTS)
if unknown:
raise ValueError("알 수 없는 옵션입니다: " + ", ".join(sorted(unknown)))
out: dict[str, Any] = {}
if "default_view" in payload:
if payload["default_view"] not in PROJECT_VIEWS:
raise ValueError("처음 여는 탭 값이 올바르지 않습니다.")
out["default_view"] = payload["default_view"]
if "board_cover" in payload:
if not isinstance(payload["board_cover"], bool):
raise ValueError("카드 표지 값이 올바르지 않습니다.")
out["board_cover"] = payload["board_cover"]
return out
# ════════════════════════════════════════════════════════════
# 연간 목표 (마이그레이션 013) — 사이드바 "목표" → 연도
# ════════════════════════════════════════════════════════════
@@ -1,9 +1,9 @@
{# Project 옵션 — 상단 바 톱니. 왼쪽 분류(일반·프로젝트 화면·보드·관리자) | 오른쪽 설정.
일반(폰트)만 모두에게, 프로젝트 화면·보드는 수퍼관리자·Admin(pj_admin — 그 밖은 project.js 가 기본값으로 동작),
관리자(긴급 공지)는 수퍼관리자만(공지 화면이 수퍼관리자 전용).
설정은 모두 이 브라우저에 저장(localStorage) — 저장 버튼을 눌러야 한꺼번에 반영된다.
키: pj_font(폰트) · pj_default_view(프로젝트 첫 탭) · pj_board_cover(보드 카드 표지 이미지, "0" = 끔).
읽는 쪽: 폰트 = 아래 인라인 스크립트, 첫 탭·표지 = project.js(isPAdmin), 저장 시 "pj-options-change" 이벤트. #}
{# Project 옵션 — 상단 바 톱니. 왼쪽 분류(일반·프로젝트 화면·보드·관리자) | 오른쪽 설정. 저장 버튼을 눌러야 한꺼번에 반영된다.
· 일반(폰트) — 모두에게 보이고 이 브라우저에만 저장(localStorage pj_font, 아래 인라인 스크립트가 복원).
· 프로젝트 화면(처음 여는 탭)·보드(카드 표지) — 수퍼관리자·Admin(pj_admin)만 보이고, 서버(project_options, 마이그레이션 029)에
저장해 모든 사용자에게 적용. 창을 열 때 GET /project/api/options, 저장은 PUT. project.html 이 data-default-view·
data-board-cover 로 받아 project.js 가 쓴다. 저장하면 "pj-options-change" 이벤트로 보던 보드에 바로 반영.
· 관리자(긴급 공지) — 수퍼관리자만(공지 화면이 수퍼관리자 전용). #}
<button type="button" class="pj-help-btn" id="pj-options-btn" aria-label="Project 옵션" title="Project 옵션">
<span class="material-symbols-outlined">settings</span>
</button>
@@ -33,7 +33,7 @@
<div class="pj-options-panes">
<section class="pj-options-pane" role="tabpanel" id="pj-opt-pane-general" aria-labelledby="pj-opt-tab-general" data-pane="general">
<h3>일반</h3>
<h3>일반 <span class="pj-options-badge"><span class="material-symbols-outlined">computer</span>이 브라우저에만 적용</span></h3>
<div class="pj-options-group">
<div class="pj-options-row is-stack">
<label for="pj-options-font"><b>폰트</b><small>Project 화면 전체의 글꼴</small></label>
@@ -51,7 +51,7 @@
{% if pj_admin %}
<section class="pj-options-pane" role="tabpanel" id="pj-opt-pane-view" aria-labelledby="pj-opt-tab-view" data-pane="view" hidden>
<h3>프로젝트 화면</h3>
<h3>프로젝트 화면 <span class="pj-options-badge is-global"><span class="material-symbols-outlined">groups</span>모든 사용자에게 적용</span></h3>
<div class="pj-options-group">
<div class="pj-options-row is-stack">
<span class="pj-options-label" id="pj-options-view-label"><b>처음 여는 탭</b><small>왼쪽에서 프로젝트를 고르면 바로 보이는 보기</small></span>
@@ -68,7 +68,7 @@
</section>
<section class="pj-options-pane" role="tabpanel" id="pj-opt-pane-board" aria-labelledby="pj-opt-tab-board" data-pane="board" hidden>
<h3>보드</h3>
<h3>보드 <span class="pj-options-badge is-global"><span class="material-symbols-outlined">groups</span>모든 사용자에게 적용</span></h3>
<div class="pj-options-group">
<label class="pj-options-row" for="pj-options-cover">
<span class="pj-options-label"><b>카드 표지 이미지</b><small>메인 업무 설명의 첫 이미지를 보드 카드 위에 보여 줍니다</small></span>
@@ -93,7 +93,6 @@
<footer class="pj-options-foot">
<button type="button" class="pj-btn pj-options-reset" id="pj-options-reset" title="모든 옵션을 처음 값으로(저장해야 반영)">기본값으로</button>
<p class="pj-options-error" id="pj-options-error" role="alert" hidden></p>
<span class="pj-options-scope">이 브라우저에만 저장됩니다</span>
<button type="button" class="pj-btn" id="pj-options-cancel">취소</button>
<button type="submit" class="pj-btn pj-btn-primary" id="pj-options-save">저장</button>
</footer>
@@ -106,4 +105,4 @@
document.documentElement.dataset.pjFont = pf;
} catch (_) {}
</script>
<script src="/static/project-options.js?v=20261016b" defer></script>
<script src="/static/project-options.js?v=20261016c" defer></script>
@@ -1,7 +1,7 @@
{% extends "project/_meeting_content_base.html" if meeting_embedded else "erp_base.html" %}
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20261016a" />
<link rel="stylesheet" href="/static/project.css?v=20261016b" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %}
@@ -298,5 +298,5 @@
<script src="/static/project-goal-text.js?v=20261003d" defer></script>
<script src="/static/project-meeting-cells.js?v=20261012a" defer></script>
<script src="/static/project.js?v=20261016c" defer></script>
<script src="/static/project.js?v=20261016d" defer></script>
{% endblock %}
@@ -1,7 +1,7 @@
{% extends "erp_base.html" %}
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20261016a" />
<link rel="stylesheet" href="/static/project.css?v=20261016b" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %}
@@ -207,5 +207,5 @@
{% include "project/_member_tasks_modal.html" %}
<script src="/static/project-goal-text.js?v=20261003d" defer></script>
<script src="/static/project.js?v=20261016c" defer></script>
<script src="/static/project.js?v=20261016d" defer></script>
{% endblock %}
@@ -1,7 +1,7 @@
{% extends "erp_base.html" %}
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20261016a" />
<link rel="stylesheet" href="/static/project.css?v=20261016b" />
<link rel="stylesheet" href="/static/project-help.css?v=20261003a" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %}
@@ -117,11 +117,12 @@
<li><span class="pjh-ui"><span class="material-symbols-outlined">fit_screen</span></span> 화면 배율 — 누르면(파랗게 켜짐) 화면 전체를 75%로 줄입니다. 2880×1620 모니터를 Windows 배율 200%로 쓰면 화면이 꽉 차 보이는데, 이때 켜면 1920×1080 모니터와 같은 모습이 됩니다. 브라우저마다 기억합니다. 메뉴·말풍선 같은 작은 팝업은 원래 크기로 뜹니다.</li>
<li><span class="pjh-ui"><span class="material-symbols-outlined">help</span></span> 물음표 — 지금 보고 있는 이 도움말을 새 탭으로 엽니다.</li>
<li><span class="pjh-ui"><span class="material-symbols-outlined">settings</span></span> 도움말 오른쪽의 옵션 — 왼쪽 분류를 골라 설정을 바꾸고 <span class="pjh-ui">저장</span>을 누르면 한꺼번에 적용되고 창이 닫힙니다.
<b>일반</b>: 폰트(기본 시스템 폰트·프리텐다드·나눔 스퀘어·나눔 스퀘어 네오·나눔 스퀘어 라운드, 미리보기).
아래 프로젝트 화면·보드 분류는 수퍼관리자·Admin 에게만, 관리자(긴급 공지) 분류는 수퍼관리자에게만 보입니다(다른 사용자는 보드로 열리고 카드 표지가 보이는 기본 그대로).
<b>일반</b>: 폰트(기본 시스템 폰트·프리텐다드·나눔 스퀘어·나눔 스퀘어 네오·나눔 스퀘어 라운드, 미리보기) — 누구나 바꿀 수 있고 이 브라우저에만 적용됩니다.
아래 프로젝트 화면·보드 분류는 수퍼관리자·Admin 에게만 보이고, 바꾸면 <b>모든 사용자</b>에게 적용됩니다(다른 사람은 다음에 화면을 열 때부터). 관리자(긴급 공지) 분류는 수퍼관리자에게만 보입니다.
분류 제목 옆 표시(이 브라우저에만 / 모든 사용자에게)로 적용 범위를 알 수 있습니다.
<b>프로젝트 화면</b>: 처음 여는 탭 — 왼쪽에서 프로젝트를 고르면 바로 보일 보기(보드·목록·캘린더·타임라인·대시보드). 왼쪽 "전체 보기"는 늘 대시보드로 열립니다.
<b>보드</b>: 카드 표지 이미지 — 끄면 메인 업무 설명에 이미지가 있어도 보드 카드에 표지를 보여 주지 않습니다(보던 보드에 바로 반영).
<span class="pjh-ui">기본값으로</span>는 창 안의 값만 처음으로 돌립니다(저장해야 반영). 설정은 이 브라우저에 기억합니다. <span class="pjh-ui">취소</span>는 변경을 적용하지 않고 닫습니다.</li>
<span class="pjh-ui">기본값으로</span>는 창 안의 값만 처음으로 돌립니다(저장해야 반영). <span class="pjh-ui">취소</span>는 변경을 적용하지 않고 닫습니다.</li>
</ul>
<h3>프로젝트 제목</h3>
<p>가운데 위 프로젝트 제목에 마우스를 올리면 테두리가 생깁니다. 누르면 그 자리에서 이름을 고칩니다 — <kbd>Enter</kbd>나 바깥을 누르면 저장, <kbd>Esc</kbd>는 취소. (그 프로젝트 멤버인 Pro user 이상만)</p>
@@ -1,7 +1,7 @@
{% extends "erp_base.html" %}
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20261016a" />
<link rel="stylesheet" href="/static/project.css?v=20261016b" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %}
@@ -106,5 +106,5 @@
{% include "project/_side_modals.html" %}
{% include "project/_member_tasks_modal.html" %}
<script src="/static/project.js?v=20261016c" defer></script>
<script src="/static/project.js?v=20261016d" defer></script>
{% endblock %}
@@ -1,7 +1,7 @@
{% extends "erp_base.html" %}
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20261016a" />
<link rel="stylesheet" href="/static/project.css?v=20261016b" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %}
@@ -100,5 +100,5 @@
"today": {{ today | tojson }}
}
</script>
<script src="/static/project.js?v=20261016c" defer></script>
<script src="/static/project.js?v=20261016d" defer></script>
{% endblock %}
@@ -1,7 +1,7 @@
{% extends "erp_base.html" %}
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20261016a" />
<link rel="stylesheet" href="/static/project.css?v=20261016b" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %}
@@ -108,5 +108,5 @@
});
})();
</script>
<script src="/static/project.js?v=20261016c" defer></script>
<script src="/static/project.js?v=20261016d" defer></script>
{% endblock %}
@@ -1,7 +1,7 @@
{% extends "erp_base.html" %}
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20261016a" />
<link rel="stylesheet" href="/static/project.css?v=20261016b" />
<!-- 구글 머티리얼 심볼(담당자 아이콘 등) — self-host -->
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
<!-- 타임라인 vis-timeline — self-host -->
@@ -29,6 +29,8 @@
data-can-manage="{{ 'true' if can_manage else 'false' }}"
data-is-pro="{{ 'true' if pj_pro else 'false' }}" data-is-padmin="{{ 'true' if pj_admin else 'false' }}"
data-is-super="{{ 'true' if user.is_super_admin else 'false' }}"
data-default-view="{{ pj_options.default_view if pj_options else 'board' }}"
data-board-cover="{{ '0' if pj_options and not pj_options.board_cover else '1' }}"
data-me="{{ user.email }}">
<div class="pj-layout">
@@ -470,5 +472,5 @@
</script>
<script src="/static/vendor/vis-timeline/vis-timeline-graph2d.min.js"></script>
<script src="/static/project.js?v=20261016c" defer></script>
<script src="/static/project.js?v=20261016d" defer></script>
{% endblock %}
@@ -1,7 +1,7 @@
{% extends "erp_base.html" %}
{% block head_extra %}
<link rel="stylesheet" href="/static/project.css?v=20261016a" />
<link rel="stylesheet" href="/static/project.css?v=20261016b" />
<link rel="stylesheet" href="/static/vendor/material-symbols/material-symbols.css" />
{% endblock %}
@@ -70,5 +70,5 @@
{% include "project/_side_modals.html" %}
{% include "project/_member_tasks_modal.html" %}
<script src="/static/project.js?v=20261016c" defer></script>
<script src="/static/project.js?v=20261016d" defer></script>
{% endblock %}
+72 -34
View File
@@ -6,33 +6,38 @@
const names = { system: null, pretendard: "Pretendard Variable", "nanum-square": "NanumSquare",
"nanum-square-neo": "NanumSquareNeo", "nanum-square-round": "NanumSquareRound" };
const VIEWS = ["board", "list", "calendar", "timeline", "dashboard"];
const DEFAULTS = { font: "system", default_view: "board", board_cover: true };
const FONT_DEFAULT = "system";
const SYS_DEFAULTS = { default_view: "board", board_cover: true }; // 서버 store.PROJECT_OPTION_DEFAULTS 와 같게
const form = document.getElementById("pj-options-form");
const select = document.getElementById("pj-options-font"), preview = document.getElementById("pj-options-preview");
const cover = document.getElementById("pj-options-cover");
const error = document.getElementById("pj-options-error"), save = document.getElementById("pj-options-save");
const cancel = document.getElementById("pj-options-cancel"), closeX = document.getElementById("pj-options-x");
const reset = document.getElementById("pj-options-reset");
const tabs = Array.from(dialog.querySelectorAll(".pj-options-nav [role=tab]"));
const panes = Array.from(dialog.querySelectorAll(".pj-options-pane"));
// 처음 여는 탭·표지는 수퍼관리자 창에만 있다(_options.html) — 없으면 폰트만 다룬다.
// 처음 여는 탭·카드 표지 = 시스템 전체 설정(서버, 모든 사용자) — 수퍼관리자·Admin 창에만 있다(_options.html).
// 없으면 폰트(이 브라우저)만 다룬다.
const cover = document.getElementById("pj-options-cover");
const views = form.elements.default_view || null;
const controls = [select, cover, cancel, closeX, reset].concat(Array.from(views || [])).filter(Boolean);
const sysControls = [cover].concat(Array.from(views || [])).filter(Boolean);
const localControls = [select, cancel, closeX, reset];
let sys = null; // 서버에서 읽은 시스템 옵션 — 못 읽었으면 null(그때는 폰트만 저장)
let openSeq = 0; // 창을 다시 열면 앞의 늦은 응답은 버린다
function ls(key) { try { return localStorage.getItem(key); } catch (_) { return null; } }
function current() {
const f = document.documentElement.dataset.pjFont, v = ls("pj_default_view");
return {
font: Object.hasOwn(names, f) ? f : DEFAULTS.font,
default_view: VIEWS.indexOf(v) >= 0 ? v : DEFAULTS.default_view,
board_cover: ls("pj_board_cover") !== "0",
};
function setError(msg) { error.textContent = msg || ""; error.hidden = !msg; }
async function request(method, body) {
const opts = { method: method, headers: { "Content-Type": "application/json" } };
if (body !== undefined) opts.body = JSON.stringify(body);
const res = await fetch("/project/api/options", opts);
let data = null;
try { data = await res.json(); } catch (_) {}
if (!res.ok) throw new Error((data && typeof data.detail === "string" && data.detail) || res.statusText || "오류");
return data || {};
}
function fill(o) {
select.value = o.font;
function currentFont() { const f = document.documentElement.dataset.pjFont; return Object.hasOwn(names, f) ? f : FONT_DEFAULT; }
function fillSys(o) {
if (views) views.value = o.default_view;
if (cover) cover.checked = o.board_cover;
paint();
}
function paint() {
const font = names[select.value];
@@ -48,11 +53,32 @@
});
panes.forEach(function (p) { p.hidden = p.dataset.pane !== name; });
}
function busy(on) { save.disabled = on; controls.forEach(function (c) { c.disabled = on; }); }
function busy(on) {
save.disabled = on;
localControls.forEach(function (c) { c.disabled = on; });
sysControls.forEach(function (c) { c.disabled = on || !sys; });
}
function close() { if (!save.disabled) dialog.close(); }
async function loadSys() {
if (!sysControls.length) return;
const seq = ++openSeq;
sys = null; busy(false); // 읽는 동안 시스템 칸은 잠금
try {
const data = await request("GET");
if (seq !== openSeq) return;
sys = { default_view: data.options.default_view, board_cover: !!data.options.board_cover };
fillSys(sys);
} catch (err) {
if (seq !== openSeq) return;
setError("모든 사용자 설정을 불러오지 못했습니다(" + err.message + "). 폰트만 저장됩니다.");
}
if (!save.disabled) busy(false);
}
button.addEventListener("click", function () {
fill(current()); error.hidden = true; showPane(tabs[0].dataset.pane); dialog.showModal(); tabs[0].focus();
select.value = currentFont(); fillSys(SYS_DEFAULTS); paint(); setError("");
showPane(tabs[0].dataset.pane); dialog.showModal(); tabs[0].focus();
loadSys();
});
dialog.querySelector(".pj-options-nav").addEventListener("click", function (e) {
const t = e.target.closest("[role=tab]");
@@ -66,35 +92,47 @@
showPane(tabs[(i + (e.key === "ArrowDown" ? 1 : tabs.length - 1)) % tabs.length].dataset.pane, true);
});
select.addEventListener("change", paint);
reset.addEventListener("click", function () { fill(DEFAULTS); error.hidden = true; });
reset.addEventListener("click", function () {
select.value = FONT_DEFAULT; paint();
if (sys) fillSys(SYS_DEFAULTS);
});
cancel.addEventListener("click", close);
closeX.addEventListener("click", close);
dialog.addEventListener("cancel", function (e) { if (save.disabled) e.preventDefault(); });
dialog.addEventListener("close", function () { button.focus(); });
dialog.addEventListener("close", function () { openSeq++; button.focus(); });
form.addEventListener("submit", async function (e) {
e.preventDefault(); if (save.disabled) return;
const before = current();
const next = { font: select.value };
if (views) next.default_view = views.value;
if (cover) next.board_cover = cover.checked;
if (!Object.hasOwn(names, next.font) || (views && VIEWS.indexOf(next.default_view) < 0)) return;
const font = names[next.font];
busy(true); error.hidden = true;
const fontValue = select.value, font = names[fontValue];
if (!Object.hasOwn(names, fontValue)) return;
// 시스템 옵션은 바뀐 키만 보낸다(그대로면 서버에 쓰지 않음)
const sysChanges = {};
if (sys) {
if (views && VIEWS.indexOf(views.value) >= 0 && views.value !== sys.default_view) sysChanges.default_view = views.value;
if (cover && cover.checked !== sys.board_cover) sysChanges.board_cover = cover.checked;
}
busy(true); setError("");
try {
if (font && document.fonts) {
const loaded = await Promise.all([document.fonts.load('400 14px "' + font + '"', "가나다 Project"), document.fonts.load('700 14px "' + font + '"', "가나다 Project")]);
if (loaded.some(function (list) { return !list.length; })) throw new Error("폰트를 불러오지 못했습니다. 다시 시도해 주세요.");
}
localStorage.setItem("pj_font", next.font);
if (views) localStorage.setItem("pj_default_view", next.default_view);
if (cover) localStorage.setItem("pj_board_cover", next.board_cover ? "1" : "0");
document.documentElement.dataset.pjFont = next.font;
const changed = Object.keys(next).filter(function (k) { return next[k] !== before[k]; });
// project.js 가 듣는다 — 보드 표지가 바뀌면 지금 보드를 다시 그린다(첫 탭은 다음에 프로젝트를 열 때부터).
if (changed.length) window.dispatchEvent(new CustomEvent("pj-options-change", { detail: { options: next, changed: changed } }));
const changed = Object.keys(sysChanges);
if (changed.length) {
const data = await request("PUT", sysChanges);
sys = { default_view: data.options.default_view, board_cover: !!data.options.board_cover };
}
if (fontValue !== currentFont()) changed.push("font");
localStorage.setItem("pj_font", fontValue);
document.documentElement.dataset.pjFont = fontValue;
// project.js 가 듣는다 — 보드 표지가 바뀌면 보던 보드를 다시 그린다(다른 사용자는 다음에 화면을 열 때부터).
if (changed.length) {
window.dispatchEvent(new CustomEvent("pj-options-change", {
detail: { options: Object.assign({ font: fontValue }, sys || {}), changed: changed },
}));
}
window.dispatchEvent(new Event("resize"));
dialog.close();
} catch (err) { error.textContent = "설정을 저장하지 못했습니다. " + err.message; error.hidden = false; }
} catch (err) { setError("설정을 저장하지 못했습니다. " + err.message); }
finally { busy(false); }
});
})();
+7 -4
View File
@@ -554,6 +554,8 @@ html.pj-side-resizing, html.pj-side-resizing * { cursor: col-resize !important;
.pj-hovertip.is-below { transform: translate(-50%, 0); }
.pj-hovertip.is-below::after { top: auto; bottom: 100%; border-top-color: transparent; border-bottom-color: #1e1f21; }
.pj-hovertip[hidden] { display: none; }
/* 모달 대화창(showModal) 안의 말풍선은 popover(브라우저 맨 위 층)로 띄운다 — 브라우저 기본 popover 모양(가운데 배치·테두리·스크롤)을 지운다 */
.pj-hovertip[popover] { inset: auto; margin: 0; border: 0; overflow: visible; }
@keyframes pj-tip-in { from { opacity: 0; } to { opacity: 1; } }
/* ── 달력 (휴가 모듈과 동일한 월간 그리드 룩) ── */
@@ -3150,7 +3152,11 @@ html[data-pj-font="nanum-square-round"] { --pj-font: "NanumSquareRound", var(--p
.pj-options-nav button.is-active .material-symbols-outlined { color: var(--pj-accent); }
.pj-options-nav button:focus-visible { outline: 2px solid var(--pj-accent); outline-offset: -2px; }
.pj-options-panes { flex: 1; min-width: 0; padding: 20px 24px; overflow-y: auto; }
.pj-options-pane h3 { margin: 0 0 14px; font-size: 15px; font-weight: 600; }
.pj-options-pane h3 { display: flex; align-items: center; gap: 10px; margin: 0 0 14px; font-size: 15px; font-weight: 600; }
/* 설정이 어디에 적용되나 — 이 브라우저(회색) · 모든 사용자(보라) */
.pj-options-badge { display: inline-flex; align-items: center; gap: 4px; padding: 2px 8px 2px 6px; border-radius: 999px; background: #f1f2f4; color: #5f6368; font-size: 11.5px; font-weight: 500; }
.pj-options-badge .material-symbols-outlined { font-size: 15px; }
.pj-options-badge.is-global { background: var(--pj-accent-tint); color: var(--pj-accent-dark); }
.pj-options-group { border: 1px solid var(--pj-border); border-radius: 8px; }
.pj-options-row { display: flex; align-items: center; justify-content: space-between; gap: 16px; padding: 14px 16px; }
.pj-options-row + .pj-options-row { border-top: 1px solid var(--pj-border); }
@@ -3181,15 +3187,12 @@ label.pj-options-row[for] { cursor: pointer; }
.pj-switch input:disabled + span { opacity: .5; }
.pj-options-foot { display: flex; align-items: center; gap: 8px; padding: 12px 16px; border-top: 1px solid var(--pj-border); background: #fafbfc; }
.pj-options-foot .pj-options-reset { margin-right: auto; }
.pj-options-scope { font-size: 12px; color: var(--pj-ink-soft); margin-right: 6px; }
.pj-options-dialog .pj-options-error { margin: 0 6px 0 0; font-size: 12px; color: #c22b10; }
.pj-options-error:not([hidden]) + .pj-options-scope { display: none; }
@media (max-width: 560px) {
.pj-options-body { flex-direction: column; min-height: 0; overflow-y: auto; }
.pj-options-nav { flex: none; flex-direction: row; overflow-x: auto; border-right: 0; border-bottom: 1px solid var(--pj-border); }
.pj-options-nav button { white-space: nowrap; }
.pj-options-views { grid-template-columns: repeat(3, 1fr); }
.pj-options-scope { display: none; }
}
.pj-goal-format { position: fixed; z-index: 1200; display: flex; align-items: center; flex-wrap: wrap; gap: 6px; padding: 4px 6px; max-width: calc(100vw - 16px); box-sizing: border-box; border: 1px solid var(--pj-border); border-radius: 8px; box-shadow: 0 4px 16px #0002; background: #fff; color: var(--pj-ink); font-family: var(--pj-font); font-size: 12px; }
.pj-goal-format[hidden], .pj-goal-color-grid[hidden] { display: none; }
+36 -16
View File
@@ -937,10 +937,6 @@
coverCache.set(s, src);
return src;
}
// Project 옵션 "카드 표지 이미지"(project-options.js) — "0" 일 때만 끔, 기본은 켬
function boardCoverOn() {
try { return localStorage.getItem("pj_board_cover") !== "0"; } catch (_) { return true; }
}
function hasDescription(html) {
const s = String(html || "");
if (/<img\b/i.test(s)) return true;
@@ -3420,10 +3416,12 @@
const projectId = parseInt(root.dataset.projectId, 10);
const canManage = root.dataset.canManage === "true";
// 등급(2026-10-12) — isPro = Pro user 이상(프로젝트 수정·멤버 배정·전체 보기·담당자별 합계·남의 댓글 수정),
// isPAdmin = Admin 이상(남이 만든 섹션도 삭제, Project 옵션의 처음 여는 탭·보드 카드 표지 —
// 그 밖은 브라우저에 남은 값과 무관하게 기본값: 보드·표지 켬).
// isPAdmin = Admin 이상(남이 만든 섹션도 삭제).
const isPro = root.dataset.isPro === "true";
const isPAdmin = root.dataset.isPadmin === "true";
// 시스템 Project 옵션(서버 project_options, 수퍼관리자·Admin 이 바꾸면 모든 사용자에게) — 보드 카드 표지 켬/끔.
// 옵션 창에서 저장하면 pj-options-change 로 바로 바뀐다(아래).
let boardCover = root.dataset.boardCover !== "0";
const me = (root.dataset.me || "").toLowerCase();
// 섹션 삭제 — Admin 이상은 누구 것이든, 그 밖은 만든 사람만. created_by 없으면 서버가 최종 판정.
function canDelete(createdBy) {
@@ -3580,7 +3578,7 @@
}
let timeline = null;
// 기본 보기는 Project 옵션의 "처음 여는 탭"(pj_default_view, 없으면 보드) —
// 기본 보기는 시스템 Project 옵션의 "처음 여는 탭"(서버 project_options → data-default-view, 없으면 보드) —
// 왼쪽 프로젝트 클릭 등으로 들어오면 그 탭.
// 예외: 달력 이전/다음달 이동은 페이지를 통째로 새로고침하므로(?y=&m=),
// 그때만 마지막으로 보던 뷰를 되살린다 — 안 그러면 달력을 넘기다가
@@ -3592,10 +3590,10 @@
try {
const qs = new URLSearchParams(location.search);
const saved = localStorage.getItem(VIEW_KEY);
const preferred = localStorage.getItem("pj_default_view");
const preferred = root.dataset.defaultView; // 시스템 옵션(서버가 넣어 줌)
if ((qs.has("y") || qs.has("m")) && saved && VIEWS.indexOf(saved) >= 0) currentView = saved;
else if (isPro && qs.get("scope") === "all") currentView = "dashboard";
else if (isPAdmin && qs.get("embed") !== "1" && VIEWS.indexOf(preferred) >= 0) currentView = preferred; // 업무 창 패널(iframe)은 그대로 보드
else if (qs.get("embed") !== "1" && VIEWS.indexOf(preferred) >= 0) currentView = preferred; // 업무 창 패널(iframe)은 그대로 보드
} catch (_) {}
// ── 프로젝트 스코프 — 아사나처럼 기본은 "이 프로젝트만", "전체 프로젝트"로
@@ -3714,10 +3712,13 @@
if (!btn) return;
selectView(btn.dataset.view);
});
// Project 옵션 저장 — 보드 표지 켜기/끄기는 보고 있는 보드에 바로 반영
// Project 옵션 저장 — 보드 표지 켜기/끄기는 보고 있는 보드에 바로 반영(다른 사용자는 다음에 화면을 열 때)
window.addEventListener("pj-options-change", function (e) {
const changed = (e.detail && e.detail.changed) || [];
if (changed.indexOf("board_cover") >= 0 && currentView === "board") renderBoard();
const d = e.detail || {}, changed = d.changed || [], opts = d.options || {};
if (typeof opts.default_view === "string") root.dataset.defaultView = opts.default_view;
if (changed.indexOf("board_cover") < 0 || typeof opts.board_cover !== "boolean") return;
boardCover = opts.board_cover;
if (currentView === "board") renderBoard();
});
// 서버가 그린 기본 탭(보드)과 기억된 탭이 다르면 화면을 맞춰준다.
if (currentView !== "board") {
@@ -5949,7 +5950,7 @@
// 카드 윗부분(배지·제목·담당자/마감일/세부 작업 줄)은 .pj-card-head 로 묶는다 —
// 세부 작업을 펼쳐 컬럼을 스크롤하면 이 부분이 컬럼 맨 위에 고정된다(CSS sticky).
// 설명에 이미지가 있으면 첫 이미지를 카드 위에(아사나 카드 표지) — Project 옵션 "카드 표지 이미지"로 끌 수 있다
const cover = !isPAdmin || boardCoverOn() ? cardCoverSrc(t.description) : "";
const cover = boardCover ? cardCoverSrc(t.description) : "";
card.classList.toggle("has-cover", !!cover);
card.innerHTML =
(cover ? '<div class="pj-card-cover"><img src="' + escapeHtml(cover) + '" alt="" loading="lazy" draggable="false"></div>' : "") +
@@ -9818,7 +9819,25 @@
function initHoverTips() {
let tipEl = null;
let shown = false;
function show(text, x, y) {
// 모달 대화창(dialog.showModal — Project 옵션 등)은 브라우저 맨 위 층(top layer)에 떠서 body 의 말풍선이
// z-index 와 상관없이 그 뒤에 가려진다. 그 안에서는 말풍선을 popover 로 띄워 같은 층, 대화창보다 위에 둔다.
function inModal(target) {
const dlg = target.closest("dialog[open]");
if (!dlg) return false;
try { return dlg.matches(":modal"); } catch (_) { return true; }
}
function topLayer(on) {
if (typeof tipEl.showPopover !== "function") return; // popover 미지원 브라우저 — 예전처럼
const open = tipEl.hasAttribute("popover") && tipEl.matches(":popover-open");
if (on) {
if (!tipEl.hasAttribute("popover")) tipEl.setAttribute("popover", "manual");
if (!open) tipEl.showPopover();
} else if (tipEl.hasAttribute("popover")) {
if (open) tipEl.hidePopover();
tipEl.removeAttribute("popover");
}
}
function show(text, x, y, modal) {
if (!tipEl) {
tipEl = document.createElement("div");
tipEl.className = "pj-hovertip";
@@ -9826,6 +9845,7 @@
}
tipEl.textContent = text;
tipEl.hidden = false;
topLayer(!!modal);
// 화면 가장자리 보정 — 좌우로 넘치면 말풍선만 안쪽으로 밀고 꼬리는
// 커서를 계속 가리키게(--pj-tip-shift).
// 늘 커서 **위**에 — 마우스 화살표(핫스팟에서 아래로 약 20px)에 가려지지 않게. 화면 맨 위(회의록 머리 버튼 등)라
@@ -9842,7 +9862,7 @@
tipEl.style.left = cx + "px";
tipEl.style.top = (below ? y + 28 : roomy ? y - 10 : y - 2) + "px";
}
function hide() { shown = false; if (tipEl) tipEl.hidden = true; }
function hide() { shown = false; if (tipEl) { topLayer(false); tipEl.hidden = true; } }
document.addEventListener("mouseover", function (e) {
const el = e.target.closest ? e.target.closest("[title]") : null;
if (!el) return;
@@ -9854,7 +9874,7 @@
const target = e.target.closest ? e.target.closest("[data-tip]") : null;
if (!target || !target.dataset.tip) { if (shown) hide(); return; }
shown = true;
show(target.dataset.tip, e.clientX, e.clientY);
show(target.dataset.tip, e.clientX, e.clientY, inModal(target));
});
// 누르거나 스크롤하면 숨긴다 — 클릭으로 요소가 다시 그려지면 말풍선만
// 허공에 남는 일이 없게.
+14
View File
@@ -150,6 +150,20 @@ docker exec postgres-db psql -U postgres -d project_db -c "SELECT COUNT(*) FROM
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db < scripts/sql/project_db_028_followers_exclude_assignee.sql
```
## Project 옵션(시스템 전체 설정) 마이그레이션 (029)
029는 `project_options` 테이블만 추가한다(키 하나 = 행 하나, 기존 값 변경 없음, 다시 실행 가능). 수퍼관리자·Admin 이 Project 옵션 창에서
바꾸는 "처음 여는 탭"·"보드 카드 표지"를 모든 사용자에게 적용하는 저장소다. 행이 없으면 기본값(보드·표지 켬).
미적용이면 화면은 기본값으로 열리고, 옵션 저장만 503 안내(폰트는 브라우저 저장이라 그대로 동작).
되돌리기 = `DROP TABLE project_options;`(사용자 확인 후 — 저장한 시스템 설정만 사라지고 기본값으로).
```bash
cd /opt/www/main
docker exec postgres-db pg_dump -U postgres project_db > ~/project_db_before_029_$(date +%Y%m%d%H%M).sql
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d project_db < scripts/sql/project_db_029_project_options.sql
docker exec postgres-db psql -U postgres -d project_db -c "SELECT key, value, updated_by, updated_at FROM project_options;"
```
## 실적 수동 입력·열 순서 마이그레이션 (performance_db 002)
002는 `perf_marketplaces.manual_input` 열(기본 꺼짐) + `perf_manual_sales` 표를 추가하고, 쇼핑몰 순서(`sort_order`)를
+15 -9
View File
@@ -25,15 +25,21 @@
`project.css`의 `--pj-font`만 변경하므로 다른 ERP 화면은 영향을 받지 않으며 아이콘·코드 고정폭 폰트는 유지한다.
폰트는 `static/vendor/project-fonts/`에 원본·저작권/OFL을 함께 보관하고 `project-fonts.css`에서 선언한다(외부 CDN 없음).
저장 시 400/700 글꼴 로딩을 확인하고, 실패하면 이전 설정과 열린 창을 유지해 재시도할 수 있다.
2026-10-16 설정 창 개편 — 왼쪽 분류(일반·프로젝트 화면·보드·관리자[수퍼관리자만]) | 오른쪽 설정, 아래 [기본값으로]·취소·저장(한꺼번에 저장).
모두 이 브라우저 localStorage: `pj_font` · `pj_default_view`(왼쪽에서 프로젝트를 열 때 첫 탭 board/list/calendar/timeline/dashboard,
없거나 이상한 값 = 보드. 달력 월 이동 `?y=&m=` 은 마지막 뷰 `pj_view` 복원, `?scope=all` 은 대시보드, `?embed=1` 은 보드 그대로) ·
`pj_board_cover`(`"0"` 이면 보드 카드 표지 이미지 끔, 기본 켬 — `project.js` `boardCoverOn()`).
저장하면 바뀐 키를 `pj-options-change` 이벤트로 알리고, 보드를 보고 있으면 표지 변경을 바로 다시 그린다. 새 옵션도 이 창의 분류·패널로 추가한다.
보이는 범위 — **일반(폰트)만 모두에게, 프로젝트 화면·보드는 수퍼관리자·Admin**(템플릿 `pj_admin` = `access.is_project_admin`),
**관리자(긴급 공지)는 수퍼관리자만**(`user.is_super_admin` — 공지 화면이 수퍼관리자 전용).
Admin 미만(Pro user·User)이면 `project.js` 가 브라우저에 남은 `pj_default_view`·`pj_board_cover` 를 무시하고 기본값(보드·표지 켬)으로 동작한다(`isPAdmin`, `data-is-padmin`).
테스트 렌더: `project_admin_render.html`(Admin)·`project_super_render.html`(수퍼관리자)(render_project.py).
2026-10-16 설정 창 개편 — 왼쪽 분류(일반·프로젝트 화면·보드·관리자) | 오른쪽 설정, 아래 [기본값으로]·취소·저장(한꺼번에 저장).
- **일반(폰트)** — 모두에게 보이고 **이 브라우저에만** 저장(`localStorage.pj_font`).
- **프로젝트 화면·보드** — 수퍼관리자·Admin(템플릿 `pj_admin` = `access.is_project_admin`)에게만 보이고, **서버에 저장해 모든 사용자에게 적용**
(`project_db.project_options`, 마이그레이션 029, 키 하나 = 행 하나, 값 JSONB). 키: `default_view`(왼쪽에서 프로젝트를 열 때 첫 탭
board/list/calendar/timeline/dashboard, 기본 board) · `board_cover`(보드 카드 표지 = 설명의 첫 이미지, 기본 켬).
허용 키·값·기본값은 `store.PROJECT_OPTION_DEFAULTS`·`normalize_project_options`(읽기 — 이상한 값은 기본값)·`validate_project_options`(쓰기 — 400) 한 곳.
API: `GET /project/api/options`(모듈 권한자 누구나, `can_edit`) · `PUT /project/api/options`(Admin 이상, 보낸 키만, 029 미적용 503).
프로젝트 화면(`/project/p/{id}`)은 서버가 `pj_options` → 루트 `data-default-view`·`data-board-cover` 로 넣고 `project.js` 가 쓴다
(읽기 실패·029 미적용이면 기본값 — 화면은 늘 열린다). 달력 월 이동 `?y=&m=` 은 마지막 뷰 `pj_view` 복원, `?scope=all` 은 대시보드, `?embed=1` 은 보드 그대로.
창은 열 때 서버 최신값을 읽고(못 읽으면 시스템 칸 잠금·폰트만 저장), 저장은 바뀐 키만 PUT → 성공해야 폰트도 적용(실패 시 창 유지·사유 표시).
저장하면 `pj-options-change` 이벤트로 보던 보드에 바로 반영, 다른 사용자는 다음에 화면을 열 때부터.
- **관리자(긴급 공지)** — 수퍼관리자만(`user.is_super_admin` — 공지 화면이 수퍼관리자 전용).
- 각 분류 제목 옆 배지로 적용 범위 표시(이 브라우저에만 / 모든 사용자에게). 새 옵션도 이 창의 분류·패널로 추가한다.
- 모달 대화창(`showModal`) 안의 말풍선은 공용 말풍선이 popover(top layer)로 띄운다(`initHoverTips` — 안 그러면 대화창 뒤에 가려짐).
테스트: `tests/test_project_options_api.py`, jsdom `project_ui.test.js`(렌더 `project_admin_render.html`·`project_super_render.html`).
**멤버 이름 표기** — 이메일 아이디의 첫 글자만 대문자(king → King). JS 는 `idOf(email)`/`capName(s)`,
템플릿은 `{{ nm[:1]|upper }}{{ nm[1:] }}` 로 화면에 그릴 때만 바꾼다(API `id`·DB 값은 그대로 — 멘션·검색은 이메일 기준).
**프로젝트 색상·아이콘(아사나식)** — 색상표는 32색(`store.COLOR_PALETTE`, 8칸×4줄 — 위 2줄은 아사나 프로젝트 16색, 아래 2줄은 같은 열의 진한 색. 진한 칸은 체크를 흰색 `.is-dark`. 새 프로젝트
@@ -0,0 +1,23 @@
-- =====================================================================
-- project_db 마이그레이션 029 — Project 옵션(시스템 전체 설정)
-- =====================================================================
-- 멱등(idempotent). 테이블만 추가한다(기존 값 변경·삭제 없음). 운영: /opt/www/main 에서 기존 project_db 에 적용.
--
-- 왜(2026-10-16 사용자 요청): Project 옵션 창에서 "일반"(폰트)은 브라우저별(localStorage) 그대로 두고,
-- 수퍼관리자·Admin 이 바꾸는 "프로젝트 화면"(처음 여는 탭)·"보드"(카드 표지 이미지)는 모든 사용자에게 반영한다.
-- 키 하나 = 설정 하나(값은 JSONB). 허용 키·값 검사와 기본값은 앱(store.normalize_project_options) 한 곳에서 한다.
-- 행이 없으면 기본값(처음 여는 탭 = 보드, 카드 표지 = 켬) — 이 파일은 기본 행을 넣지 않는다.
-- 미적용이면: 화면은 기본값으로 동작하고, 옵션 저장만 503 안내.
-- 되돌리기: DROP TABLE project_options; (사용자 확인 후 — 저장한 시스템 설정만 사라지고 기본값으로 돌아감)
-- =====================================================================
BEGIN;
CREATE TABLE IF NOT EXISTS project_options (
key TEXT PRIMARY KEY CHECK (char_length(key) BETWEEN 1 AND 64),
value JSONB NOT NULL,
updated_by TEXT NOT NULL DEFAULT '',
updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
);
COMMENT ON TABLE project_options IS 'Project 옵션 — 시스템 전체 설정(수퍼관리자·Admin 수정, 모든 사용자에게 적용). 키: default_view, board_cover';
COMMIT;
+84 -49
View File
@@ -539,82 +539,117 @@ function titleVal(d) { return d.getElementById("pj-t-title").value; }
check("[옵션] 폰트 로딩 실패는 이전 설정 유지·재시도 가능", dialog.open && !d.getElementById("pj-options-error").hidden && !select.disabled && w.localStorage.getItem("pj_font") === "pretendard");
}
// 옵션(수퍼관리자 — Admin 도 같은 분류, 관리자 분류만 추가) — 분류 탭, 보드 카드 표지 켜기/끄기(보던 보드에 바로), 처음 여는 탭, 기본값으로.
{
const env = makeEnv(superHtml); baseRoutes(env); const d = env.d, w = env.w;
// 옵션 — 일반(폰트)은 이 브라우저, 프로젝트 화면·보드는 서버(시스템 전체, 수퍼관리자·Admin 만 수정).
// 가짜 서버: GET/PUT /project/api/options. 화면 값은 project.html 이 data-default-view·data-board-cover 로 넣는다.
function optionRoutes(env, state) {
env.route("GET", /\/project\/api\/options$/, function () {
if (state.getFail) return { status: 500, body: { detail: "DB 오류" } };
return { body: { options: Object.assign({}, state.options), can_edit: true } };
});
env.route("PUT", /\/project\/api\/options$/, function (url, body) {
if (state.putFail) return { status: 503, body: { detail: "DB 마이그레이션 029(Project 옵션)가 아직 적용되지 않았습니다." } };
Object.assign(state.options, body);
return { body: { options: Object.assign({}, state.options) } };
});
}
function withCover(d) {
const seed = JSON.parse(d.getElementById("pj-data").textContent);
seed.tasks.find(function (t) { return t.id === 101; }).description = '<p>표지</p><img src="/project/attachments/1/a.png">';
d.getElementById("pj-data").textContent = JSON.stringify(seed);
await boot(env);
}
function pageOptions(d, view, coverOn) {
const root = d.querySelector(".pj-project-view");
root.dataset.defaultView = view; root.dataset.boardCover = coverOn ? "1" : "0";
}
const optCalls = function (env, method) { return env.calls.filter(function (c) { return c.method === method && /\/project\/api\/options$/.test(c.url); }); };
// 수퍼관리자 — 분류 탭, 서버 값 불러오기, 표지 끄기(보던 보드에 바로)·첫 탭 저장, 바뀐 키만 PUT, 기본값으로, 실패 처리.
{
const env = makeEnv(superHtml); baseRoutes(env); const d = env.d, w = env.w;
const state = { options: { default_view: "board", board_cover: true } }; optionRoutes(env, state);
withCover(d); await boot(env);
const dialog = d.getElementById("pj-options-dialog"), cover = d.getElementById("pj-options-cover");
const coverImg = function () { return d.querySelector('.pj-card[data-task-id="101"] .pj-card-cover img'); };
const pane = function (n) { return d.querySelector('.pj-options-pane[data-pane="' + n + '"]'); };
const checkedView = function () { return dialog.querySelector('input[name="default_view"]:checked').value; };
check("[옵션 표지] 기본은 설명 첫 이미지를 카드 표지로", !!coverImg() && coverImg().getAttribute("src") === "/project/attachments/1/a.png");
d.getElementById("pj-options-btn").click();
check("[옵션] 열면 첫 분류(일반)만 보임·표지 켜짐·첫 탭 보드", dialog.open && !pane("general").hidden && pane("board").hidden && cover.checked && dialog.querySelector('input[name="default_view"]:checked').value === "board");
state.options = { default_view: "calendar", board_cover: true }; // 다른 관리자가 그 사이 바꿈 — 창은 서버 최신값
d.getElementById("pj-options-btn").click(); await settle();
check("[옵션] 열면 일반 분류부터·서버 값(캘린더) 불러옴", dialog.open && !pane("general").hidden && pane("board").hidden && optCalls(env, "GET").length === 1 && cover.checked && checkedView() === "calendar" && !cover.disabled);
check("[옵션] 적용 범위 표시 — 일반=이 브라우저, 보드=모든 사용자", /이 브라우저/.test(pane("general").querySelector(".pj-options-badge").textContent) && /모든 사용자/.test(pane("board").querySelector(".pj-options-badge.is-global").textContent));
d.getElementById("pj-opt-tab-board").click();
check("[옵션] 분류 탭 전환", pane("general").hidden && !pane("board").hidden && d.getElementById("pj-opt-tab-board").getAttribute("aria-selected") === "true");
cover.checked = false; dialog.querySelector('input[name="default_view"][value="list"]').checked = true;
d.getElementById("pj-options-cancel").click();
check("[옵션] 취소는 표지·첫 탭을 저장하지 않음", !w.localStorage.getItem("pj_board_cover") && !w.localStorage.getItem("pj_default_view") && !!coverImg());
d.getElementById("pj-options-btn").click();
check("[옵션] 다시 열면 일반 분류부터·취소한 값은 되돌림", !pane("general").hidden && cover.checked);
d.getElementById("pj-options-cancel").click(); await settle();
check("[옵션] 취소는 서버에 저장하지 않음", !dialog.open && optCalls(env, "PUT").length === 0 && !!coverImg());
d.getElementById("pj-options-btn").click(); await settle();
check("[옵션] 다시 열면 취소한 값은 되돌림", cover.checked && checkedView() === "calendar");
cover.checked = false; dialog.querySelector('input[name="default_view"][value="timeline"]').checked = true;
d.getElementById("pj-options-save").click(); await settle();
check("[옵션 표지] 끄고 저장하면 보던 보드에서 표지가 바로 사라짐", !dialog.open && w.localStorage.getItem("pj_board_cover") === "0" && !coverImg() && !d.querySelector('.pj-card[data-task-id="101"]').classList.contains("has-cover"));
check("[옵션 첫 탭] 저장해도 지금 보던 탭은 그대로", w.localStorage.getItem("pj_default_view") === "timeline" && !d.querySelector('.pj-view[data-view="board"]').hidden);
d.getElementById("pj-options-btn").click(); d.getElementById("pj-options-reset").click();
check("[옵션] 기본값으로 — 창 안의 값만 처음으로(저장 전)", cover.checked && dialog.querySelector('input[name="default_view"]:checked').value === "board" && d.getElementById("pj-options-font").value === "system" && w.localStorage.getItem("pj_board_cover") === "0");
const put = optCalls(env, "PUT")[0];
check("[옵션 시스템] 저장은 바뀐 키만 서버로(PUT)", !dialog.open && optCalls(env, "PUT").length === 1 && JSON.stringify(put.body) === JSON.stringify({ default_view: "timeline", board_cover: false }));
check("[옵션 시스템] 브라우저(localStorage)에는 시스템 옵션을 쓰지 않음", !w.localStorage.getItem("pj_board_cover") && !w.localStorage.getItem("pj_default_view"));
check("[옵션 표지] 끄고 저장하면 보던 보드에서 표지가 바로 사라짐", !coverImg() && !d.querySelector('.pj-card[data-task-id="101"]').classList.contains("has-cover"));
check("[옵션 첫 탭] 저장해도 지금 보던 탭은 그대로", !d.querySelector('.pj-view[data-view="board"]').hidden);
d.getElementById("pj-options-btn").click(); await settle(); d.getElementById("pj-options-font").value = "pretendard";
d.getElementById("pj-options-save").click(); await settle();
check("[옵션 표지] 다시 켜면 표지 복귀", w.localStorage.getItem("pj_board_cover") === "1" && !!coverImg());
check("[옵션] 폰트만 바꾸면 서버에 쓰지 않음", optCalls(env, "PUT").length === 1 && w.localStorage.getItem("pj_font") === "pretendard");
d.getElementById("pj-options-btn").click(); await settle(); d.getElementById("pj-options-reset").click();
check("[옵션] 기본값으로 — 창 안의 값만 처음으로(저장 전)", cover.checked && checkedView() === "board" && d.getElementById("pj-options-font").value === "system" && optCalls(env, "PUT").length === 1);
d.getElementById("pj-options-save").click(); await settle();
check("[옵션 표지] 다시 켜면 표지 복귀", JSON.stringify(optCalls(env, "PUT")[1].body) === JSON.stringify({ default_view: "board", board_cover: true }) && !!coverImg() && w.localStorage.getItem("pj_font") === "system");
// 서버 저장 실패(029 미적용 등) — 창 유지·오류 안내, 폰트도 적용하지 않음(전부 아니면 전무)
state.putFail = true;
d.getElementById("pj-options-btn").click(); await settle();
cover.checked = false; d.getElementById("pj-options-font").value = "nanum-square";
d.getElementById("pj-options-save").click(); await settle();
check("[옵션 시스템] 저장 실패 — 창 유지·사유 표시·폰트 미적용·다시 시도 가능", dialog.open && /029/.test(d.getElementById("pj-options-error").textContent) && !d.getElementById("pj-options-error").hidden &&
w.localStorage.getItem("pj_font") === "system" && !!coverImg() && !cover.disabled && !d.getElementById("pj-options-save").disabled);
d.getElementById("pj-options-cancel").click();
// 서버 값 읽기 실패 — 시스템 칸 잠금, 폰트는 저장됨, PUT 없음
state.getFail = true; state.putFail = false;
d.getElementById("pj-options-btn").click(); await settle();
check("[옵션 시스템] 불러오기 실패 — 시스템 칸 잠금·안내", cover.disabled && /폰트만 저장/.test(d.getElementById("pj-options-error").textContent));
const putsBefore = optCalls(env, "PUT").length; // 위의 실패한 PUT 도 기록에 있다
d.getElementById("pj-options-font").value = "nanum-square"; d.getElementById("pj-options-save").click(); await settle();
check("[옵션 시스템] 불러오기 실패해도 폰트는 저장, 서버엔 쓰지 않음", !dialog.open && w.localStorage.getItem("pj_font") === "nanum-square" && optCalls(env, "PUT").length === putsBefore);
}
// 시스템 첫 탭(서버 값) — 누구든 그 탭으로 시작, 이상한 값은 보드
{
const env = makeEnv(); baseRoutes(env); const d = env.d;
pageOptions(d, "list", true); await boot(env);
check("[옵션 첫 탭] 일반 사용자도 시스템 첫 탭(목록)으로 시작", !d.querySelector('.pj-view[data-view="list"]').hidden && d.querySelector('.pj-view[data-view="board"]').hidden && d.querySelector('#pj-view-tabs .pj-tab.is-active').dataset.view === "list");
}
{
const env = makeEnv(superHtml); baseRoutes(env); const d = env.d;
env.w.localStorage.setItem("pj_default_view", "list"); env.w.localStorage.setItem("pj_board_cover", "0");
await boot(env);
check("[옵션 첫 탭] 프로젝트를 열면 고른 탭(목록)으로 시작", !d.querySelector('.pj-view[data-view="list"]').hidden && d.querySelector('.pj-view[data-view="board"]').hidden && d.querySelector('#pj-view-tabs .pj-tab.is-active').dataset.view === "list");
}
{
const env = makeEnv(superHtml); baseRoutes(env); const d = env.d;
env.w.localStorage.setItem("pj_default_view", "garbage");
await boot(env);
pageOptions(d, "garbage", true); await boot(env);
check("[옵션 첫 탭] 이상한 값이면 보드", !d.querySelector('.pj-view[data-view="board"]').hidden);
}
// 옵션(Admin) — 프로젝트 화면·보드는 보이고 적용됨, 관리자(긴급 공지)는 수퍼관리자만이라 없음.
// Admin — 프로젝트 화면·보드는 보이고 수정 가능, 관리자(긴급 공지)는 수퍼관리자만이라 없음.
{
const env = makeEnv(adminHtml); baseRoutes(env); const d = env.d, w = env.w;
const seed = JSON.parse(d.getElementById("pj-data").textContent);
seed.tasks.find(function (t) { return t.id === 101; }).description = '<p>표지</p><img src="/project/attachments/1/a.png">';
d.getElementById("pj-data").textContent = JSON.stringify(seed);
w.localStorage.setItem("pj_default_view", "list"); w.localStorage.setItem("pj_board_cover", "0");
const env = makeEnv(adminHtml); baseRoutes(env); const d = env.d;
const state = { options: { default_view: "board", board_cover: false } }; optionRoutes(env, state);
await boot(env);
check("[옵션 Admin] 고른 첫 탭(목록)으로 시작", !d.querySelector('.pj-view[data-view="list"]').hidden && d.querySelector('.pj-view[data-view="board"]').hidden);
d.getElementById("pj-options-btn").click();
check("[옵션 Admin] 일반·프로젝트 화면·보드 분류, 관리자 분류는 없음",
d.getElementById("pj-options-btn").click(); await settle();
check("[옵션 Admin] 일반·프로젝트 화면·보드 분류, 관리자 분류는 없음, 서버 값 표시",
Array.from(d.querySelectorAll("#pj-options-dialog .pj-options-nav [role=tab]")).map(function (t) { return t.dataset.pane; }).join(",") === "general,view,board" &&
!d.getElementById("pj-opt-pane-admin") && !d.getElementById("pj-options-cover").checked);
d.getElementById("pj-options-cancel").click();
d.querySelector('#pj-view-tabs .pj-tab[data-view="board"]').click(); await settle();
check("[옵션 Admin] 표지 끔 값 적용 — 보드 카드에 표지 없음", !d.querySelector('.pj-view[data-view="board"]').hidden && !!d.querySelector('.pj-card[data-task-id="101"]') && !d.querySelector('.pj-card[data-task-id="101"] .pj-card-cover'));
!d.getElementById("pj-opt-pane-admin") && !d.getElementById("pj-options-cover").checked && !d.getElementById("pj-options-cover").disabled);
d.getElementById("pj-options-cover").checked = true; d.getElementById("pj-options-save").click(); await settle();
check("[옵션 Admin] 저장하면 서버로", JSON.stringify((optCalls(env, "PUT")[0] || {}).body) === JSON.stringify({ board_cover: true }));
}
// 옵션(일반 사용자) — 폰트만 보이고, 브라우저에 남은 첫 탭·표지 값은 무시(기본값: 보드·표지 켬).
// 일반 사용자 — 폰트만 보이고 서버 옵션은 읽지도 쓰지도 않음, 시스템 표지 끔은 그대로 적용.
{
const env = makeEnv(); baseRoutes(env); const d = env.d, w = env.w;
const seed = JSON.parse(d.getElementById("pj-data").textContent);
seed.tasks.find(function (t) { return t.id === 101; }).description = '<p>표지</p><img src="/project/attachments/1/a.png">';
d.getElementById("pj-data").textContent = JSON.stringify(seed);
w.localStorage.setItem("pj_default_view", "list"); w.localStorage.setItem("pj_board_cover", "0");
await boot(env);
optionRoutes(env, { options: { default_view: "board", board_cover: true } });
withCover(d); pageOptions(d, "board", false); await boot(env);
const dialog = d.getElementById("pj-options-dialog");
check("[옵션 일반 사용자] 남은 첫 탭 값 무시 — 보드로 시작", !d.querySelector('.pj-view[data-view="board"]').hidden && d.querySelector('.pj-view[data-view="list"]').hidden);
check("[옵션 일반 사용자] 남은 표지 끔 값 무시 — 표지 보임", !!d.querySelector('.pj-card[data-task-id="101"] .pj-card-cover img'));
d.getElementById("pj-options-btn").click();
check("[옵션 일반 사용자] 분류는 일반(폰트)만", dialog.open && dialog.querySelectorAll(".pj-options-nav [role=tab]").length === 1 &&
dialog.querySelectorAll(".pj-options-pane").length === 1 && !d.getElementById("pj-options-cover") && !dialog.querySelector('input[name="default_view"]') && !d.getElementById("pj-opt-pane-admin"));
check("[옵션 일반 사용자] 시스템 표지 끔이 적용 — 표지 없음", !!d.querySelector('.pj-card[data-task-id="101"]') && !d.querySelector('.pj-card[data-task-id="101"] .pj-card-cover'));
d.getElementById("pj-options-btn").click(); await settle();
check("[옵션 일반 사용자] 분류는 일반(폰트)만·서버 옵션 안 읽음", dialog.open && dialog.querySelectorAll(".pj-options-nav [role=tab]").length === 1 &&
dialog.querySelectorAll(".pj-options-pane").length === 1 && !d.getElementById("pj-options-cover") && !dialog.querySelector('input[name="default_view"]') && !d.getElementById("pj-opt-pane-admin") && optCalls(env, "GET").length === 0);
d.getElementById("pj-options-reset").click(); d.getElementById("pj-options-font").value = "pretendard";
d.getElementById("pj-options-save").click(); await settle();
check("[옵션 일반 사용자] 폰트만 저장 — 다른 키는 건드리지 않음", !dialog.open && w.localStorage.getItem("pj_font") === "pretendard" &&
w.localStorage.getItem("pj_default_view") === "list" && w.localStorage.getItem("pj_board_cover") === "0");
check("[옵션 일반 사용자] 폰트만 이 브라우저에 저장 — 서버엔 안 씀", !dialog.open && w.localStorage.getItem("pj_font") === "pretendard" && optCalls(env, "PUT").length === 0);
}
// 카드 완료 체크 — 상세창과 분리, 중복 요청·실패 복구·읽기 전용.
+113
View File
@@ -0,0 +1,113 @@
"""Project 옵션(시스템 전체 — 처음 여는 탭·보드 카드 표지) API·검사. DB 없이 가짜 저장소로.
일반(폰트)은 브라우저 localStorage 라 서버에 없다. 수퍼관리자·Admin 만 저장, 읽기는 모듈 권한자 누구나.
"""
import importlib
import unittest
from unittest.mock import patch
from fastapi import FastAPI
from fastapi.testclient import TestClient
from psycopg.errors import UndefinedTable
api = importlib.import_module("app.modules.project.router")
store = importlib.import_module("app.modules.project.store")
ADMIN = {"email": "Boss@Test.local", "role": "admin"}
USER = {"email": "me@test.local", "role": "user"}
PRO = {"email": "pro@test.local", "role": "pro"}
class FakeStore:
def __init__(self, saved=None, *, missing=False, broken=False):
self.saved = dict(saved or {})
self.missing = missing # 029 미적용
self.broken = broken # 읽기 자체가 실패(연결 끊김 등)
self.writes = []
def get_project_options(self):
if self.broken:
raise RuntimeError("db down")
return {} if self.missing else dict(self.saved)
def set_project_options(self, *, values, updated_by):
if self.missing:
raise UndefinedTable("project_options")
self.writes.append((dict(values), updated_by))
self.saved.update(values)
class NormalizeTests(unittest.TestCase):
def test_defaults_when_nothing_saved(self):
self.assertEqual(store.normalize_project_options(None), {"default_view": "board", "board_cover": True})
self.assertEqual(store.normalize_project_options({}), {"default_view": "board", "board_cover": True})
def test_bad_or_unknown_saved_values_fall_back(self):
out = store.normalize_project_options({"default_view": "gantt", "board_cover": "no", "x": 1})
self.assertEqual(out, {"default_view": "board", "board_cover": True})
def test_saved_values_used(self):
out = store.normalize_project_options({"default_view": "timeline", "board_cover": False})
self.assertEqual(out, {"default_view": "timeline", "board_cover": False})
def test_validate_keeps_only_sent_keys(self):
self.assertEqual(store.validate_project_options({"board_cover": False}), {"board_cover": False})
def test_validate_rejects(self):
for bad in ({}, None, [], {"default_view": "gantt"}, {"board_cover": 0}, {"board_cover": "false"}, {"font": "x"}):
with self.subTest(bad=bad), self.assertRaises(ValueError):
store.validate_project_options(bad)
class OptionsApiTests(unittest.TestCase):
def setUp(self):
app = FastAPI()
app.include_router(api.router)
self.client = TestClient(app)
def call(self, method, user, st, body=None):
with patch.object(api, "_require_user", return_value=user), \
patch.object(api, "_db_or_503", return_value=st):
return self.client.request(method, "/project/api/options", json=body)
def test_anyone_with_module_reads_with_can_edit_flag(self):
st = FakeStore({"default_view": "list"})
out = self.call("GET", USER, st).json()
self.assertEqual(out, {"options": {"default_view": "list", "board_cover": True}, "can_edit": False})
self.assertTrue(self.call("GET", ADMIN, st).json()["can_edit"])
def test_admin_saves_only_sent_keys(self):
st = FakeStore({"default_view": "calendar"})
res = self.call("PUT", ADMIN, st, {"board_cover": False})
self.assertEqual(res.status_code, 200)
self.assertEqual(st.writes, [({"board_cover": False}, "Boss@Test.local")])
self.assertEqual(res.json()["options"], {"default_view": "calendar", "board_cover": False})
def test_user_and_pro_cannot_save(self):
for who in (USER, PRO):
st = FakeStore()
with self.subTest(role=who["role"]):
self.assertEqual(self.call("PUT", who, st, {"board_cover": False}).status_code, 403)
self.assertEqual(st.writes, [])
def test_invalid_payload_400_without_write(self):
st = FakeStore()
for body in ({"default_view": "gantt"}, {"board_cover": "yes"}, {}, {"font": "pretendard"}):
with self.subTest(body=body):
self.assertEqual(self.call("PUT", ADMIN, st, body).status_code, 400)
self.assertEqual(st.writes, [])
def test_migration_missing_read_defaults_write_503(self):
st = FakeStore(missing=True)
self.assertEqual(self.call("GET", USER, st).json()["options"], {"default_view": "board", "board_cover": True})
res = self.call("PUT", ADMIN, st, {"board_cover": False})
self.assertEqual(res.status_code, 503)
self.assertIn("029", res.json()["detail"])
def test_page_reader_never_fails(self):
self.assertEqual(api._project_options(None), {"default_view": "board", "board_cover": True})
self.assertEqual(api._project_options(FakeStore(broken=True)), {"default_view": "board", "board_cover": True})
if __name__ == "__main__":
unittest.main()