---
type: file-backend
status: draft
related_pages: ["[[architecture/project_map]]", "[[architecture/workflow_data_flow]]"]
page_id: B01_Dashboard
source_file: "B01_Dashboard/B01_Dashboard_Router.py"
last_updated: 2026-08-08
---

# B01_Dashboard_Router.py

역할별(USER, ADMIN, SYSTEM_ADMIN, MASTER) 대시보드, 내 프로젝트 관리, 소속 회사 생성/가입 신청, 팀원 관리 및 시스템 자원 모니터링 API 라우터 모듈입니다.

## 🛠️ 라우터 API 및 주요 함수 목록

| 항목 | 위치(상대 경로) | 역할 |
|---|---|---|
| `dashboard_me()` / `patch_dashboard_me()` | `B01_Dashboard/B01_Dashboard_Router.py` | `GET/PATCH /api/dashboard/me` — 사용자 프로필 조회 및 수정 (GET 응답 `user`에 `project_delete_hard` 포함) |
| `user_projects()` | `B01_Dashboard/B01_Dashboard_Router.py` | `GET /api/dashboard/user/projects` — 내 참여/소유 프로젝트 목록 조회 |
| `user_company()` / `user_company_create()` | `B01_Dashboard/B01_Dashboard_Router.py` | `GET/POST /api/dashboard/user/company` — 소속 회사 정보 조회 및 신규 회사 생성(마스터 권한 자동 부여) |
| `user_company_join()` | `B01_Dashboard/B01_Dashboard_Router.py` | `POST /api/dashboard/user/company/join` — 기존 회사 가입 신청 접수 |
| `admin_members()` / `admin_add_member()` / `admin_remove_member()` | `B01_Dashboard/B01_Dashboard_Router.py` | `/api/dashboard/admin/members` — 회사 팀원 목록 조회, 초대 추가 및 제거 |
| `admin_join_requests()` / `admin_process_join_request()` | `B01_Dashboard/B01_Dashboard_Router.py` | `/api/dashboard/admin/join-requests` — 회사 가입 신청 목록 조회 및 승인/거절 처리 |
| `dashboard_update_project()` / `dashboard_delete_project()` | `B01_Dashboard/B01_Dashboard_Router.py` | `/api/dashboard/projects/{id}` — 권한 체크 기반 프로젝트 정보 수정 및 삭제 (`PROJECT_DELETE_HARD_ENABLED` 스위치에 따라 소프트 또는 하드 삭제 실행) |

## 🔗 연관 개념 및 의존성
- `B01_Dashboard_Repository.py` — Raw SQL 기반 회사, 사용자, 프로젝트 DB 조작
- `common_util_project_delete.py` — 프로젝트 하드 삭제 처리 함수 (`hard_delete_project`)
- `common_util_auth.py` — `verify_session`, `require_system_admin` 권한 체크