기존 시스템 확장하기

ObjectOS를 검토하는 대부분의 팀은 이미 기록 시스템을 가지고 있습니다 — CRM, ERP, 티켓팅 도구, 프로덕션 SQL 또는 MongoDB 데이터베이스 위에 자리한 자체 제작 백오피스 같은 것들입니다. 문제는 좀처럼 "이것을 버리고 다시 만들어야 할까?"가 아닙니다. 그것은 "위험한 마이그레이션 없이, 이미 가지고 있는 것을 AI 네이티브로 만들 수 있을까?"입니다.

이 페이지가 설명하는 것이 바로 그 길입니다: 기존 데이터베이스에 ObjectOS를 연결하고, 관심 있는 테이블을 객체로 모델링한 다음, AI 에이전트가 그 데이터를 쿼리하고 분석하고 그에 따라 행동하게 하는 것 — 여러분의 권한 아래에서, 여러분의 인프라 위에서, 원래 시스템은 그대로 둔 채로 말입니다.

이 변화의 형태

여러분은 비즈니스 시스템을 대체하지 않습니다. ObjectOS를 그 옆에 두고 동일한 데이터베이스를 가리키게 합니다:

1. 기존 데이터베이스를 데이터소스로 연결합니다. 자격 증명은 환경에서 가져오며, 분석만 하려는 경우 연결은 읽기 전용일 수 있습니다.
2. 테이블을 객체로 모델링합니다 — 직접 손으로 하거나, 코딩 에이전트가 스키마를 스캔하여 소스 수준의 객체 파일을 여러분을 위해 생성하게 합니다.
3. 각 객체를 데이터소스에 바인딩합니다(객체별로, 또는 네임스페이스 전체에 대한 라우팅 규칙으로).
4. AI를 사용합니다 — 테이블이 객체가 되는 순간, 모든 에이전트, 도구, 플로우, 대시보드가 그 위에서 작동하며, 자동으로 올바른 데이터베이스로 라우팅됩니다.

레거시 애플리케이션에 대해서는 아무것도 변하지 않습니다. 행은 있던 자리에 그대로 있습니다. ObjectOS는 그 위에 얹히는 AI 네이티브, 권한 인식 표면이 됩니다.

다시 작성하지 않고도 이것이 작동하는 이유

코딩 에이전트로 객체 생성하기

기존 스키마를 가져오는 가장 빠른 방법은 코딩 에이전트(예: Claude Code)를 사용하여 비즈니스 테이블을 스캔하고 소스 수준의 객체 정의를 생성하는 것입니다 — 테이블당 *.object.ts 파일 하나씩.

hotcrm 레퍼런스 앱은 그 결과물이 취해야 할 정확한 형태를 보여줍니다: 각 테이블은 타입이 지정된 Field.* 정의와 외래 키를 위한 Field.lookup(...)를 사용하는 ObjectSchema.create({ … })로 src/objects/<name>.object.ts가 되며, defineStack으로 조립됩니다. 에이전트는 연결된 데이터베이스를 인트로스펙트하고, 컬럼을 필드 타입에 매핑하며, 여러분이 소유하고 커밋하는 객체를 작성합니다. 맞는 것은 유지하고, 노출하고 싶지 않은 컬럼은 버리며, 그 위에 레이블, 유효성 검사, 권한을 추가합니다.

전체 단계별 작성 가이드는 데이터소스를 참조하세요.

첫날에 얻는 것

테이블이 기존 데이터베이스에 바인딩된 객체로 모델링되고 나면:

• 자연어 분석. 사용자가 실제 레코드에 대해 질문하고 — "이번 분기에 지연된 거래는 어떤 것이고 누가 담당인가요?" — 그 답은 ObjectQL을 통해 실시간 데이터에 대해 계산됩니다.
• 거버넌스가 적용된 자동화. 플로우와 액션은 동일한 데이터를 읽고 (허용된 경우) 쓸 수 있으며, 모든 단계가 감사됩니다.
• 생성된 API와 Console. REST/GraphQL 엔드포인트와 관리 화면이 동일한 메타데이터에서 나옵니다 — 추가 통합 계층이 없습니다.
• 하나의 권한 모델. 사람에게 적용되는 경계가 AI 트래픽에도 동일하게 적용됩니다.

이것이 향하는 곳

위의 흐름은 이미 출시된 빌딩 블록으로 오늘날 작동합니다. 더 풍부한 턴키 페더레이션 경험 — 한 단계 스키마 가져오기, 외부 소유 스키마 바인딩, 내장 안전 게이트 — 는 ADR-0015 아래에서 활발히 설계 중입니다(상태: Proposed). 그것이 도착하기 전까지, 문서화된 경로 — 연결, 모델링, 바인딩, 쿼리 — 가 기존 시스템을 확장하는 지원되는 방식입니다.

여기서 시작하세요

• 데이터소스 — 데이터베이스 연결, 객체 바인딩, 쿼리 라우팅
• AI 에이전트 — 여러분의 객체 위에서 작동하는 선언적 에이전트
• 권한 — AI가 상속하는 모델
• Quickstart — 몇 분 안에 런타임을 띄우기