Skip to content
agent-cms
업그레이드 / 0.13으로 올리기

업그레이드 / upgrade-0-13

0.13으로 올리기

스키마 버전 7은 자동화와 역할을 담는 표 하나를 더합니다. 새 화면 네 개. 쓰기 전에는 기존 앱에 바뀌는 것이 없습니다.

수정 2026년 11월 21일편집 docs seed버전 1
이 페이지

1. 스키마 버전 7#

새 표 하나: cms_records. 자동화, 자동화 실행 기록, 역할을 담습니다. 기존 표는 바뀌지 않습니다.

npx @mainsoft/agent-cms migrate check
npx @mainsoft/agent-cms migrate apply     # 또는 `migrate print`로 SQL을 받아 직접 실행

Drizzle 스키마 파일에서 표를 다시 내보내고 있다면 cmsRecords를 추가하세요 (새로 init 하면 들어 있습니다).

2. 역할은 만들기 전에는 아무것도 바꾸지 않습니다#

누가 무엇을 할 수 있는지는 이 순서로 정해집니다: 시스템, 코드에 적은 컬렉션의 access 함수, 역할, 기본값(관리자만). 역할을 하나도 만들지 않은 앱은 전과 똑같이 동작합니다. 자동화, 역할, 대시보드를 보세요.

3. 자동화는 cron 호출 때 실행됩니다#

자동화의 일은 백그라운드 작업이라, 웹훅을 보내는 것과 같은 POST /_cron 호출 때 실행됩니다. 화면에서 새로 만든 자동화는 꺼진 채로 시작합니다.

4. 화면#

npx @mainsoft/agent-cms add --update가 cms-shell(대시보드, 자동화, 역할, 가져오기와 내보내기)과 cms-messages를 가져옵니다. 그다음 새 화면을 더하고 각각 페이지를 만드세요.

npx @mainsoft/agent-cms add cms-dashboard cms-automations cms-roles cms-transfer
화면페이지메뉴가 보이는 사람
CmsDashboard/admin/dashboard로그인한 모든 사람
CmsAutomations/admin/automations관리자
CmsRoles/admin/roles관리자
CmsTransfer/admin/transfer관리자

5. REST와 CLI#

  • 새 경로: GET /openapi.json, GET /_stats, GET /export, POST /import, /automations…, /roles…. GET /_me가 dashboard, automations, roles를 돌려줍니다.
  • openapi.json은 이제 예약된 이름이라 컬렉션의 슬러그로 쓸 수 없습니다.
  • 새 명령: export <dir> [--with-files], import <dir>, import <file> --from json|csv|wordpress, openapi. 내보내기와 가져오기, OpenAPI와 다른 서버를 보세요.
  • 새 입구 @mainsoft/agent-cms/adapters/node.

6. 타입#

  • CreateCmsOptions에 users와 automations가 생겼습니다.
  • 직접 만든 CmsRepo에는 레코드 메서드(insertRecord, findRecord, findRecordByKey, listRecords, updateRecord, deleteRecords)와 versionsSince가 필요합니다. MemoryRepo와 DrizzleRepo에는 있습니다.
  • 새 오류 코드: name_taken, role_not_found, role_last_admin, forbidden_roles, automation_not_found, automation_invalid, forbidden_automations.