📖 라이믹스 웹앱(WebApp) 모듈 & 게시판 스킨 사용 설명서
(개인 서버에서만 작동 테스트 됨, 다른 곳에서는 안될수 있음)

1단계. 서버에 파일 업로드

1. 다운로드한 rhymix_webapp_package.zip의 압축을 풉니다.
2. 라이믹스가 설치된 웹 루트 디렉토리에 그대로 업로드합니다.
   • 모듈 경로: 라이믹스_루트/modules/webapp/
   • 스킨 경로: 라이믹스_루트/modules/board/skins/kimsaem_board_app/

---

2단계. 라이믹스 관리자 설정 (모듈 업데이트 & 게시판 연동)

1. 관리자 페이지 > 고급 > 설치된 모듈로 이동합니다.
2. 목록에서 웹앱 런처 (webapp) 모듈 우측의 [업데이트] 버튼을 클릭하여 DB 테이블(rx_webapp)을 생성/동기화합니다.
3. 상단 또는 좌측 메뉴의 웹앱 런처 설정 페이지로 들어갑니다.
4. 웹앱 배포 허용 게시판 설정에 웹앱을 등록할 게시판의 module_srl 번호를 입력하고 저장합니다. (예: 123, 여러 개인 경우 123, 145)

   TIP

   게시판의 module_srl은 사이트 제작/편집 > 사이트 메뉴 편집이나 **게시판 설정 페이지의 주소창(module_srl=...)**에서 확인할 수 있습니다.

---

3단계. 웹앱 전용 게시판 스킨 적용

1. 사이트 제작/편집 > 게시판 목록에서 연동할 게시판의 **[설정]**으로 들어갑니다.
2. 스킨 설정에서 **Kimsaem's WebApp Board**를 선택하고 저장합니다.
   • 이 스킨은 카드형 목록에서 곧바로 [앱 실행] 버튼을 노출하고, 상세 글 상단에 웹앱 바로가기 런처 배너 카드를 표시해 줍니다.

---

4단계. 웹앱 ZIP 파일 제작 및 글 작성 규칙

1. 웹앱 파일 패키징 규칙:
   • HTML/JS/CSS 또는 빌드된 정적 웹앱(React, Vue, 바닐라 JS 등)의 **index.html이 압축 파일의 최상위(루트)**에 있어야 합니다.
   • 압축 파일 이름은 **영문/숫자/하이픈(-)**으로 지정하는 것을 권장합니다. (예: tetris-game.zip, photo-editor.zip)

     파일명이 앱의 고유 슬러그(app_slug)로 자동 등록됩니다.

2. 게시판 글 등록:
   • 연동된 게시판에서 새 글 작성을 누릅니다.
   • 글 제목과 앱 설명을 작성합니다.
   • 준비한 .zip 파일을 본문에 첨부한 후 글을 등록합니다.

---

5단계. 자동 배포 및 웹앱 실행 확인

1. 글을 등록(또는 수정)하는 즉시:
   • 서버의 files/apps/{slug}/ 경로에 안전하게 자동 압축 해제됩니다.
   • 악성 파일 실행 방지용 보안 .htaccess가 자동 배치됩니다.
2. 게시글 확인:
   • 글 본문 상단에 WebApp Launcher 카드 배너가 자동으로 나타납니다.
   • 목록에서도 앱 실행 버튼이 활성화됩니다.
3. 웹앱 실행:
   • 버튼을 클릭하면 다음 공식 주소로 연결되며, 라이믹스 레이아웃 없이 깔끔한 풀스크린 웹앱 화면이 렌더링됩니다:

   • 게시판 열람 권한이 연동되어 있어, 비로그인 제한 게시판인 경우 권한 없는 사용자의 접근이 자동으로 차단됩니다.