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
+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));
});
// 누르거나 스크롤하면 숨긴다 — 클릭으로 요소가 다시 그려지면 말풍선만
// 허공에 남는 일이 없게.