feat(project): projects visible to members only, admins included

Admins no longer see projects they are not owner/member of: sidebar list,
project list API, project pages, search, inbox, notifications, reminders
and trash all follow access.visible_project_ids. Only the super admin
still sees every project. Member assignment stays admin-only.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-07 14:16:36 +09:00
parent 2a01d97dd0
commit b6dc82c0b3
7 changed files with 122 additions and 26 deletions
+1 -1
View File
File diff suppressed because one or more lines are too long
+17 -9
View File
@@ -5,7 +5,9 @@
바꾸지도 알림을 받지도 않는다(기록 자체는 업무 이력으로 남긴다).
프로젝트
관리(=보기·작업 CRUD) : 관리자(is_admin) · 프로젝트 owner · 배정 멤버. 모두 `project` 모듈 권한이 있어야 한다.
관리(=보기·작업 CRUD) : 프로젝트 owner · 배정 멤버 · 슈퍼관리자. 모두 `project` 모듈 권한이 있어야 한다.
(2026-10-07 — 관리자(is_admin)도 멤버가 아닌 프로젝트는 보이지 않는다. 예외는 슈퍼관리자 한 명뿐.
멤버 배정 자체는 여전히 관리자만 — 라우터의 _require_admin.)
작업
FULL : 원 소속 프로젝트를 관리할 수 있음 → 보기·수정·댓글·첨부·삭제(삭제는 추가로 생성자 규칙)
@@ -34,10 +36,16 @@ def default_user_lookup(email: str) -> dict[str, Any] | None:
return user_store.get(store.norm_str(email, lower=True))
def _is_admin(user: dict[str, Any] | None) -> bool:
from app.store import is_admin # noqa: WPS433
def _is_super(user: dict[str, Any] | None) -> bool:
"""슈퍼관리자(app.store.SUPER_ADMIN_EMAIL) — 모든 프로젝트를 보는 유일한 예외."""
from app.store import SUPER_ADMIN_EMAIL # noqa: WPS433
return is_admin(user)
return bool(user) and email_of(user) == SUPER_ADMIN_EMAIL
def sees_all_projects(user: dict[str, Any] | None) -> bool:
"""멤버가 아니어도 모든 프로젝트를 보는가 — 슈퍼관리자만(모듈 권한도 있어야)."""
return can_use_module(user) and _is_super(user)
def can_use_module(user: dict[str, Any] | None) -> bool:
@@ -51,10 +59,10 @@ def email_of(user: dict[str, Any] | None) -> str:
def can_manage_project(st: Any, user: dict[str, Any] | None, project_id: Any) -> bool:
"""프로젝트 관리(=보기·작업 CRUD) — 관리자 또는 owner/멤버. 모듈 권한이 없으면 False."""
"""프로젝트 관리(=보기·작업 CRUD) — owner/멤버(관리자도 마찬가지), 슈퍼관리자는 전부. 모듈 권한이 없으면 False."""
if not can_use_module(user):
return False
if _is_admin(user):
if _is_super(user):
return True
try:
pid = int(project_id)
@@ -64,11 +72,11 @@ def can_manage_project(st: Any, user: dict[str, Any] | None, project_id: Any) ->
def visible_project_ids(st: Any, user: dict[str, Any]) -> set[int] | None:
"""관리할 수 있는 프로젝트 id 집합. 관리자는 None(=전체)."""
if _is_admin(user):
return None
"""관리할 수 있는 프로젝트 id 집합. 슈퍼관리자는 None(=전체), 그 밖(관리자 포함)은 owner·멤버인 프로젝트만."""
if not can_use_module(user):
return set()
if _is_super(user):
return None
return {
int(p["id"]) for p in st.list_projects(include_archived=True, member_email=email_of(user))
}
+15 -8
View File
@@ -94,7 +94,7 @@ def _require_admin(request: Request) -> dict[str, Any]:
def _can_manage(request: Request, st: Any, user: dict[str, Any], project_id: int) -> bool:
"""프로젝트 단위 관리 권한: 관리자이거나 멤버/owner (access.can_manage_project — 지금 기준)."""
"""프로젝트 단위 관리 권한: 멤버/owner(관리자도 마찬가지), 슈퍼관리자는 전부 (access.can_manage_project — 지금 기준)."""
return access.can_manage_project(st, user, project_id)
@@ -439,10 +439,11 @@ def _nav_projects(st: Any, user: dict[str, Any], admin: bool) -> list[dict[str,
"""좌측 사이드바(project/_side.html)의 프로젝트 트리 데이터.
내 업무 · 수신함 · 프로젝트 화면이 같은 사이드바를 쓰므로 한 곳에서 만든다.
내가 owner·멤버인 프로젝트만(관리자도 마찬가지, 슈퍼관리자만 전체 — access.sees_all_projects).
"""
projects = st.list_projects(
include_archived=False,
member_email=None if admin else user["email"],
member_email=None if access.sees_all_projects(user) else user["email"],
)
return [
{
@@ -775,7 +776,7 @@ def project_page(request: Request, project_id: int) -> HTMLResponse:
)
all_projects = st.list_projects(
include_archived=False,
member_email=None if admin else user["email"],
member_email=None if access.sees_all_projects(user) else user["email"],
)
members = st.list_members(project_id=project_id)
top_projects = [p for p in all_projects if not p.get("parent_id")] # 과거 서브프로젝트 제외
@@ -919,14 +920,11 @@ def _db_or_503(request: Request) -> Any:
@router.get("/api/projects")
def api_list_projects(request: Request) -> JSONResponse:
from app.store import is_admin # noqa: WPS433
user = _require_user(request)
st = _db_or_503(request)
admin = is_admin(user)
projects = st.list_projects(
include_archived=False,
member_email=None if admin else user["email"],
member_email=None if access.sees_all_projects(user) else user["email"],
)
return JSONResponse({"projects": projects, "tree": _build_tree(projects)})
@@ -2426,11 +2424,18 @@ def trash_page(request: Request) -> HTMLResponse:
"color_palette": list(store.COLOR_PALETTE),
"project_icons": list(store.PROJECT_ICONS),
"trash_enabled": enabled,
"items": _trash_view_items(st.list_trash()) if enabled else [],
# 휴지통도 내가 볼 수 있는 프로젝트(owner·멤버, 슈퍼관리자는 전체)의 것만
"items": _trash_view_items(_visible_trash(st, user)) if enabled else [],
},
)
def _visible_trash(st: Any, user: dict[str, Any]) -> list[dict[str, Any]]:
allowed = _accessible_project_ids(st, user)
items = st.list_trash()
return items if allowed is None else [it for it in items if it.get("project_id") in allowed]
def _trash_view_items(items: list[dict[str, Any]]) -> list[dict[str, Any]]:
"""휴지통 화면용 — 삭제 시각(KST 문자열)·남은 보관 일수."""
from datetime import datetime # noqa: WPS433
@@ -2457,6 +2462,8 @@ def api_restore_trash(request: Request, trash_id: int) -> JSONResponse:
"""휴지통 항목 복구 — 관리자 전용. 업무·하위 업무·댓글 등 원래 id 그대로."""
user = _require_admin(request)
st = _db_or_503(request)
if not any(int(it["id"]) == trash_id for it in _visible_trash(st, user)):
raise HTTPException(status_code=404, detail="휴지통 항목을 찾을 수 없습니다.") # 멤버가 아닌 프로젝트 것은 없는 것처럼
try:
result = st.restore_trash(trash_id=trash_id, restored_by=user["email"])
except KeyError:
@@ -131,12 +131,12 @@
<p class="pjh-lead">프로젝트 관리 메뉴는 관리자 페이지에서 “프로젝트 관리” 권한을 받은 직원에게 보입니다.</p>
<table class="pjh-table">
<tr><th>할 수 있는 일</th><th>누가</th></tr>
<tr><td>프로젝트 보기</td><td>그 프로젝트의 <b>멤버·소유자</b>(또는 관리자). 멤버가 아니면 주소를 알아도 열리지 않습니다.</td></tr>
<tr><td>작업·하위 작업·댓글</td><td>그 프로젝트의 멤버·소유자·관리자가 만들고 고칠 수 있습니다.</td></tr>
<tr><td>프로젝트 보기</td><td>그 프로젝트의 <b>멤버·소유자만</b>. 관리자도 멤버가 아니면 왼쪽 프로젝트 목록·검색·휴지통에 보이지 않고, 주소를 알아도 열리지 않습니다(최고 관리자만 예외).</td></tr>
<tr><td>작업·하위 작업·댓글</td><td>그 프로젝트의 멤버·소유자가 만들고 고칠 수 있습니다.</td></tr>
<tr><td>작업·섹션·프로젝트 삭제</td><td><b>만든 사람만</b> 지울 수 있습니다(최고 관리자는 예외).</td></tr>
<tr><td>댓글 고치기·지우기</td><td>댓글을 쓴 사람(또는 관리자)만.</td></tr>
<tr><td>새 프로젝트, 사이드바의 프로젝트 수정·순서 바꾸기</td><td>관리자 (<span class="pjh-ui">+</span> · <span class="pjh-ui">✎</span> · <span class="pjh-ui">⣿</span> 버튼이 관리자에게만 보입니다)</td></tr>
<tr><td>멤버 배정·제외, 프로젝트 소유자 바꾸기</td><td>관리자</td></tr>
<tr><td>멤버 배정·제외, 프로젝트 소유자 바꾸기</td><td>관리자(자기가 멤버인 프로젝트에서)</td></tr>
<tr><td>다른 프로젝트에서 연결돼 온 작업</td><td>원래 프로젝트 멤버가 아니면 <b>읽기만</b> — 내용·댓글·첨부는 보이지만 고치거나 댓글을 달 수 없습니다(연결된 보드 안에서 섹션 옮기기는 됩니다).</td></tr>
<tr><td>멤버에서 빠졌을 때</td><td>그 프로젝트의 작업은 내 작업·수신함·알림·검색에서 사라지고, 예전 링크로도 열리지 않습니다. 새 알림도 오지 않습니다.</td></tr>
<tr><td>휴지통 보기·복구, 전체 멤버, 대시보드의 담당자별 차트</td><td>관리자</td></tr>
@@ -485,7 +485,7 @@
<ul>
<li>작업 편집 창의 <span class="pjh-ui">공유</span> 또는 우클릭 <span class="pjh-ui">작업 링크 복사</span>로 주소를 복사합니다.</li>
<li>받은 사람이 주소를 열면(로그인 전이면 로그인 후) 그 작업이 바로 열립니다. 하위 작업 링크는 하위 작업 자체가 열립니다.</li>
<li>현재 그 작업을 볼 수 있는 멤버·소유자·관리자가 열 수 있습니다. 연결된 프로젝트 멤버는 읽기 전용으로 보며, 멤버에서 제외되면 예전 링크로도 열 수 없습니다.</li>
<li>현재 그 작업을 볼 수 있는 멤버·소유자가 열 수 있습니다. 연결된 프로젝트 멤버는 읽기 전용으로 보며, 멤버에서 제외되면 예전 링크로도 열 수 없습니다.</li>
</ul>
</section>
@@ -494,7 +494,7 @@
<h2><span class="pjh-num">19</span>휴지통 (관리자)</h2>
<ul>
<li>지운 작업은 바로 사라지지 않고 <b>3개월 동안</b> 휴지통에 보관됩니다. 하위 작업 · 댓글 · 협업자 · 첨부 파일도 함께 보관됩니다.</li>
<li>관리자는 왼쪽 사이드바 <b>휴지통</b>에서 지운 작업 목록(프로젝트 · 삭제한 사람 · 삭제 시각)을 봅니다.</li>
<li>관리자는 왼쪽 사이드바 <b>휴지통</b>에서 지운 작업 목록(프로젝트 · 삭제한 사람 · 삭제 시각)을 봅니다. 자기가 멤버인 프로젝트의 작업만 보입니다.</li>
<li><span class="pjh-ui">복구</span>를 누르면 원래 프로젝트 · 섹션 자리로 그대로 돌아옵니다. 복구된 줄의 <span class="pjh-ui">복구됨 · 열기</span>로 바로 열어 볼 수 있습니다.</li>
<li>3개월이 지나면 영구 삭제됩니다.</li>
</ul>
+2 -2
View File
@@ -48,8 +48,8 @@
| 멤버 배정 후보 | `project` 권한 보유 등록 사용자 자동 목록 (`GET /project/api/assignable-users`) |
| 생성 권한 | **프로젝트·섹션·작업(하위 작업 포함) 생성은 로그인해 이 모듈에 접근할 수 있는 사용자 누구나.** 프로젝트를 만든 사람은 자동으로 owner 가 되어 그 프로젝트를 관리(`_can_manage`)할 수 있다. 다른 사람을 owner 로 지정해 만드는 건 관리자만(비관리자가 `owner_email` 을 남으로 보내면 403) |
| 소유자 변경 | **관리자만**(2026-09-30). owner 는 멤버에서 빠져도 관리 권한이 남으므로, 일반 멤버가 스스로를 owner 로 바꿔 권한 회수를 피할 수 없게 `PUT /api/projects/{id}` 의 `owner_email` 변경은 비관리자 403(같은 값은 무시). 새 owner 는 `project` 권한이 있는 등록 사용자여야 한다(아니면 400) |
| 수정/이동 권한 | 서브프로젝트·작업·섹션 CRUD(이름변경·완료토글·순서변경 등) = 그 프로젝트의 배정 멤버 또는 owner 또는 admin(`_require_manage`). 작업 API 는 `_require_task(write=True)` = 원 소속 프로젝트 권한(FULL) |
| 조회 권한 | 프로젝트 화면(`/p/{id}`)·멤버/섹션/작업/활동/스냅샷 API 도 멤버·owner·admin 만(`_require_manage`). 비멤버는 403. `GET /api/users/tasks` 를 프로젝트 없이 부르면 내가 볼 수 있는 프로젝트의 작업만 돌려준다. 연결된(멀티호밍) 작업은 연결된 프로젝트 멤버에게 **읽기 전용**(6-10) |
| 수정/이동 권한 | 서브프로젝트·작업·섹션 CRUD(이름변경·완료토글·순서변경 등) = 그 프로젝트의 배정 멤버 또는 owner 또는 슈퍼관리자(`_require_manage`). 작업 API 는 `_require_task(write=True)` = 원 소속 프로젝트 권한(FULL) |
| 조회 권한 | 프로젝트 화면(`/p/{id}`)·멤버/섹션/작업/활동/스냅샷 API 도 멤버·owner 만(`_require_manage`). 비멤버는 403. **관리자(is_admin)도 멤버가 아니면 못 본다 — 예외는 슈퍼관리자(`app.store.SUPER_ADMIN_EMAIL`) 한 명**(2026-10-07, `access.sees_all_projects`·`visible_project_ids`). 왼쪽 사이드바 프로젝트 목록·`GET /api/projects`·검색·수신함·알림·마감 알림·휴지통(목록·복구)도 같은 기준. 멤버 배정은 여전히 관리자만이라, 관리자는 자기가 멤버인 프로젝트에서만 배정할 수 있다(직원이 만든 프로젝트는 슈퍼관리자가 배정). `GET /api/users/tasks` 를 프로젝트 없이 부르면 내가 볼 수 있는 프로젝트의 작업만 돌려준다. 연결된(멀티호밍) 작업은 연결된 프로젝트 멤버에게 **읽기 전용**(6-10) |
| 지금 권한 기준 | 모든 판단은 **지금** 권한(`app/modules/project/access.py`) — 멤버에서 빠진 사람은 예전 담당자·멘션·협업자 기록이 있어도 내 작업·수신함·알림·검색·상세·공유 링크·댓글·첨부에서 그 작업이 보이지 않고, 새 알림·메일도 받지 않는다(기록은 이력으로 남김) |
| 입력 검증 | URL 의 섹션이 URL 의 프로젝트 것인지(`_stage_of_project`), 작업 생성/수정·연결 시 섹션이 그 프로젝트 것인지(`stage_in_project`), 하위 작업의 부모가 같은 프로젝트인지 확인 — 권한은 URL 의 project_id 로 보므로 이걸 안 보면 남의 프로젝트를 건드릴 수 있다. 새 담당자는 그 프로젝트를 볼 수 있는 사람만(400). 날짜 범위(시작 ≤ 마감, 같은 날이면 시작 시각 ≤ 마감 시각)는 부분 수정도 기존 값과 합친 최종 상태로 검사(400) |
| 삭제 권한 | **프로젝트·섹션·작업 모두 "만든 사람만"**(슈퍼관리자 예외, 생성자 정보 없는 과거 데이터는 admin 허용) — `_can_delete` 하나로 통일. **그리고 지금 그 프로젝트 권한이 있어야 한다**(멤버에서 빠진 생성자는 403, DB·휴지통 변화 없음) |
+80
View File
@@ -0,0 +1,80 @@
"""프로젝트는 멤버(owner 포함)만 — 관리자도 멤버가 아니면 안 보인다, 예외는 슈퍼관리자(2026-10-07). DB 없이."""
import importlib
import sys
import unittest
from types import SimpleNamespace
from unittest.mock import Mock, patch
from fastapi import FastAPI
from fastapi.testclient import TestClient
from app.modules.project import access
from app.store import SUPER_ADMIN_EMAIL
api = importlib.import_module("app.modules.project.router")
ADMIN = {"email": "admin@test.local", "role": "admin"}
SUPER = {"email": SUPER_ADMIN_EMAIL, "role": "admin"}
MEMBER = {"email": "bob@test.local", "role": "user"}
class FakeStore:
"""프로젝트 1 = bob 멤버, 2 = admin 멤버. list_projects(member_email) 는 그 사람이 owner·멤버인 것만."""
members = {1: {"bob@test.local"}, 2: {"admin@test.local"}}
def __init__(self):
self.member_email_asked = "unset"
def is_member(self, project_id, user_email):
return user_email in self.members.get(project_id, set())
def list_projects(self, include_archived=False, member_email=None):
self.member_email_asked = member_email
return [{"id": pid, "parent_id": None, "name": f"P{pid}"} for pid, ms in self.members.items()
if member_email is None or member_email in ms]
class MembersOnlyTests(unittest.TestCase):
def setUp(self):
self.st = FakeStore()
p = patch.object(access, "can_use_module", side_effect=lambda u: bool(u))
p.start()
self.addCleanup(p.stop)
def test_admin_sees_only_member_projects(self):
self.assertFalse(access.can_manage_project(self.st, ADMIN, 1))
self.assertTrue(access.can_manage_project(self.st, ADMIN, 2))
self.assertEqual(access.visible_project_ids(self.st, ADMIN), {2})
self.assertFalse(access.sees_all_projects(ADMIN))
def test_member_and_super_admin(self):
self.assertTrue(access.can_manage_project(self.st, MEMBER, 1))
self.assertFalse(access.can_manage_project(self.st, MEMBER, 2))
self.assertTrue(access.can_manage_project(self.st, SUPER, 1))
self.assertIsNone(access.visible_project_ids(self.st, SUPER)) # 전체
self.assertTrue(access.sees_all_projects(SUPER))
def test_sidebar_list_is_member_only_for_admin(self):
self.assertEqual([p["id"] for p in api._nav_projects(self.st, ADMIN, True)], [2])
self.assertEqual(self.st.member_email_asked, "admin@test.local")
self.assertEqual(sorted(p["id"] for p in api._nav_projects(self.st, SUPER, True)), [1, 2])
self.assertIsNone(self.st.member_email_asked)
def test_project_list_api_is_member_only_for_admin(self):
app = FastAPI()
app.include_router(api.router)
client = TestClient(app)
with patch.object(api, "_require_user", return_value=ADMIN), patch.object(api, "_db_or_503", return_value=self.st):
r = client.get("/project/api/projects")
self.assertEqual(r.status_code, 200, r.text)
self.assertEqual([p["id"] for p in r.json()["projects"]], [2])
def test_trash_is_filtered_to_member_projects(self):
st = SimpleNamespace(list_trash=lambda: [{"id": 7, "project_id": 1}, {"id": 8, "project_id": 2}],
**{k: getattr(self.st, k) for k in ("is_member", "list_projects")})
self.assertEqual([t["id"] for t in api._visible_trash(st, ADMIN)], [8])
self.assertEqual([t["id"] for t in api._visible_trash(st, SUPER)], [7, 8])
if __name__ == "__main__":
unittest.main()
+2 -1
View File
@@ -121,7 +121,8 @@ def _count(sql: str, *args) -> int:
# [07] 소유자 변경은 관리자만
# ════════════════════════════════════════════════════════════
def test_owner_change_admin_only():
p = _project("P-owner", ADMIN, (BOB,))
# 관리자도 멤버가 아닌 프로젝트는 못 다룬다(2026-10-07) — 소유자를 남에게 넘긴 뒤에도 바꿀 수 있게 멤버로 둔다
p = _project("P-owner", ADMIN, (BOB, ADMIN))
r = req("PUT", f"/project/api/projects/{p['id']}", BOB, json={"owner_email": BOB})
assert r.status_code == 403, r.text
assert ST.get_project(project_id=p["id"])["owner_email"] == ADMIN