260707_1_대시보드정리 1차

.agent/backend.md

@@ -146,9 +146,9 @@
 
 ### 6.4.1 사용자 상태 생명주기 (User Status Lifecycle)
 * **PENDING_EMAIL:** 회원가입 후 이메일 인증 전 (임시)
-* **NO_COMPANY:** 이메일 인증 완료, 회사 미연결 (로그인 가능, B02~B11 워크플로우 차단)
-* **PENDING:** 회사 참여 신청 후 마스터 승인 대기 (로그인 가능, B02~B11 워크플로우 차단)
-* **ACTIVE:** 회사 연결 완료, 모든 기능 접근 가능
+* **NO_COMPANY:** 이메일 인증 완료, 회사 미연결 (로그인 가능, B01_Dashboard 접근 가능, B02~B11 워크플로우 차단)
+* **PENDING:** 회사 참여 신청 후 ADMIN 승인 대기 (로그인 가능, B01_Dashboard 접근 가능, B02~B11 워크플로우 차단)
+* **ACTIVE:** 회사 연결 완료, 모든 기능 접근 가능 (B01_Dashboard + B02~B11)
 * **INACTIVE:** 퇴사/계정 휴활성화
 * **REJECTED:** 회사 참여 신청 거부
 
@@ -233,3 +233,32 @@
   - 재시도 로직 (최대 3회)
   - 템플릿 렌더링 (common_util_email_templates.py)
 * **자세한 내용:** `.agent/email_infrastructure_plan.md` 참고
+
+---
+
+## 7. 시스템 리소스 모니터링 (System Resource Monitoring)
+
+### 7.1 계측 백그라운드 태스크
+* **구현:** `common_util/common_util_resource_monitor.py`의 `sample_resources_loop()`
+* **등록:** `main.py` lifespan에서 `asyncio.create_task`로 시작, 종료 시 cancel (기존 `cleanup_expired_sessions` 패턴과 동일)
+* **계측 주기:** 2분 (`config_system.RESOURCE_SAMPLE_INTERVAL_SEC = 120`)
+* **계측 항목:** CPU(`psutil.cpu_percent`), 메모리(`psutil.virtual_memory().percent`), 디스크(`shutil.disk_usage`)
+* **방어:** 계측 예외는 로깅 후 무시하여 앱 안정성 유지
+
+### 7.2 이중 기록 (DB + 로그 파일)
+* **DB 기록:** `system_resources` 테이블에 INSERT (활성 세션/프로젝트 수 포함) — 대시보드 그래프 조회 소스
+* **로그 파일:** 루트 `log/system_resources.log` 단일 파일에 탭 구분 1줄 append
+  - 형식: `<ISO timestamp>\tcpu=<v>\tmem=<v>\tdisk=<v>\tstorage_mb=<v>`
+  - `log/`는 `.gitignore` 처리 (런타임 생성물)
+
+### 7.3 1개월 롤링 보관 (Retention)
+* **보관 기간:** 30일 (`config_system.RESOURCE_LOG_RETENTION_DAYS = 30`)
+* **DB:** 매 계측 시 `timestamp < NOW() - 30일` 행 DELETE
+* **로그 파일:** 매 계측 시 30일 경과 줄 제거 후 새 줄 추가(오래된 줄 삭제 + 신규 줄 추가 방식) → 파일 크기 무한 증가 방지
+
+### 7.4 리소스 API
+* **엔드포인트:** `GET /api/dashboard/admin/resources?days=30` (SYSTEM_ADMIN 전용, 범위 1~90일)
+* **응답:**
+  - `current`: 요청 시점 실시간 계측값 (그래프 미저장)
+  - `history`: `system_resources` 테이블의 최근 N일 시계열 (그래프 렌더링용)
+  - `stats`: 활성 사용자/프로젝트/저장소 지표