{% for y in (goal_years or []) %}
+
{% endfor %}
{% if is_admin %}
회의록 열기와 주차 기준
왼쪽 목표 에서 연도를 선택하고 표 머리의 월 이름 을 누릅니다.
+ 이미 만든 회의록은 왼쪽 목표 연도 아래의 월 폴더 에서도 열 수 있습니다. 폴더 아이콘과 월 이름을 눌러 접거나 펼치고, 주차·날짜 항목을 누르면 그 주 회의록으로 바로 이동합니다. 접기·펼치기는 이 브라우저에 기억됩니다.
위쪽 주차 탭 또는 오른쪽 작은 달력의 주 한 줄을 눌러 주를 고릅니다. 점은 회의록이 있는 주, 이번 주 는 현재 주입니다. 이전·다음 달 버튼으로 달을 바꿉니다.
한 주는 월요일~일요일 이고, 월요일이 속한 달의 회의록입니다. 1주차는 그 달 첫 월요일이 있는 주입니다. 예: 2026년 10월 1주차는 10/5~10/11이며, 9/28~10/4는 9월 회의록입니다.
작은 달력의 흐린 앞 달 주를 누르면 그 달 회의록으로 갑니다. 해당 연도 목표 버튼은 연간 목표 표로 돌아갑니다.
diff --git a/app/static/project-goal-nav.css b/app/static/project-goal-nav.css
new file mode 100644
index 0000000..ae22b7c
--- /dev/null
+++ b/app/static/project-goal-nav.css
@@ -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; }
diff --git a/app/static/project-goal-nav.js b/app/static/project-goal-nav.js
new file mode 100644
index 0000000..4545ef1
--- /dev/null
+++ b/app/static/project-goal-nav.js
@@ -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();
+})();
diff --git a/docs/PROJECT_MODULE.md b/docs/PROJECT_MODULE.md
index 2b0b409..b348530 100644
--- a/docs/PROJECT_MODULE.md
+++ b/docs/PROJECT_MODULE.md
@@ -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 체크인 평가**(완료/일부/미달).
diff --git a/tests/js/README.md b/tests/js/README.md
index 54a1dc0..feed5bd 100644
--- a/tests/js/README.md
+++ b/tests/js/README.md
@@ -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 # 월별 회의록 폴더·주간 링크·접기 상태 기억·조회 재시도
```
실제 브라우저 레이아웃·입력기·터치 기기는 아니다(그건 헤드리스 크롬으로 따로 확인).
diff --git a/tests/js/goal_nav_ui.test.js b/tests/js/goal_nav_ui.test.js
new file mode 100644
index 0000000..6f56860
--- /dev/null
+++ b/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 = '' +
+ '';
+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; });
diff --git a/tests/test_project_meeting_nav.py b/tests/test_project_meeting_nav.py
new file mode 100644
index 0000000..26a4a3a
--- /dev/null
+++ b/tests/test_project_meeting_nav.py
@@ -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()