본문으로 건너뛰기

자주 묻는 질문

일반​

Fascia란 무엇인가요?​

Fascia는 코드 작성 없이 프로덕션 백엔드 시스템을 구축할 수 있는 플랫폼입니다. 구조화된 스펙(Entity, Tool, Policy)으로 비즈니스 로직을 기술하면, Fascia가 데이터베이스, API, 인증 등을 포함한 완전히 작동하는 백엔드를 생성하여 여러분의 Google Cloud 프로젝트에 배포합니다.

BYOC란 무엇인가요?​

**BYOC (Bring Your Own Cloud)**는 모든 데이터와 런타임 인프라가 여러분의 Google Cloud 프로젝트에 존재한다는 의미입니다. Fascia는 절대 비즈니스 데이터를 저장하거나 처리하지 않습니다. Fascia 플랫폼은 설계 스펙과 배포 메타데이터만 저장합니다. 고객 데이터, 데이터베이스, API 엔드포인트는 모두 여러분의 클라우드 환경에서 실행됩니다.

런타임에 AI가 사용되나요?​

아닙니다. Fascia는 설계 단계에서만 AI를 사용합니다 — Chat Studio에서 아이디어를 구조화된 스펙으로 변환할 때입니다. 배포 후 백엔드는 AI 호출 없이 결정론적 실행 엔진에서 작동합니다. 모든 API 요청은 매번 동일한 예측 가능한 Execution Contract를 따릅니다.

무료 사용 제한은 어떻게 되나요?​

현재 무료 티어에서 각 계정은 다음 제한이 있습니다:

  • Entity 10개 (Reservation, Customer 등의 비즈니스 객체)
  • Tool 20개 (API 엔드포인트, 예약 작업, 웹훅 핸들러)
  • GCP 프로젝트 1개 연결
  • 워크스페이스 1개

더 필요하시면 문의해 주세요.

시작하기​

Google Cloud 계정이 필요한가요?​

네, 백엔드를 배포하려면 GCP 프로젝트가 필요합니다. Fascia가 프로젝트에 Cloud Run, Cloud SQL 등의 리소스를 프로비저닝합니다. 아직 없다면 무료 GCP 계정을 만들 수 있습니다 — Google이 신규 계정에 $300 크레딧을 제공합니다.

GCP 연결 없이 사용해볼 수 있나요?​

네! GCP 연결 없이도 Chat Studio와 Flow Studio에서 Entity와 Tool을 설계할 수 있습니다. Risk 분석 검토와 스펙 미리보기도 가능합니다. GCP는 배포할 준비가 되었을 때만 필요합니다.

템플릿은 어떻게 사용하나요?​

처음 로그인하면 Fascia가 빠르게 시작할 수 있는 템플릿을 제안합니다:

  1. 웰컴 화면에서 템플릿으로 시작을 클릭합니다
  2. 템플릿을 선택합니다 (예: 예약 시스템)
  3. 템플릿이 Entity와 Tool 세트를 워크스페이스에 미리 로드합니다
  4. Chat Studio나 Flow Studio에서 커스터마이즈할 수 있습니다

배포는 얼마나 걸리나요?​

일반적인 첫 배포는 2-5분 소요됩니다. 데이터베이스 프로비저닝, 실행 엔진 배포, 데이터베이스 마이그레이션 실행을 포함합니다. 이후 배포는 인프라가 이미 갖춰져 있어 더 빠릅니다.

설계 & 구축​

Entity와 Tool의 차이는 무엇인가요?​

  • Entity = 데이터 모델입니다. 추가 기능이 있는 데이터베이스 테이블로 생각하세요 — 상태 라이프사이클, 비즈니스 규칙(invariant), 접근 제어가 포함됩니다.
  • Tool = 백엔드 로직입니다. 누군가 API를 호출할 때 일어나는 일 — 데이터 읽기, 데이터 쓰기, 이메일 전송, 결제 처리 등입니다. 각 Tool은 단계를 정의하는 플로우 그래프로 구성됩니다.

Yellow risk는 무엇을 의미하나요?​

Risk Engine은 모든 Tool을 Green, Yellow, Red로 분류합니다:

  • Green — 배포해도 안전합니다. 모든 쓰기가 트랜잭션 내에 있고, 원시 SQL 없고, 무제한 쿼리 없습니다.
  • Yellow — 확인 후 배포 가능합니다. 잠재적 우려 사항이 있습니다 (예: 재시도 없는 외부 API 호출, 결제 작업). 우려 사항을 확인하고 인정해야 배포할 수 있습니다.
  • Red — 차단됩니다. 심각한 안전 문제가 있습니다 (예: 트랜잭션 경계 누락, 무제한 업데이트). 배포 전에 수정해야 합니다.

