feat(project): add monthly meeting menu tree
This commit is contained in:
@@ -2684,6 +2684,32 @@ def api_create_goal_year(request: Request, payload: dict[str, Any] = Body(...))
|
||||
return JSONResponse({"ok": True, "year": y}, status_code=201)
|
||||
|
||||
|
||||
@router.get("/api/goals/meeting-nav")
|
||||
def api_goal_meeting_nav(request: Request) -> JSONResponse:
|
||||
"""왼쪽 메뉴용: 저장된 회의록만 연도·월로 묶는다. 화면 조회로 회의록을 만들지 않는다."""
|
||||
_require_user(request)
|
||||
st = _db_or_503(request)
|
||||
years = _goal_years_nav(st)
|
||||
# 연도마다 DB를 읽지 않고, 메뉴에 있는 전체 연도 범위를 한 번에 조회한다.
|
||||
weeks = _goal_call(st.meeting_weeks, start=date(min(years), 1, 1), end=date(max(years), 12, 31))
|
||||
grouped: dict[int, dict[int, list[dict[str, Any]]]] = {}
|
||||
for value in sorted(set(weeks)):
|
||||
mon = store.validate_week_start(value)
|
||||
if mon.year not in years:
|
||||
continue
|
||||
end = mon + timedelta(days=6)
|
||||
# 달이 바뀌어도 월요일이 속한 월 아래에 한 번만 표시한다.
|
||||
number = next(i + 1 for i, (w, _) in enumerate(store.month_weeks(mon.year, mon.month)) if w == mon)
|
||||
grouped.setdefault(mon.year, {}).setdefault(mon.month, []).append({
|
||||
"start": mon.isoformat(), "label": f"{number}주차 ({mon.month}/{mon.day}~{end.month}/{end.day})",
|
||||
"href": f"/project/goals/{mon.year}/meetings/{mon.month}?week={mon.isoformat()}",
|
||||
})
|
||||
return JSONResponse({"years": [
|
||||
{"year": y, "months": [{"month": m, "weeks": grouped[y][m]} for m in sorted(grouped[y])]}
|
||||
for y in years if y in grouped
|
||||
]})
|
||||
|
||||
|
||||
@router.put("/api/goals/{year}")
|
||||
def api_update_goal_year(request: Request, year: int, payload: dict[str, Any] = Body(...)) -> JSONResponse:
|
||||
_require_admin(request)
|
||||
|
||||
@@ -16,6 +16,9 @@
|
||||
{# 날짜 팝업(openDatePopover)이 공휴일을 빨강으로 칠할 때 쓰는 표 — 이 사이드바는
|
||||
프로젝트 관리의 모든 화면에 들어가므로 여기서 한 번 넘긴다(main.py 의 Jinja 전역). #}
|
||||
<script>window.PJ_HOLIDAYS = {{ (pj_kr_holidays or {}) | tojson }};</script>
|
||||
{# 모든 프로젝트 화면에서 같은 회의록 트리를 사용한다. #}
|
||||
<link rel="stylesheet" href="/static/project-goal-nav.css?v=20261004a" />
|
||||
<script src="/static/project-goal-nav.js?v=20261004a" defer></script>
|
||||
<aside class="pj-side" data-is-admin="{{ 'true' if is_admin else 'false' }}"
|
||||
data-is-super="{{ 'true' if user.is_super_admin else 'false' }}"
|
||||
data-me="{{ user.email }}">
|
||||
@@ -62,8 +65,11 @@
|
||||
</button>
|
||||
<div class="pj-side-goal-years" id="pj-side-goal-years"{% if not goal_open %} hidden{% endif %}>
|
||||
{% for y in (goal_years or []) %}
|
||||
<div class="pj-side-goal-branch" data-goal-year="{{ y }}">
|
||||
<a class="pj-side-goal-year{% if side_active == 'goals' and y == goal_year_active %} is-active{% endif %}"
|
||||
href="/project/goals/{{ y }}">{{ y }}년</a>
|
||||
<div class="pj-side-meeting-months" data-current-week="{{ week if goal_month is defined else '' }}"></div>
|
||||
</div>
|
||||
{% endfor %}
|
||||
{% if is_admin %}
|
||||
<button type="button" class="pj-side-goal-add" id="pj-goal-year-add"
|
||||
|
||||
@@ -573,6 +573,7 @@
|
||||
<h3 id="meetings-week">회의록 열기와 주차 기준</h3>
|
||||
<ol class="pjh-steps">
|
||||
<li>왼쪽 <span class="pjh-ui">목표</span>에서 연도를 선택하고 표 머리의 <b>월 이름</b>을 누릅니다.</li>
|
||||
<li>이미 만든 회의록은 왼쪽 목표 연도 아래의 <b>월 폴더</b>에서도 열 수 있습니다. 폴더 아이콘과 월 이름을 눌러 접거나 펼치고, 주차·날짜 항목을 누르면 그 주 회의록으로 바로 이동합니다. 접기·펼치기는 이 브라우저에 기억됩니다.</li>
|
||||
<li>위쪽 주차 탭 또는 오른쪽 작은 달력의 주 한 줄을 눌러 주를 고릅니다. 점은 회의록이 있는 주, <span class="pjh-ui">이번 주</span>는 현재 주입니다. 이전·다음 달 버튼으로 달을 바꿉니다.</li>
|
||||
<li>한 주는 <b>월요일~일요일</b>이고, 월요일이 속한 달의 회의록입니다. 1주차는 그 달 첫 월요일이 있는 주입니다. 예: 2026년 10월 1주차는 10/5~10/11이며, 9/28~10/4는 9월 회의록입니다.</li>
|
||||
<li>작은 달력의 흐린 앞 달 주를 누르면 그 달 회의록으로 갑니다. <span class="pjh-ui">해당 연도 목표</span> 버튼은 연간 목표 표로 돌아갑니다.</li>
|
||||
|
||||
@@ -0,0 +1,28 @@
|
||||
/* 목표 연도 아래 월 폴더와 주간 회의록 — 좁은 왼쪽 메뉴에서도 글자는 한 줄로 표시한다. */
|
||||
.pj-side-goal-branch { min-width: 0; }
|
||||
.pj-side-meeting-months { padding-left: 8px; }
|
||||
.pj-side-meeting-month { min-width: 0; }
|
||||
.pj-side-meeting-month > summary {
|
||||
display: flex; align-items: center; gap: 5px; padding: 5px 4px;
|
||||
border-radius: 6px; cursor: pointer; color: var(--pj-ink-soft); list-style: none;
|
||||
font-size: 13px; line-height: 20px;
|
||||
}
|
||||
.pj-side-meeting-month > summary::-webkit-details-marker { display: none; }
|
||||
.pj-side-meeting-month > summary:hover { background: #f1f2f4; }
|
||||
.pj-side-meeting-month > summary:focus-visible,
|
||||
.pj-side-meeting-week:focus-visible { outline: 2px solid var(--pj-accent); outline-offset: -2px; }
|
||||
.pj-side-meeting-caret { flex: none; font-size: 16px; }
|
||||
.pj-side-meeting-month[open] .pj-side-meeting-caret { transform: rotate(90deg); }
|
||||
.pj-side-meeting-folder { flex: none; font-size: 18px; color: var(--pj-accent); }
|
||||
.pj-side-meeting-folder-open { display: none; }
|
||||
.pj-side-meeting-month[open] .pj-side-meeting-folder-closed { display: none; }
|
||||
.pj-side-meeting-month[open] .pj-side-meeting-folder-open { display: inline-block; }
|
||||
.pj-side-meeting-weeks { margin: 0 0 4px 12px; padding-left: 8px; border-left: 1px solid var(--pj-border); }
|
||||
.pj-side-meeting-week {
|
||||
display: block; min-width: 0; padding: 5px 4px; border-radius: 6px;
|
||||
color: var(--pj-ink); text-decoration: none; font-size: 12px; line-height: 18px;
|
||||
overflow: hidden; text-overflow: ellipsis; white-space: nowrap;
|
||||
}
|
||||
.pj-side-meeting-week:hover { background: #f1f2f4; }
|
||||
.pj-side-meeting-week.is-active { background: var(--pj-accent-tint); color: var(--pj-accent-dark); }
|
||||
.pj-side-meeting-retry { font: inherit; font-size: 12px; color: var(--pj-ink-soft); border: 0; background: transparent; cursor: pointer; padding: 5px 8px; }
|
||||
@@ -0,0 +1,87 @@
|
||||
/* 생성된 회의록만 읽어서 목표 연도 아래에 월별 폴더를 만든다. */
|
||||
(function () {
|
||||
"use strict";
|
||||
function init() {
|
||||
const branches = Array.from(document.querySelectorAll(".pj-side-goal-branch"));
|
||||
if (!branches.length) return;
|
||||
let loading = false, retry = null;
|
||||
|
||||
// 문자열을 HTML로 해석하지 않고 넣어 회의록 메뉴의 글자를 그대로 표시한다.
|
||||
function icon(name, cls) {
|
||||
const span = document.createElement("span");
|
||||
span.className = "material-symbols-outlined " + cls;
|
||||
span.setAttribute("aria-hidden", "true");
|
||||
span.textContent = name;
|
||||
return span;
|
||||
}
|
||||
function render(branch, months) {
|
||||
const list = branch.querySelector(".pj-side-meeting-months");
|
||||
const current = list.dataset.currentWeek;
|
||||
list.replaceChildren();
|
||||
months.forEach(function (month) {
|
||||
const folder = document.createElement("details");
|
||||
folder.className = "pj-side-meeting-month";
|
||||
const key = "pj_goal_month_open:" + branch.dataset.goalYear + ":" + month.month;
|
||||
let saved = null;
|
||||
try { saved = localStorage.getItem(key); } catch (_) {}
|
||||
folder.open = saved == null ? month.weeks.some(function (w) { return w.start === current; }) : saved === "1";
|
||||
const summary = document.createElement("summary");
|
||||
summary.append(icon("chevron_right", "pj-side-meeting-caret"),
|
||||
icon("folder", "pj-side-meeting-folder pj-side-meeting-folder-closed"),
|
||||
icon("folder_open", "pj-side-meeting-folder pj-side-meeting-folder-open"),
|
||||
document.createTextNode(month.month + "월"));
|
||||
summary.setAttribute("aria-label", month.month + "월 주간 회의록");
|
||||
folder.append(summary);
|
||||
const weeks = document.createElement("div");
|
||||
weeks.className = "pj-side-meeting-weeks";
|
||||
month.weeks.forEach(function (week) {
|
||||
const link = document.createElement("a");
|
||||
link.className = "pj-side-meeting-week";
|
||||
link.href = week.href;
|
||||
link.textContent = week.label;
|
||||
link.title = week.label;
|
||||
if (week.start === current) {
|
||||
link.classList.add("is-active");
|
||||
link.setAttribute("aria-current", "page");
|
||||
}
|
||||
weeks.append(link);
|
||||
});
|
||||
folder.append(weeks);
|
||||
list.append(folder);
|
||||
// 접기·펼치기 선택은 같은 브라우저에서 다음 화면에도 유지한다.
|
||||
folder.addEventListener("toggle", function () {
|
||||
try { localStorage.setItem(key, folder.open ? "1" : "0"); } catch (_) {}
|
||||
});
|
||||
});
|
||||
}
|
||||
async function load() {
|
||||
if (loading) return;
|
||||
loading = true;
|
||||
if (retry) retry.disabled = true;
|
||||
try {
|
||||
const response = await fetch("/project/api/goals/meeting-nav", { credentials: "same-origin" });
|
||||
if (!response.ok) throw new Error("회의록 조회 실패");
|
||||
const data = await response.json();
|
||||
branches.forEach(function (branch) {
|
||||
const year = (data.years || []).find(function (y) { return String(y.year) === branch.dataset.goalYear; });
|
||||
render(branch, year ? year.months : []);
|
||||
});
|
||||
if (retry) { retry.remove(); retry = null; }
|
||||
} catch (_) {
|
||||
// 목록 조회가 실패해도 기존 목표·프로젝트 메뉴는 계속 사용할 수 있다.
|
||||
if (!retry) {
|
||||
retry = document.createElement("button");
|
||||
retry.type = "button";
|
||||
retry.className = "pj-side-meeting-retry";
|
||||
retry.textContent = "회의록 목록 다시 불러오기";
|
||||
retry.addEventListener("click", load);
|
||||
branches[branches.length - 1].after(retry);
|
||||
}
|
||||
retry.disabled = false;
|
||||
} finally { loading = false; }
|
||||
}
|
||||
load();
|
||||
}
|
||||
if (document.readyState === "loading") document.addEventListener("DOMContentLoaded", init);
|
||||
else init();
|
||||
})();
|
||||
@@ -724,6 +724,11 @@ description 을 항상 HTML로 취급하기 때문). 두 번 실행하면 이중
|
||||
|
||||
### 6-9-2. 주간 회의록 (마이그레이션 015)
|
||||
|
||||
왼쪽 목표 연도 아래에는 생성된 회의록만 월별 폴더 트리로 표시한다(`project-goal-nav.js`·`.css`,
|
||||
`GET /project/api/goals/meeting-nav`, 프로젝트 권한자 조회). 월요일이 속한 월로 묶고 월·주차는 날짜순이다.
|
||||
월 폴더는 아이콘과 함께 접기·펼치기를 지원하며 `pj_goal_month_open:{연도}:{월}`에 선택을 기억한다.
|
||||
현재 회의록의 월은 저장된 선택이 없으면 펼치고, 주간 링크는 그 주의 회의록으로 바로 이동한다. 조회로 회의록을 만들지 않는다.
|
||||
|
||||
지난주 목표·결과를 리뷰하고 월 목표를 달성하기 위한 이번주 목표·할 일을 정하는 회의(WBR — Weekly Business Review)용.
|
||||
참고한 도구 방식: **WBR 지표 자동 집계**(목표 대비 누적·주당 필요 매출 = 페이싱), **Fellow·Notion 회의 템플릿의 이월**(지난 회의
|
||||
항목을 다음 회의로 이어받아 나란히 리뷰), **OKR 체크인 평가**(완료/일부/미달).
|
||||
|
||||
@@ -23,6 +23,7 @@ node tests/js/box_calc_ui.test.js
|
||||
```bash
|
||||
python tests/js/render_goals.py # → tests/js/.out/goals_*.html · meeting_*.html
|
||||
node tests/js/goals_meeting_ui.test.js # jsdom 필요(npm install jsdom 또는 NODE_PATH)
|
||||
node tests/js/goal_nav_ui.test.js # 월별 회의록 폴더·주간 링크·접기 상태 기억·조회 재시도
|
||||
```
|
||||
|
||||
실제 브라우저 레이아웃·입력기·터치 기기는 아니다(그건 헤드리스 크롬으로 따로 확인).
|
||||
|
||||
@@ -0,0 +1,45 @@
|
||||
// 생성된 주간 회의록 트리: 월 폴더·직접 링크·선택 기억·오류 재시도를 확인한다.
|
||||
const assert = require("node:assert/strict");
|
||||
const fs = require("node:fs"), path = require("node:path");
|
||||
const { JSDOM } = require("jsdom");
|
||||
const script = fs.readFileSync(path.resolve(__dirname, "../../app/static/project-goal-nav.js"), "utf8");
|
||||
const html = '<div class="pj-side-goal-branch" data-goal-year="2026"><a href="/project/goals/2026">2026년</a><div class="pj-side-meeting-months" data-current-week="2026-09-28"></div></div>' +
|
||||
'<div class="pj-side-goal-branch" data-goal-year="2027"><div class="pj-side-meeting-months"></div></div>';
|
||||
const data = { years: [{ year: 2026, months: [
|
||||
{ month: 9, weeks: [{ start: "2026-09-28", label: "4주차 (9/28~10/4)", href: "/project/goals/2026/meetings/9?week=2026-09-28" }] },
|
||||
{ month: 10, weeks: [{ start: "2026-10-05", label: "1주차 (10/5~10/11)", href: "/project/goals/2026/meetings/10?week=2026-10-05" }] },
|
||||
] }] };
|
||||
const settle = () => new Promise(r => setTimeout(r, 20));
|
||||
async function env(storage, fail) {
|
||||
const dom = new JSDOM(html, { runScripts: "outside-only", url: "http://localhost/project/" });
|
||||
const w = dom.window;
|
||||
if (w.document.readyState === "loading") await new Promise(r => w.document.addEventListener("DOMContentLoaded", r));
|
||||
if (storage) w.localStorage.setItem("pj_goal_month_open:2026:9", storage);
|
||||
let calls = 0;
|
||||
w.fetch = async (url, opts) => {
|
||||
assert.equal(url, "/project/api/goals/meeting-nav"); assert.equal(opts.credentials, "same-origin");
|
||||
calls++;
|
||||
return { ok: !(fail && calls === 1), json: async () => data };
|
||||
};
|
||||
w.eval(script); await settle();
|
||||
return { w, d: w.document, calls: () => calls, close: () => dom.window.close() };
|
||||
}
|
||||
(async () => {
|
||||
let e = await env();
|
||||
const folders = e.d.querySelectorAll("details");
|
||||
assert.equal(folders.length, 2); assert.equal(folders[0].open, true); assert.equal(folders[1].open, false);
|
||||
assert.equal(e.d.querySelector('[data-goal-year="2027"] details'), null);
|
||||
assert.equal(e.d.querySelector('a[aria-current="page"]').getAttribute("href"), data.years[0].months[0].weeks[0].href);
|
||||
assert.equal(e.d.querySelectorAll(".pj-side-meeting-folder-closed").length, 2);
|
||||
assert.equal(e.d.querySelectorAll(".pj-side-meeting-folder-open").length, 2);
|
||||
folders[0].open = false; await settle();
|
||||
assert.equal(e.w.localStorage.getItem("pj_goal_month_open:2026:9"), "0");
|
||||
assert.equal(e.calls(), 1); e.close();
|
||||
e = await env("0"); assert.equal(e.d.querySelector("details").open, false); e.close();
|
||||
e = await env("1"); assert.equal(e.d.querySelector("details").open, true); e.close();
|
||||
e = await env(null, true);
|
||||
const retry = e.d.querySelector(".pj-side-meeting-retry"); assert.ok(retry); retry.click(); retry.click();
|
||||
await settle(); assert.equal(e.calls(), 2); assert.equal(e.d.querySelector(".pj-side-meeting-retry"), null);
|
||||
assert.equal(e.d.querySelectorAll("details").length, 2); e.close();
|
||||
console.log("ALL PASS: month folders, direct week links, current week, stored collapse state, single read and retry");
|
||||
})().catch(e => { console.error(e); process.exitCode = 1; });
|
||||
@@ -0,0 +1,49 @@
|
||||
"""회의록 메뉴의 권한·저장된 주만 조회·월 경계를 DB 연결 없이 확인한다."""
|
||||
import importlib
|
||||
import unittest
|
||||
from datetime import date
|
||||
from types import SimpleNamespace
|
||||
from unittest.mock import Mock, patch
|
||||
|
||||
from fastapi import FastAPI, HTTPException
|
||||
from fastapi.testclient import TestClient
|
||||
|
||||
api = importlib.import_module("app.modules.project.router")
|
||||
|
||||
|
||||
class MeetingNavTests(unittest.TestCase):
|
||||
def setUp(self):
|
||||
app = FastAPI()
|
||||
app.include_router(api.router)
|
||||
self.client = TestClient(app)
|
||||
|
||||
def test_saved_weeks_are_grouped_once_under_monday_month(self):
|
||||
query = Mock(return_value=["2026-09-28", "2026-10-05", "2026-10-19", "2025-12-29", "2026-09-28"])
|
||||
st = SimpleNamespace(list_goal_years=lambda: [2025, 2026, 2027], meeting_weeks=query)
|
||||
with patch.object(api, "_require_user", return_value={"email": "reader@test"}), \
|
||||
patch.object(api, "_store", return_value=st), patch.object(api, "today_kst", return_value=date(2026, 10, 4)):
|
||||
result = self.client.get("/project/api/goals/meeting-nav")
|
||||
self.assertEqual(result.status_code, 200)
|
||||
years = result.json()["years"]
|
||||
self.assertEqual([y["year"] for y in years], [2026, 2025])
|
||||
self.assertEqual([m["month"] for m in years[0]["months"]], [9, 10])
|
||||
september = years[0]["months"][0]["weeks"]
|
||||
self.assertEqual(len(september), 1)
|
||||
self.assertEqual(september[0]["label"], "4주차 (9/28~10/4)")
|
||||
self.assertEqual(september[0]["href"], "/project/goals/2026/meetings/9?week=2026-09-28")
|
||||
self.assertEqual([w["label"] for w in years[0]["months"][1]["weeks"]],
|
||||
["1주차 (10/5~10/11)", "3주차 (10/19~10/25)"])
|
||||
self.assertEqual(years[1]["months"][0]["weeks"][0]["label"], "5주차 (12/29~1/4)")
|
||||
query.assert_called_once_with(start=date(2025, 1, 1), end=date(2027, 12, 31))
|
||||
|
||||
def test_no_meetings_returns_empty_tree(self):
|
||||
st = SimpleNamespace(list_goal_years=lambda: [], meeting_weeks=lambda **kw: [])
|
||||
with patch.object(api, "_require_user", return_value={}), patch.object(api, "_store", return_value=st):
|
||||
self.assertEqual(self.client.get("/project/api/goals/meeting-nav").json(), {"years": []})
|
||||
|
||||
def test_unauthorized_requests_do_not_query_database(self):
|
||||
for status in (401, 403):
|
||||
with self.subTest(status=status), patch.object(api, "_require_user", side_effect=HTTPException(status)), \
|
||||
patch.object(api, "_store") as query:
|
||||
self.assertEqual(self.client.get("/project/api/goals/meeting-nav").status_code, status)
|
||||
query.assert_not_called()
|
||||
Reference in New Issue
Block a user