새 팀이 GyroX 를 처음 도입할 때 따라가면 되는 완결형 다중 챕터 가이드. 워크스페이스 설계, 데이터 모델, 권한, 첫 자동화까지 한 흐름으로 안내합니다.
1. 개요
GyroX 는 대화가 끝나기 전에 앱이 만들어지는 AI 네이티브 운영 플랫폼입니다. 이 온보딩북은 첫 워크스페이스를 만드는 순간부터 실제 업무 자동화를 배포하기까지의 전 과정을 한 흐름으로 안내합니다.
이 문서는 순서대로 읽도록 설계되었습니다. 각 챕터는 앞 챕터의 결과물을 전제로 합니다.
- 소요 시간: 약 18분 + 실습 30분
- 대상: 도입 담당자, 관리자, 첫 빌더
- 사전 준비: 조직 이메일 도메인, 도입할 ERP 모듈 1개
2. 워크스페이스 설계
워크스페이스는 한 조직의 운영 단위입니다. 단일 워크스페이스 안에서 여러 ERP 모듈(GL, AP, AR, P2P 등)을 활성화하고, 멤버를 초대하며, 권한을 부여합니다.
- 1조직 이메일로 워크스페이스를 생성합니다.
- 2첫 도입 ERP 모듈 한 개만 활성화합니다(파일럿 원칙).
- 3핵심 운영자 2~3명을 초대합니다.
- 4브랜딩(로고·테마)을 디자인 토큰으로 설정합니다.
디자인 토큰은 DB → API → CSS 변수 → Tailwind 체인으로 흐릅니다. 색상을 코드에 하드코딩하지 마세요.
3. 데이터 모델 매핑
GyroX 는 자산·시설·공간을 별도 테이블이 아닌 단일 리소스 온톨로지(인스턴스 + 분류 + 동적 스키마 + 속성)로 표현합니다. 기존 분류 체계는 새 테이블을 만드는 대신 typeKey 로 흡수합니다.
- 자산 분류는 ASSET_CATEGORY 신설 대신 typeKey 로 정규화합니다.
- 공간 9단계 계층은 동적 스키마로 흡수합니다.
- 감사 주체는 ACTOR(사람·AI·시스템)로 설정합니다.
4. 권한과 SSO
파일럿 단계에서는 최소 권한으로 시작하고, 확산 단계에서 SSO 와 역할 매핑을 통합하는 것이 안전합니다. 모든 접근은 기본 거부(deny-by-default) 정책을 따릅니다.
- 1관리자/운영자/뷰어 3개 기본 역할로 시작합니다.
- 2Entra ID / OIDC 공급자를 연결합니다.
- 3역할-그룹 매핑을 IdP 그룹 클레임으로 자동화합니다.
5. 첫 자동화 배포
마지막 챕터에서는 자연어로 첫 업무 화면을 요청하고, 생성된 위젯을 검토한 뒤 공유 링크로 팀에 배포합니다. 모든 AI 호출은 AI 게이트웨이를 경유하므로 비용과 감사 로그가 일원화됩니다.
자동화가 외부 시스템을 변경한다면, 승인 게이트와 멱등성 키를 먼저 설계하세요. 중복 실행 방지는 운영 안정성의 출발점입니다.
여기까지 완료하면 단일 모듈 파일럿이 운영 준비 상태가 됩니다. 다음은 KPI 30일 측정입니다.