Download the PHP package cms-orbit/announcement without Composer

CMS Orbit Announcement

cms-orbit/announcement는 Orbit 문서 엔진 위에 구축된 공지사항 패키지입니다.
관리자에서는 DocumentEntity 기반 CRUD로 공지를 관리하고, 프런트에서는 목록/상세 공개 페이지와 사이트맵 URL을 함께 제공합니다.

주요 기능

• cms-orbit/core 기반 문서형 공지 콘텐츠
• 다국어 documents / document_contents 저장 구조
• Orbit 관리자 CRUD 자동 등록
• 공개 목록/상세 페이지 제공
• 갤러리 첨부, 공개 시각(public_at), 공지 여부(is_notice) 지원
• 사이트맵/SEO 노출용 공개 URL 제공

설치

cms-orbit/core가 먼저 설치·설정(orbit:install)되어 있어야 합니다.

Laravel Boost

이 패키지는 resources/boost/guidelines/announcement.md, resources/boost/skills/announcement-development/를 제공합니다.

• Boost 최초 설정: 호스트에서 php artisan boost:install 1회
• 이후: orbit:install / orbit:sync가 이 패키지를 Boost에 등록하고 boost:update 실행 (Boost가 이미 설정된 경우)

호스트 설정

관리자 CRUD·공개 라우트·번역은 패키지 Service Provider가 자동 등록합니다. 호스트 routes/web.php 수정은 필요하지 않습니다.

빠른 시작

1. 관리자에서 공지 관리

설치 후 Orbit 관리자 Documents 섹션에 공지 엔티티가 자동 등록됩니다.
제목, 슬러그, 본문, 설명, 갤러리, 공개 시각, 승인 상태를 한 화면에서 관리할 수 있습니다.

2. 공개 페이지 연결

패키지는 다음 공개 라우트를 제공합니다.

• announcements.index
• announcements.show

기본 경로는 아래와 같습니다.

3. Inertia 페이지 (자동)

php artisan orbit:frontend-sync가 호스트 resources/js/pages/announcement/*.tsx 브리지를 생성합니다. 커스터마이징이 필요할 때만 아래처럼 직접 re-export 하세요.

어떤 데이터가 추가되나요?

• 공지 전용 마이그레이션
• 공지 모델과 팩토리
• 관리자 Entity 설명자
• 공개 컨트롤러와 웹 라우트
• 한국어 번역 리소스

운영 팁

• slug를 비워두면 자동 생성 흐름을 사용할 수 있게 설계되어 있습니다.
• 공개 상세 URL은 엔티티의 showUrl()과 사이트맵 URL 생성에 함께 사용됩니다.
• 공개 시각과 승인 상태를 같이 써두면 발행 시점을 맞춘 운영이 수월합니다.

업데이트 노트

4.3.1

• inertiajs/inertia-laravel ^3.0 을 명시 선언했습니다: AnnouncementController 가 Inertia::render() 를 가드 없이 쓰는데 선언이 없어 cms-orbit/core 를 통한 전이 의존에 기대고 있었습니다. core 가 이 의존을 정리하는 순간 조용히 깨집니다.

4.3.0

• cms-orbit/core ^4.5 → ^4.6: core 4.6.0 이 OrbitAccess 라우팅 리졸버와 여러 관리자 화면 수정(PostgreSQL 500, strict mode, orbit:install 의 OrbitProvider 미등록)을 담고 있습니다.
• GitHub Actions 워크플로 추가: php 8.4·8.5 로 composer validate 와 pint --test 를 돌리는 ci.yml, 그리고 태그의 composer.json version 이 태그명과 일치하는지 확인하는 release-guard.yml. Packagist 는 불일치 태그를 조용히 무시합니다.
• 위성 패키지의 CI 는 cms-orbit/core 를 Packagist 게시본으로 받으므로, "지금 게시된 core 와 이 패키지의 제약이 함께 해석되는가" 까지 같이 검증합니다.
• pint 포맷 정규화: pint --test 를 CI 게이트로 걸려면 기존 코드가 설정에 맞아야 해서 함께 정규화했습니다. 순수 포맷 변경이며 동작은 바뀌지 않습니다.

4.2.0

• laravel/framework ^11.0 || ^12.0 || ^13.0 → ^13.0: Laravel 13 전용으로 좁혔습니다.
• cms-orbit/core ^4.4 → ^4.5.
• 왜 좁혔나: Pest 5 를 채택한 4.4.0(패키지별 4.1.0)부터 pest-plugin-laravel 5 가 laravel/framework ^13.23 을 요구해, 이 저장소의 테스트가 Laravel 13 으로만 해석됩니다. 즉 Laravel 11·12 호환성을 더 이상 검증할 수 없는 상태로 그 범위를 광고하고 있었습니다. 검증되지 않는 지원 범위를 제약에 남겨두지 않기로 했습니다.
• Laravel 11·12 사용자는 업그레이드가 필요합니다. 이번 변경은 실제로 지원 구성을 제거하므로, php 하한 상향과 달리 소비자에게 직접 영향이 있습니다. Laravel 13 으로 올리거나 이전 버전에 머물러야 합니다.

4.1.0

• php 제약 ^8.3 → ^8.4: php 8.3 환경에서는 더 이상 설치되지 않습니다.
• cms-orbit/core ^4.1 → ^4.4.
• 생산 의존은 하나도 바뀌지 않았습니다. php 하한 상향으로 새로 받게 된 패키지는 Pest 5 계열(require-dev)뿐입니다. cms-orbit 전 패키지의 직접 의존 20개를 최신판과 전수 대조했고, 나머지 18개는 이미 php ^8.3 에서 최신을 받고 있었습니다. 이번 상향은 기능 확보가 아니라 장기 정리 목적입니다.
• 소비자의 Laravel 11·12 지원은 유지됩니다 (laravel/framework ^11.0 || ^12.0 || ^13.0).

4.0.3

• php 제약 ^8.3 복구: 게시된 태그는 모두 ^8.3 이었으나 main 에서 ^8.2 로 내려가 있었습니다. Laravel 13 은 php ^8.3 을 요구하므로 php ^8.2 + laravel/framework ^13 조합은 php 8.2 환경에서 조용히 Laravel 11 을 설치합니다.
• laravel/pint ^1.14 → ^1.30 (1.30 이 php ^8.3 을 요구).
• 릴리스 파이프라인 도입: .githooks/pre-push 가 composer.json 의 version 필드와 태그명이 어긋난 태그의 푸시를 차단합니다. cms-orbit/core 의 4.0.8 태그가 version: 4.0.7 로 만들어져 Packagist 가 아무 오류 없이 그 태그를 무시했고, 4.0.8 이 게시되지 않은 사실을 아무도 알지 못한 사고가 있었습니다. bin/release <버전> 이 version 갱신·검증·커밋·태그·푸시를 한 동작으로 묶어 이 드리프트를 원천 차단하고, cms-orbit/* 의존이 실제로 Packagist 에 게시되어 있는지 Composer 리졸버로 확인합니다. 저장소를 클론해 composer install 하면 core.hooksPath 가 자동 설정됩니다.

License

MIT