커스텀 코드를 사용할 수 있나요?​

전통적인 의미로는 아닙니다. Fascia의 실행은 스펙 기반입니다 — 코드를 작성하는 대신 플로우 노드(Read, Write, Transform, If/Switch 등)를 사용하여 시각적으로 로직을 설계합니다. 계산 값과 조건에는 부작용이 없는 제한된 표현 언어인 Value DSL을 사용합니다.

이는 의도적입니다: 결정론적 실행은 백엔드가 예측 가능하고, 감사 가능하며, 설계부터 안전함을 의미합니다.

API에 인증을 어떻게 추가하나요?​

Fascia에는 내장된 인증 시스템이 포함되어 있습니다. 배포하면 백엔드가 자동으로 다음을 갖추게 됩니다:

  • 회원가입과 로그인 (이메일 + 비밀번호)
  • 소셜 로그인 (Google, Apple, Kakao)
  • JWT 토큰 (액세스 + 리프레시)
  • 역할 기반 접근 (admin, staff, customer 또는 커스텀 역할)
  • 행 수준 접근 (사용자는 자신의 데이터만 조회)

별도 설정이 필요 없습니다 — 모든 배포에 포함됩니다.

배포​

배포가 실패하면 어떻게 하나요?​

배포가 실패한 경우:

  1. Deploy 페이지에서 에러 메시지를 확인합니다 — 보통 무엇이 잘못되었는지 알려줍니다
  2. 일반적인 원인: GCP 권한 문제, 데이터베이스 마이그레이션 충돌, 잘못된 스펙
  3. 문제를 수정하고 다시 배포합니다
  4. 이전 배포는 영향을 받지 않습니다 — 실패한 배포가 이미 실행 중인 것을 덮어쓰지 않습니다

롤백은 어떻게 하나요?​

새 배포에 문제가 발생하면 이전 버전을 재배포할 수 있습니다. Deploy 페이지에서 마지막 성공 배포를 찾아 재배포합니다.

Development과 Production 환경을 분리할 수 있나요?​

네. Deploy 페이지는 여러 환경을 지원합니다. 먼저 Development에 배포하고, 변경 사항을 테스트한 후, 모든 것이 정상적으로 작동하면 Production으로 승격할 수 있습니다.

Fascia가 어떤 GCP 리소스를 생성하나요?​

배포 시 Fascia가 프로비저닝하는 리소스:

  • Cloud Run — 백엔드 로직을 실행하는 실행 엔진을 호스팅
  • Cloud SQL (PostgreSQL) — 비즈니스 데이터 저장
  • Cloud Scheduler — 예약된 Tool 실행 (크론 작업)
  • Secret Manager — API 키와 자격 증명을 안전하게 저장

모든 리소스는 최소한의 필요 권한으로 GCP 프로젝트에 생성됩니다.

문제 해결​

비밀번호를 잊었어요​

로그인 페이지에서 비밀번호 찾기 링크를 사용하세요. 새 비밀번호를 설정할 수 있는 링크가 포함된 비밀번호 재설정 이메일을 받게 됩니다.

GCP 연결이 안 돼요​

일반적인 해결 방법:

  1. 권한 확인 — Google 계정에 GCP 프로젝트의 Owner 또는 Editor 역할이 필요합니다
  2. 결제 활성화 — GCP는 Cloud Run과 Cloud SQL에 결제가 활성화되어야 합니다
  3. API 확인 — 프로젝트에서 Cloud Run, Cloud SQL, Secret Manager API가 활성화되어 있는지 확인합니다

Tool이 에러를 반환해요​

  1. Management Console의 감사 로그에서 에러 상세를 확인합니다
  2. Flow Studio의 Risk Engine 경고를 확인합니다 — Yellow 신호가 문제를 나타낼 수 있습니다
  3. Entity invariant를 확인합니다 — 데이터가 비즈니스 규칙을 충족하지 않으면 트랜잭션이 롤백됩니다

데이터가 보이지 않아요​

일반적인 원인 확인:

  • 소프트 삭제 — 삭제로 표시된 레코드는 일반 쿼리에서 숨겨집니다. 실제로 제거된 것이 아닙니다.
  • 행 수준 접근 — customer 역할로 로그인한 경우 자신의 레코드만 볼 수 있습니다. 모든 데이터를 보려면 admin 계정으로 전환하세요.
  • 페이지네이션 — 대량 데이터셋은 페이지로 나뉩니다. 더 많은 페이지가 있는지 확인하세요.

추가 도움​