feat(expense): 개인경비 모듈 + ERP 좌측메뉴 셸 + expense_db 연결

- ERP 셸: 좌측 사이드바 + 상단 헤더 + 콘텐츠 영역(erp_base.html) - 분기: 슈퍼관리자 → 업무모듈 카드, 일반사용자 → ERP 메인(erp_home.html) - 신규 라우트: /modules (슈퍼관리자 모듈 카드 재진입) - 개인경비 모듈: app/modules/expense/ (라우터/저장소/템플릿) - JSON 저장소(ExpenseStore) + PostgreSQL 저장소(ExpenseDBStore) - 팩토리: EXPENSE_DB_URL 있으면 DB, 없으면 JSON 폴백 - DB: scripts/sql/expense_db_init.sql (멱등 DDL, postgres-db 컨테이너) - expense_db, 역할 expense_app, 테이블 expense_items, 인덱스/트리거 - 마이그레이션: scripts/migrate_expense_json_to_db.py (멱등, --dry-run) - 의존성: psycopg[binary,pool]>=3.2 - 환경변수: EXPENSE_DB_URL 추가 - 문서: CLAUDE.md 작업 기준 + docs/{PROJECT_OVERVIEW,SERVER_ARCHITECTURE,DATABASES,DEPLOYMENT}.md - main-app 배포 경로 /opt/www/main 고정 명시 - 위험 명령(DROP/TRUNCATE/rm -rf/volume 삭제) 사용자 승인 정책
2026-05-29 02:21:03 +09:00
parent d7b6c7d029
commit 9c58b022e2
19 changed files with 2337 additions and 5 deletions
@@ -0,0 +1,288 @@
+/* ════════════════════════════════════════════════════
+   ERP Shell — 좌측 사이드바 + 우측 콘텐츠 레이아웃
+   erp.css 의 토큰을 그대로 사용한다. 같이 로드 필수.
+   ════════════════════════════════════════════════════ */
+
+:root {
+  --erp-sidebar-w: 240px;
+  --erp-sidebar-w-collapsed: 64px;
+  --erp-topbar-h: 56px;
+}
+
+/* ── 페이지 전체 컨테이너 ── */
+body.erp-app-body { background: var(--color-canvas-white); min-height: 100vh; }
+
+.erp-app {
+  display: grid;
+  grid-template-columns: var(--erp-sidebar-w) 1fr;
+  min-height: 100vh;
+  transition: grid-template-columns .18s ease;
+}
+.erp-app:has(.erp-sidebar[data-collapsed="true"]) {
+  grid-template-columns: var(--erp-sidebar-w-collapsed) 1fr;
+}
+
+/* ── 사이드바 ── */
+.erp-sidebar {
+  position: sticky; top: 0;
+  height: 100vh;
+  border-right: 1px solid var(--color-subtle-ash);
+  background: var(--color-canvas-white);
+  display: flex; flex-direction: column;
+  overflow: hidden;
+  z-index: 40;
+}
+
+.erp-sidebar-head {
+  height: var(--erp-topbar-h);
+  display: flex; align-items: center; justify-content: space-between;
+  padding: 0 var(--sp-12) 0 var(--sp-16);
+  border-bottom: 1px solid var(--color-subtle-ash);
+  flex-shrink: 0;
+}
+.erp-sidebar-brand {
+  display: inline-flex; align-items: center; gap: var(--sp-8);
+  color: var(--color-deep-black);
+}
+.erp-sidebar-logo { height: 22px; width: auto; display: block; }
+.erp-sidebar-system {
+  font-weight: 600; font-size: 14px; letter-spacing: -0.2px;
+}
+.erp-sidebar[data-collapsed="true"] .erp-sidebar-system { display: none; }
+
+.erp-sidebar-toggle {
+  width: 28px; height: 28px; border-radius: 8px;
+  display: inline-flex; align-items: center; justify-content: center;
+  background: transparent; border: 1px solid transparent; cursor: pointer;
+  color: var(--color-midtone-gray);
+}
+.erp-sidebar-toggle:hover { background: var(--color-ghost-gray); color: var(--color-deep-black); }
+.erp-sidebar[data-collapsed="true"] .erp-sidebar-toggle svg { transform: rotate(180deg); }
+
+.erp-sidebar-nav {
+  flex: 1; overflow-y: auto;
+  padding: var(--sp-12) var(--sp-8);
+  display: flex; flex-direction: column; gap: 2px;
+}
+
+.erp-sidebar-group {
+  font-size: 11px; font-weight: 600;
+  color: var(--color-midtone-gray);
+  text-transform: uppercase; letter-spacing: 0.06em;
+  padding: var(--sp-12) var(--sp-12) var(--sp-6);
+}
+.erp-sidebar[data-collapsed="true"] .erp-sidebar-group { opacity: 0; height: 0; padding: 0; pointer-events: none; }
+
+.erp-sidebar-item {
+  display: flex; align-items: center; gap: 10px;
+  padding: 8px var(--sp-12);
+  border-radius: 10px;
+  color: var(--color-rich-black);
+  font-size: 14px; font-weight: 500;
+  cursor: pointer;
+  transition: background .12s ease, color .12s ease;
+  border: 1px solid transparent;
+  text-decoration: none;
+  white-space: nowrap;
+}
+.erp-sidebar-item:hover:not(.is-disabled) { background: var(--color-ghost-gray); }
+.erp-sidebar-item.is-active {
+  background: var(--color-deep-black);
+  color: var(--color-canvas-white);
+}
+.erp-sidebar-item.is-disabled {
+  color: var(--color-midtone-gray);
+  cursor: not-allowed;
+}
+.erp-sidebar-icon {
+  width: 18px; height: 18px;
+  display: inline-flex; align-items: center; justify-content: center;
+  flex-shrink: 0;
+}
+.erp-sidebar-label { flex: 1; }
+.erp-sidebar-badge {
+  background: var(--color-ghost-gray); color: var(--color-midtone-gray);
+  padding: 2px 8px; border-radius: var(--r-badge);
+  font-size: 11px; font-weight: 500;
+}
+.erp-sidebar-item.is-active .erp-sidebar-badge {
+  background: rgba(255,255,255,0.18); color: var(--color-canvas-white);
+}
+.erp-sidebar-ext { color: var(--color-midtone-gray); display: inline-flex; }
+
+.erp-sidebar[data-collapsed="true"] .erp-sidebar-label,
+.erp-sidebar[data-collapsed="true"] .erp-sidebar-badge,
+.erp-sidebar[data-collapsed="true"] .erp-sidebar-ext {
+  display: none;
+}
+.erp-sidebar[data-collapsed="true"] .erp-sidebar-item { justify-content: center; padding: 8px 0; }
+
+.erp-sidebar-foot {
+  padding: var(--sp-8);
+  border-top: 1px solid var(--color-subtle-ash);
+  display: flex; flex-direction: column; gap: 2px;
+  flex-shrink: 0;
+}
+
+/* ── 콘텐츠 영역 ── */
+.erp-content { display: flex; flex-direction: column; min-width: 0; }
+
+.erp-topbar {
+  height: var(--erp-topbar-h);
+  position: sticky; top: 0; z-index: 30;
+  background: var(--color-canvas-white);
+  border-bottom: 1px solid var(--color-subtle-ash);
+  display: flex; align-items: center; justify-content: space-between;
+  padding: 0 var(--sp-24);
+  gap: var(--sp-16);
+}
+.erp-topbar-left { display: flex; align-items: center; gap: var(--sp-12); min-width: 0; }
+.erp-topbar-title h1 {
+  font-size: 16px; font-weight: 600; margin: 0; line-height: 1.2;
+  letter-spacing: -0.2px;
+}
+.erp-topbar-title p {
+  margin: 2px 0 0; color: var(--color-midtone-gray); font-size: 12px;
+}
+.erp-topbar-right { display: flex; align-items: center; gap: var(--sp-12); }
+
+.erp-sidebar-mobile-toggle {
+  display: none;
+  width: 32px; height: 32px; border-radius: 8px;
+  align-items: center; justify-content: center;
+  background: transparent; border: 1px solid var(--color-subtle-ash); cursor: pointer;
+  color: var(--color-rich-black);
+}
+
+.erp-page {
+  padding: var(--sp-24);
+  max-width: 1280px; width: 100%; margin: 0 auto;
+}
+
+/* ── 홈 대시보드 타일 ── */
+.erp-hero { margin: var(--sp-8) 0 var(--sp-24); }
+.erp-hero-title { font-size: 28px; font-weight: 600; margin: 0; letter-spacing: -0.6px; }
+.erp-hero-sub { margin: 6px 0 0; color: var(--color-midtone-gray); font-size: 13px; }
+
+.erp-home-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fill, minmax(280px, 1fr));
+  gap: var(--sp-16);
+}
+.erp-tile {
+  border: 1px solid var(--color-subtle-ash);
+  border-radius: var(--r-card);
+  padding: var(--sp-20);
+  background: var(--color-canvas-white);
+  display: flex; flex-direction: column; gap: 8px;
+}
+.erp-tile-head {
+  display: flex; align-items: center; justify-content: space-between; margin-bottom: 4px;
+}
+.erp-tile-label {
+  font-size: 11px; color: var(--color-midtone-gray); text-transform: uppercase; letter-spacing: 0.08em;
+}
+.erp-tile-title { margin: 0; font-size: 18px; font-weight: 600; letter-spacing: -0.3px; }
+.erp-tile-desc { margin: 0 0 8px; color: var(--color-midtone-gray); font-size: 13px; }
+.erp-tile-list { margin: 0; padding-left: 18px; color: var(--color-rich-black); font-size: 13px; }
+.erp-tile-list li { margin: 4px 0; }
+
+/* ── 개인경비 페이지 ── */
+.erp-expense { display: flex; flex-direction: column; gap: var(--sp-20); }
+
+.erp-summary-grid {
+  display: grid;
+  grid-template-columns: repeat(auto-fit, minmax(140px, 1fr));
+  gap: var(--sp-12);
+}
+.erp-summary-card {
+  border: 1px solid var(--color-subtle-ash);
+  border-radius: var(--r-card);
+  padding: var(--sp-16);
+  display: flex; flex-direction: column; gap: 6px;
+  background: var(--color-canvas-white);
+}
+.erp-summary-card--mini { padding: var(--sp-12) var(--sp-16); }
+.erp-summary-label { font-size: 12px; color: var(--color-midtone-gray); }
+.erp-summary-value { font-size: 20px; font-weight: 600; letter-spacing: -0.3px; font-variant-numeric: tabular-nums; }
+.erp-summary-value--sm { font-size: 16px; }
+
+.erp-card-block {
+  border: 1px solid var(--color-subtle-ash);
+  border-radius: var(--r-card);
+  background: var(--color-canvas-white);
+  overflow: hidden;
+}
+.erp-card-block-head {
+  display: flex; align-items: baseline; justify-content: space-between;
+  padding: var(--sp-16) var(--sp-20);
+  border-bottom: 1px solid var(--color-subtle-ash);
+}
+.erp-card-block-head h2 { margin: 0; font-size: 15px; font-weight: 600; letter-spacing: -0.2px; }
+.erp-muted { color: var(--color-midtone-gray); font-size: 12px; }
+
+.erp-form-grid {
+  display: grid; grid-template-columns: repeat(4, minmax(0,1fr));
+  gap: var(--sp-12); padding: var(--sp-16) var(--sp-20);
+}
+.erp-field { display: flex; flex-direction: column; gap: 4px; font-size: 12px; color: var(--color-midtone-gray); }
+.erp-field-wide { grid-column: span 2; }
+.erp-field input, .erp-field select {
+  border: 1px solid var(--color-subtle-ash);
+  border-radius: var(--r-input);
+  padding: 6px 10px;
+  font-family: inherit; font-size: 14px; color: var(--color-rich-black);
+  background: var(--color-canvas-white);
+  outline: none;
+}
+.erp-field input:focus, .erp-field select:focus {
+  border-color: var(--color-rich-black);
+  box-shadow: 0 0 0 3px rgba(0,0,0,0.06);
+}
+.erp-form-actions {
+  grid-column: 1 / -1;
+  display: flex; justify-content: flex-end; gap: var(--sp-8);
+  padding-top: 4px;
+}
+
+.erp-btn-sm { padding: 4px 10px !important; font-size: 12px !important; }
+
+.erp-table-wrap { overflow-x: auto; }
+.erp-table { width: 100%; border-collapse: collapse; font-size: 13px; }
+.erp-table thead th {
+  text-align: left;
+  font-weight: 500; color: var(--color-midtone-gray);
+  padding: 10px var(--sp-16);
+  border-bottom: 1px solid var(--color-subtle-ash);
+  background: var(--color-canvas-white);
+}
+.erp-table tbody td {
+  padding: 10px var(--sp-16);
+  border-bottom: 1px solid var(--color-subtle-ash);
+  vertical-align: top;
+}
+.erp-table tbody tr:last-child td { border-bottom: 0; }
+.erp-table tbody tr:hover { background: var(--color-ghost-gray); }
+.erp-row-sub { font-size: 12px; color: var(--color-midtone-gray); margin-top: 2px; }
+.erp-empty { text-align: center; color: var(--color-midtone-gray); padding: var(--sp-24); }
+
+/* ── 반응형 ── */
+@media (max-width: 900px) {
+  .erp-app { grid-template-columns: 0 1fr; }
+  .erp-sidebar {
+    position: fixed; left: 0; top: 0; height: 100vh;
+    width: var(--erp-sidebar-w);
+    transform: translateX(-100%);
+    transition: transform .2s ease;
+    box-shadow: 0 0 0 1px var(--color-subtle-ash);
+  }
+  .erp-sidebar.is-open { transform: translateX(0); }
+  .erp-sidebar-mobile-toggle { display: inline-flex; }
+  .erp-form-grid { grid-template-columns: 1fr 1fr; }
+  .erp-field-wide { grid-column: span 2; }
+}
+@media (max-width: 560px) {
+  .erp-form-grid { grid-template-columns: 1fr; }
+  .erp-field-wide { grid-column: auto; }
+  .erp-page { padding: var(--sp-16); }
+}