메인 콘텐츠로 건너뛰기

Documentation Index

Fetch the complete documentation index at: https://teeemai.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

앱 패키지(App Pack) 프레임워크는 단일 app.yaml 설정 파일로 CRUD 앱, 대시보드, 운영 도구를 자동 생성합니다. 데이터베이스 스키마, REST API, Slack 슬래시 명령어, 이벤트 알림, 웹 UI까지 한 번에 배포됩니다.

​
무엇을 만들 수 있나요

재고/주문 관리

상품 카탈로그, 주문 상태 추적, 배송 알림.

작업 관리 (Todo)

팀별 작업 보드, 담당자 지정, 마감일 알림.

사내 위키

부서별 지식 페이지, 검색, 버전 관리.

고객/거래처 CRM

연락처, 활동 로그, 후속 작업 알림.

KPI 대시보드

실시간 지표, 임계치 알림, 주간 보고서.

후원/스폰서십 관리

계약, 결제 상태, 갱신 알림.
이 외에도 사내에서 흔히 엑셀이나 노션으로 관리하던 작업이라면 대부분 앱 패키지로 옮길 수 있습니다.

​
작동 방식

app.yaml (설정 파일)
   ↓
[자동 생성]
   ├── PostgreSQL 스키마 (테이블, 인덱스, 관계)
   ├── REST API (CRUD + Aggregate)
   ├── Slack 슬래시 명령어 (/orders, /products 등)
   ├── 이벤트 알림 (주문 상태 변경 → Slack 채널 발송)
   └── 웹 UI (Next.js, 자동 생성 목록·상세 화면)
조직의 PostgreSQL 인스턴스에 별도 스키마(app_{name})로 격리되어, 에이전트 데이터와 충돌하지 않습니다.

​
에이전트와의 통합

앱이 활성화되면 에이전트가 다음 도구를 통해 데이터를 읽고 쓸 수 있습니다.
도구용도
app_query모델 검색 (필터, 정렬, 페이지네이션)
app_aggregate집계 (count, sum, avg)
app_create새 레코드 생성
app_update레코드 수정
app_delete레코드 삭제
이는 클라이언트별로 분리된 도구가 아니라 통합된 도구 세트입니다 — 직원이 자연어로 명령하면 에이전트가 알아서 올바른 앱과 모델을 선택합니다. 
사용자: "@Teeem 이번 주 배송된 주문이 몇 개야?"
  ↓
에이전트: app_aggregate({model: "order", filter: {status: "shipped", week: "this"}, fn: "count"})
  ↓
"이번 주 배송 완료된 주문은 47건입니다."

​
Slack 통합

앱별로 다음을 자동으로 얻습니다.
  • 슬래시 명령어: /products, /orders, /inventory 같은 명령어로 직접 검색
  • 이벤트 알림: 데이터 변경 시 지정된 채널 또는 DM으로 알림 
    notifications:
  order.status.changed:
    channel: "#orders"
    template: "주문 {order_number}이(가) {status} 상태로 변경되었습니다"
    filter: { status: [shipped, delivered] }
  • 자연어 쿼리: “@Teeem 이번 달 매출 알려줘” → 자동으로 적절한 모델·집계 선택

​
웹 UI

각 앱은 자체 Next.js 웹 UI를 가집니다 (/{org}-admin.teeem-ai.com/apps/{name}). 자동 생성되는 화면:
  • 목록 뷰 — 정렬, 필터, 페이지네이션
  • 상세 뷰 — 단일 레코드의 전체 필드 + 편집 폼
  • 사용자 정의 페이지 — pages/dashboard.tsx 같은 React 컴포넌트 추가 가능
기술 스택: Next.js 16 (App Router) · React 19 · Tailwind v4 · TanStack Query · shadcn/ui · 라이트 모드 일관 적용 · Noto Sans KR 한글 최적화 폰트.

​
어떻게 시작하나요

조직에 맞는 앱이 필요하다면 영업팀 또는 도입 담당자와 이야기하세요. 표준 앱 패턴(주문, 재고, 작업, 위키 등)은 수일 내 배포 가능하며, 커스텀 모델/페이지는 데이터 모델만 합의되면 한두 주 안에 가능합니다.

앱 도입 문의

현재 어떤 도구를 쓰고 계신지(엑셀? 노션? 사내 시스템?) 알려주시면 적합한 앱 구조를 제안드립니다.

​
데이터 격리

  • 스키마 격리: 각 앱은 app_{name} 별도 스키마. 다른 앱이나 에이전트 데이터와 충돌 불가.
  • 테넌트 격리: 조직마다 별도 PostgreSQL 인스턴스. 다른 고객사의 데이터는 물리적으로 다른 곳에 저장됩니다.
  • 권한: Slack 사용자 ID로 인증. 앱별로 누가 읽고 쓸 수 있는지 RBAC 적용.