Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
Culinary Commons는 Luau로 작성된 모듈식, 서버 권한 백엔드 프레임워크입니다. 이 키트는 레스토랑 스타일의 타이쿤 경험을 구축하는 개발자들에게 신뢰할 수 있는 골격을 제공합니다. 모든 경제 기록과 확장이 서버에서 검증되어 클라이언트가 아닌 서버가 진실 공급원 역할을 합니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 개발 자료 GitHub · 24a98210의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기preview
모듈식이며, 서버 우선(server-first) 시뮬레이션 프레임워크로, 지속적인 경제 기반 경험을 구축할 수 있도록 합니다. 이 환경에서는 모든 원장 기록(ledger entry)이 획득되고, 모든 확장(expansion)이 검증되며, 모든 플레이어의 주방 제국이 신뢰 경계면(trust boundary)의 오른쪽에 존재합니다.
Culinary Commons는 엄격한 Luau로 작성되었으며 Rojo를 통해 연결된 모듈식, 서버 권한 백엔드 프레임워크입니다. 이 프레임워크는 오직 하나의 목적을 가지고 존재합니다: 서버가 단일 진실 공급원(single source of truth)이고 클라이언트가 조종자가 아닌 존중하는 손님인 레스토랑 스타일의 타이쿤 경험을 구축하려는 빌더들에게 신뢰할 수 있는 골격을 제공하기 위함입니다.
다른 타이쿤 키트들이 클라이언트에게 지갑을 건네주고 최선을 바라보는 것과 달리, Culinary Commons는 이 공식을 뒤집습니다. 클라이언트가 요청하고, 서버가 결정합니다. 그리고 영속성(Persistence)은 서버가 결정한 내용을 기록할 뿐입니다. 그 외의 어떤 것도 장부에 손댈 수 없습니다.
이는 공공 광장에 보관된 원장과 은행 금고 안에 보관된 원장의 차이점이라고 생각해보세요. 둘 다 숫자를 기록합니다. 하지만 호기심 많은 낯선 사람과의 접촉에서 살아남는 것은 오직 하나뿐입니다.
이 프레임워크는 네 가지 흔들리지 않는 약속을 기반으로 설계되었습니다:
타이쿤은 그 경제의 인식된 가치에 따라 흥망성쇠를 경험합니다. 플레이어들이 숫자가 허공에서 소환될 수 있다고 느끼는 순간, 전체 루프가 무너집니다. 이는 단 하나의 사건 때문이 아니라 신뢰가 증발하기 때문입니다.
여기서 서버 권한(Server-authoritative) 설계란 다음을 의미합니다:
이것은 편집증이 아닙니다. 이것은 환대입니다. 집주인이 손님이 즐거움에 집중할 수 있도록 진행 상황을 보호하는 것입니다.
트리 구조에 대한 개요:
모든 폴더는 목적을 가지고 있습니다. 트리에 '혹시 몰라서' 존재하는 것은 없습니다.
Culinary Commons는 작고 협력하는 서비스들의 집합체로 구성되었으며, 각 서비스는 정확히 하나의 관심사(concern)를 소유합니다:
The economy의 심장부입니다. 잔액(balances), 거래(transactions), 감사 추적(audit trails)을 소유합니다. 모든 변경 사항은 기록을 생성하며, 결코 조용한 산술 계산이 일어나지 않습니다. 구매가 발생하면, 검토자가 수동으로 재구성할 수 있는 종이 흔적이 남습니다.
어떤 타이쿤 스테이션이 존재하는지, 어떤 것이 잠금 해제되었는지, 그리고 어떤 것이 활성화 대기 중인지를 추적합니다. 이 서비스는 하나의 질문에 잘 답합니다: "지금 당장 이 스테이션이 운영되는 것이 허용되나요?" 가격 책정, 애니메이션 또는 UI는 결정하지 않습니다. 그것들은 다른 곳에 속합니다.
선행 조건(prerequisites)으로 이루어진 방향성 비순환 그래프(directed acyclic graph, DAG)입니다. 업그레이드를 구매하기 전에 이 계층을 참조합니다. UI에서 업그레이드가 제공되기 전에, 동일한 계층을 캐시된 투영(cached projection)을 통해 다시 참조합니다. 두 경우 간의 일관성은 공유 검증기(shared validator)에 의해 강제됩니다.
단일 작성자 직렬화 레이어(single-writer serialization layer)입니다. 세션은 여기에 등록하고, 쓰기는 대기열에 추가되며, 충돌은 기록되고 숨겨지지 않는 '마지막 검증된 쓰기가 승리하는(last-validated-write-wins)' 정책으로 해결됩니다. 저장이 거부되면, 그 거부는 삼켜진 오류가 아니라 일급 객체 이벤트(first-class event)입니다.
내부 이벤트를 위한 타입이 지정된 pub/sub 계층입니다. 이는 클라이언트-서버 경계를 직접 가로지르지는 않습니다. 원격 이벤트는 별도로 선언되고 검증됩니다. 이 버스는 서버가 스스로와 통신하는 것이며, 원격(remotes)은 서버가 외부 세계에 응답하는 것입니다.
any가 없습니다. 타입 시스템은 장식이 아니라 계약입니다.프레젠테이션 계층은 가독성이나 상호 작용의 명확성을 희생하지 않으면서, 컴팩트한 휴대용 방향부터 넓은 데스크톱 레이아웃까지 다양한 뷰포트 크기에 우아하게 적응하도록 설계되었습니다.
클라이언트에 내장된 반응형 UI 고려 사항:
접근성(Accessibility)은 여기에서 체크박스가 아닙니다. 이는 클라이언트를 신뢰할 수 있는 서버에 대한 존중받는 인터페이스로 취급하는 자연스러운 결과입니다.
Culinary Commons의 현지화(Localization)는 단순히 붙이는 것이 아니라 구조적입니다. 플레이어가 접하게 되는 모든 문자열은 안정적인 식별자(stable identifier)로 키가 지정된 현지화 테이블을 거칩니다. 새로운 언어를 추가하는 것은 클라이언트 코드를 다시 작성하는 것이 아니라, 새로운 테이블을 추가하는 것을 의미합니다.
현지화 원칙:
station.upgrade.confirm와 같이 text_042가 아님).그 결과: 코드 분기 없이 어느 지역의 프랜차이즈라도 열 수 있는 레스토랑 제국을 만들 수 있습니다.
타이쿤 경험은 종종 시간대와 플레이어 일정에 걸쳐 진행되기 때문에, 이 프레임워크는 관리자 및 통합자를 위해 **지속적으로 이용 가능한 지원 태세(continuously available support posture)**를 가정합니다:
여기서
이 섹션은 의도적으로 일반적인 종속성 관리자(dependency-manager)의 오케스트레이션을 피합니다. 이 프레임워크는 소스 트리(source tree)이며, 사용자가 선호하는 방식으로 자신의 워크플로우에 통합할 수 있습니다.
필요한 것:
/assets 내에 위치한 Rojo와 호환되는 프로젝트 디스크립터(project descriptor).일반적인 흐름:
/src/server, /src/shared, 그리고 /src/client가 예상되는 서비스 컨테이너로 매핑되게 합니다./assets에 포함된 플레이스 템플릿(place template)을 열고, 서비스 토폴로지(service topology)가 디스크립터와 일치하는지 확인합니다./shared/schemas를 검토하세요 — 스키마는 이 프레임워크의 어휘입니다./tests에서 시뮬레이션 하네스(simulation harness)를 실행하여 환경이 올바르게 연결되었는지 확인합니다.만약 동기화되지 않는 것이 있다면, 문제는 거의 항상 프레임워크 자체에 있는 것이 아니라 프로젝트 디스크립터의 경로 불일치(path mismatch) 때문입니다.
설정은 /src/shared/constants 아래의 일반 Luau 테이블에 존재합니다. 숨겨진 환경 변수나 원격 파일에서 가져오는 마법 같은 문자열(magic strings)은 없습니다.
구성 카테고리:
모든 구성 값은 문서화된 기본값과 문서화된 안전 범위를 가집니다. 범위 밖의 값은 런타임(runtime)이 아닌 시작 시점(startup)에 거부됩니다.
타이쿤 게임에서 저장 기능은 단순한 세션과 스토리를 가르는 경계입니다. Culinary Commons는 영속성(persistence)을 일급 서브시스템으로 다룹니다: