백엔드 관리하기
백엔드를 배포한 후, Management Console에서 운영에 필요한 모든 것을 할 수 있습니다 — 데이터 조회, 변경 추적, 사용자 관리, 시스템 상태 확인, API 테스트. 터미널이나 데이터베이스 클라이언트가 필요하지 않습니다.
Management Console은 첫 배포 후 /app/console에서 접근할 수 있습니다. 모든 기능을 사용하려면 admin 역할이 필요합니다.
데이터 브라우저
데이터 브라우저에서 Entity 타입별로 데이터베이스의 레코드를 조회하고 관리할 수 있습니다.
레코드 조회
- Console을 열고 Data 탭을 선택합니다
- 사이드바에서 Entity를 선택합니다 (예: Reservation, Customer, Payment)
- 페이지네이션이 적용된 테이블 뷰에서 레코드를 조회합니다
각 컬럼은 Entity 스펙의 필드에 해당합니다. 필드 타입에 따라 렌더링됩니다:
- 날짜는 읽기 쉬운 형식으로 표시됩니다
- Enum 값은 색상 뱃지로 표시됩니다
- 다른 Entity 참조는 클릭 가능한 링크로 표시됩니다
필터링과 정렬
- 컬럼 헤더를 클릭하여 해당 필드로 정렬합니다 (오름차순/내림차순)
- 필터 컨트롤을 사용하여 필드 값으로 결과를 좁힙니다
- 페이지네이션으로 대량 데이터를 탐색합니다
레코드 상세 보기
행을 클릭하면 전체 상세 뷰가 열립니다:
- 모든 필드와 현재 값 (포맷된 JSON)
- Entity 라이프사이클에서의 현재 상태
- 시스템 필드:
id,createdAt,updatedAt,version
소프트 삭제
레코드를 제거하려면 Delete 액션을 사용합니다. Fascia는 소프트 삭제를 사용합니다 — 레코드에 deletedAt 타임스탬프가 표시되지만 물리적으로 삭제되지 않습니다. 이를 통해 완전한 감사 추적이 보 장됩니다.
감사 로그 뷰어
데이터의 모든 변경 사항이 자동으로 기록됩니다. 감사 로그 뷰어에서 누가 무엇을 언제 했는지 정확히 확인할 수 있습니다.
타임라인 읽기
Audit Log 탭을 열면 모든 작업의 시간순 목록을 볼 수 있습니다:
| 컬럼 | 표시 내용 |
|---|---|
| 시간 | 작업이 수행된 시각 |
| 사용자 | 작업을 수행한 사람 (이메일 주소) |
| 작업 | 수행된 내용 (예: create_spec, update, transition) |
| Entity | 영향을 받은 Entity와 레코드 |
필터링
필터를 사용하여 로그를 좁힙니다:
- Entity 타입 — 특정 Entity의 변경 사항만 표시 (예: Reservation 변경만)
- 작업 — 액션 타입별 필터 (생성, 수정, 상태 전이, 삭제)
- 사용자 — 특정 사용자의 액션만 표시
- 날짜 범위 — 특정 기간에 집중
내보내기
Export 버튼으로 감사 로그를 JSON으로 다운로드하여 외부 분석이나 컴플라이언스 기록에 활용합니다.
사용자 & 역할
배포된 백엔드와 상호작용하는 사용자를 관리합니다.
사용자 목록
Users 탭에서 등록된 모든 사용자를 확인할 수 있습니다:
- 이메일 주소와 표시 이름
- 할당된 역할 (뱃지로 표시)
- 계정 상태 (활성 또는 정지)
역할 관리
Fascia는 역할 기반 접근 제어(RBAC)를 사용합니다. 일반적인 역할:
- admin — 모든 Tool과 데이터에 전체 접근
- staff — 운영 Tool에 접근, 제한된 데이터 접근
- customer — 자신의 데이터만 접근 (행 수준 필터링)
사용자의 역할을 변경하려면 역할 뱃지를 클릭하고 드롭다운에서 새 역할을 선택합니다.
사용자 정지
사용자를 임시로 차단해야 하는 경우 Suspend 액션을 사용합니다. 정지된 사용자는 로그인하거나 API를 호출할 수 없습니다. 준비가 되면 Activate 액션으로 재활성화합니다.
모니터링
Monitor 탭에서 시스템 상태를 실시간으로 확인합니다.
헬스 상태
Executor(GCP 프로젝트에서 실행되는 백엔드 엔진)가 정상인지 상태 인디케이터로 표시됩니다. 녹색은 모든 시스템이 정상, 빨간색은 문제가 있음을 나타냅니다.
배포 정보
현재 활성 배포를 확인합니다:
- 배포 버전과 환경 (Development / Production)
- 배포 시각
- 현재 상태
요청 통계
선택한 기간(24시간 또는 7일)의 운영 메트릭을 조회합니다:
- 총 작업 수 — 처리된 Tool 호출 수
- 에러 수 — 실패한 요청 수
- 에러율 — 실패 요청 비율
- 작업 분류 — 어떤 Tool이 가장 많이 호출되는지
API 테스트 콘솔
외부 도구 없이 브라우저에서 직접 배포된 Tool을 테스트합니다.
Tool 선택
- API Test 탭을 엽니다
- 드롭다운에서 배포된 Tool을 선택합니다
- 콘솔이 Tool의 입력 스키마 — 어떤 필드가 필요한지 — 를 표시합니다
테스트 요청 보내기
- 자동 생성된 폼에서 입력 필드를 작성합니다
- Send Request를 클릭합니다
- 응답을 확인합니다 — 상태 코드, 응답 본문, 실행 시간
cURL로 복사
모든 요청을 cURL 명령어로 복사할 수 있습니다. 복사 버튼을 사용하면:
- 팀원과 API 호출을 공유
- 스크립트나 외부 도구에 통합
- 문서화 및 테스트 워크플로우에 활용
다음 단계
- 시작하기 — Fascia로 구축하는 기본 학습
- 예약 시스템 만들기 — 단계별 튜토리얼
- FAQ — 자주 묻는 질문과 문제 해결