ObjectOS템플릿
포크 가능한 스타터 패키지 — `todo`, `contracts`, `procurement`, `helpdesk` 등.
템플릿
템플릿은 포크 가능한 스타터 패키지입니다. 각 템플릿은 marketplace에서 클릭 한 번으로 설치하거나, CLI로 클론하여 확장할 수 있는 TypeScript 코드베이스를 얻을 수 있는 실제로 형태를 갖춘 앱입니다.
템플릿이 존재하는 두 가지 이유:
- 말보다 보여주기 — 동작하는 멀티 오브젝트 앱은 문서보다 더 빠르게 읽힙니다.
- 엔지니어링 팀에 출발점 제공 — DB에 AI가 생성한 메타데이터만이 아니라, 소스 관리 하에 있는 코드를 원할 때.
기본 카탈로그에 포함되는 것
| 템플릿 | 도메인 | 포크 가능한 스타터 용도… |
|---|---|---|
todo | 작업 및 프로젝트 | "어떤 식으로든 그룹화된 할 일" 도구 일체 |
contracts | AI 조항 추출 기능이 있는 CLM | 승인 + 문서 AI |
procurement | 공급업체, 발주서, 3-way 매칭 | 승인 체인 + 입고 |
compliance | SOC 2 / ISO 27001 통제 | 증거 수집 워크플로우 |
helpdesk | AI 우선 고객 지원 | 티켓 + SLA + AI 코파일럿 |
content | 편집 일정 + 채널 ROI | 라이프사이클 + 지표 |
hr | 디렉터리, 조직도, 휴가 | 인력 중심 앱 |
project | 프로젝트 / 작업 / 마일스톤 추적 | PM 도구 |
출처: github.com/objectstack-ai/templates. Apache-2.0. 묻지 말고 포크하세요.
30초 만에 설치 (코드 불필요)
Console에서:
- Marketplace를 열고 → 템플릿을 검색합니다.
- Install을 클릭합니다.
- 새로고침하면 — 새 앱이 내비게이션에 나타납니다.
완료. 레코드, 뷰, 플로우, 권한 — 모두 즉시 사용 가능합니다.
코드베이스로 포크 (엔지니어용)
pnpm dlx @objectstack/cli create my-app --template todo
cd my-app
pnpm install
pnpm dev # http://localhost:4002클론은 자체 완결적인 pnpm 패키지로 — *.object.ts, *.view.ts,
*.flow.ts 파일을 편집, 린트, 테스트, 커밋할 수 있습니다. 만족스러우면:
pnpm build
os package publish # → your marketplace여러분의 포크를 설치하는 고객은 여러분의 브랜드와 여러분의 수정 사항을 받게 됩니다.
템플릿 헌장 (사회적 계약)
모든 템플릿은 범위와 엄격한 한계를 선언하는 CHARTER.md를 함께 제공합니다 —
일반적으로: 비즈니스 오브젝트 6개 이하, src/ 하위 2,500 LOC 이하, 앱 1개,
기본 로케일 1개. 헌장은 템플릿이 절반만 완성된 제품이 아니라 템플릿으로
유지되도록 하기 위해 존재합니다. 포크가 이러한 한계를 초과하면, 기존 템플릿을
부풀리지 말고 새로운 템플릿으로 출시하세요.
파일 접미사 프로토콜(*.object.ts, *.state.ts, *.hook.ts, …),
작성 순서(오브젝트 → 상태 → 훅 → 뷰 → 플로우 → …), 그리고 재발명하는 대신
재사용해야 하는 다형성 플랫폼 서비스(sys_comment, sys_attachment,
sys_audit_log)에 대해서는 업스트림
TEMPLATE_GUIDE.md를
참고하세요.
출발점 선택하기
| 만들고 있는 것이… | 이것을 포크하세요 | 이유 |
|---|---|---|
| "무언가"를 추적하는 내부 도구 일체 | todo | 모든 프리미티브를 가장 작고 깔끔하게 보여줌 |
| 승인 체인이 있는 무엇이든 | procurement 또는 contracts | 실제 승인 프로세스가 연결되어 있음 |
| AI가 포함된 고객 대면 무엇이든 | helpdesk | 에이전트 + 티켓 코파일럿 패턴 |
| 규제 산업 워크플로우 | compliance | 감사 + 증거 + 통제 매핑 |
| 인력 / 조직도 앱 | hr | 디렉터리 + 보고 구조 |
AI Builder + 템플릿 함께 사용하기
템플릿을 포크하고 그 위에서 AI Builder를 여전히 사용할 수 있습니다.
helpdesk를 설치한 다음 이렇게 말하세요:
"
hd_ticket에csat_score정수 필드를 추가하고, 범위는 1–5, 마감 시 입력하도록 요청해줘."
AI는 설치된 패키지를 그 자리에서 확장합니다. os package export로 변경
사항을 소스 저장소에 푸시하세요.
다음으로 갈 곳
- AI Builder — 채팅으로 모든 템플릿 확장
- Packages — 템플릿이 실제로 무엇인지
- Marketplace — 여러분의 포크 배포
- Quickstart — 개발자 경로의 전체 엔드투엔드