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

업그레이드 / upgrade-0-10

0.10으로 올리기

스키마는 버전 4예요. 삭제하면 휴지통으로 가고, 예약은 cron 호출이 있어야 실행돼요. 화면 네 개에 새 부품이 생겼어요.

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

0.10.0은 0.7.0 다음에 나온 첫 npm 릴리스이고, 0.8.0과 0.9.0이 들어 있어요. 0.7.0에서 올린다면 0.8로 올리기를 먼저 하세요. 0.9.0은 따로 할 일이 없어요.

1. 스키마 버전 4#

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

추가만 하는 단계라 두 번 실행해도 괜찮아요.

  • cms_documents의 열 (deleted_at, deleted_by, schedule, due_at, review), cms_versions의 열 (label, pinned, approved_by, approved_at), cms_assets의 열 (deleted_at, deleted_by)
  • 표 cms_comments, cms_releases, cms_saved_filters, cms_presence

Drizzle 스키마에서 다른 표 옆에 cmsComments, cmsReleases, cmsSavedFilters, cmsPresence를 다시 내보내세요.

2. 삭제하면 휴지통으로 가요#

cms.remove, DELETE /collections/:c/:slug, delete_document 도구, 파일 삭제는 예전에는 바로 지웠어요. 이제는 문서나 파일을 휴지통에 30일 동안 둬요.

  • 휴지통의 문서는 get, list, 검색, 에이전트에게 보이지 않아요. 주소는 그대로 차지해요. 복구하거나 영구 삭제하기 전에는 같은 슬러그로 문서를 만들 수 없어요(slug_in_trash).
  • 휴지통의 파일은 영구 삭제할 때까지 버킷에 남아 있어요. 공개 주소도 그때까지 열려요.
  • createCms({ trash: { days: 0 } })이면 예전처럼 바로 지워요. 삭제 뒤에 행 수를 세는 테스트는 이 설정을 쓰거나 cms.trash.purge(admin, "all")을 부르세요.
  • 오래된 휴지통은 cms.runScheduled()가 돌 때 비워져요(다음 절).

3. 예약과 휴지통을 위한 cron 호출#

예약 게시와 휴지통 비우기는 cms.runScheduled()가 돌 때 실행돼요. createCms({ cronSecret })을 설정하고 몇 분마다 이 경로를 부르세요.

text
POST /api/cms/_cron
Authorization: Bearer <cronSecret>

GET으로 불러도 돼요. cronSecret이 없으면 이 경로는 404로 답해요. Vercel에서는 CRON_SECRET을 둔 cron 작업이 바로 이 헤더를 보내요. 두 곳에서 동시에 불러도 안전해요.

note

스스로 게시되는 것은 없어요. 아무도 이 경로를 부르지 않으면 예약한 문서는 시각이 지나도 "예약됨"으로 남아요.

4. 어드민 화면#

npx @mainsoft/agent-cms add --update
npx @mainsoft/agent-cms add cms-trash cms-releases
  • cms-doc-editor에 파일이 두 개 늘었어요: cms-flow.tsx, cms-paste.ts.
  • cms-doc-list는 shadcn의 label이 필요해요. cms-versions는 dialog와 input이 필요해요.
  • cms-shell은 편집할 수 있는 사람에게 "릴리스"와 "휴지통"을 보여 줘요. hrefFor가 받는 대상에 releases와 trash가 생겼으니 앱에 두 경로를 추가하세요.
  • cms-preview-comments는 선택이에요. "댓글 허용"으로 만든 링크를 받은 외부 사람이 공개 미리보기 페이지에서 쓰는 댓글 상자예요.

5. 검토는 켜야 생겨요#

컬렉션이 요청하기 전에는 아무것도 달라지지 않아요.

ts
defineCollection({ slug: "guide", review: { agents: "required" } });

이렇게 하면 API 키와 사람을 대신하는 에이전트는 아무도 승인하지 않은 버전을 게시할 수 없어요(review_required). everyone: "required"이면 사람도 자기가 요청한 검토를 스스로 승인할 수 없어요.

6. 타입 변경#

CmsDoc에 deletedAt, deletedBy, schedule, dueAt, review가 생겼어요. CmsVersion에는 label, pinned, approvedBy, approvedAt, DocSummary에는 schedule과 review, DocCounts에는 scheduled와 review, CmsAsset에는 deletedAt, deletedBy가 생겼어요.

직접 만든 CmsRepo에는 새 메서드(updateVersion, 댓글, 릴리스, 필터, 함께 편집)가 필요하고, findDoc, findDocById, findAsset은 { trashed }를 받아요. MemoryRepo와 DrizzleRepo에는 이미 들어 있어요.