# JusQ 1.0

JusQ 1.0은 PHP 8 및 MySQL 8 환경에 맞게 정비한 설치형 웹사이트·게시판 패키지입니다.

## 권장 환경

- Ubuntu Linux + Apache 2.4
- PHP 8.4 이상
- MySQL 8.0 이상
- PHP 확장: mysqli, mbstring, gd, zip, xml, fileinfo, curl
- HTTPS 사용 권장

## 설치

1. 압축 파일의 내용을 웹사이트 문서 루트에 업로드합니다.
2. 설치하는 동안 웹서버가 `files`, `_tmp`, `_var`, `pages`, `modules/admin/var/users`와 각 모듈의 `_setting` 폴더에 쓸 수 있도록 권한을 설정합니다.
3. 웹브라우저로 사이트 주소에 접속합니다.
4. 설치 화면에서 DB 정보, 관리자 정보, 사이트 정보를 입력합니다.
5. 설치 완료 후 관리자 페이지에 로그인하여 환경설정을 확인합니다.

설치 프로그램은 DB 파일이나 테이블을 만들기 전에 필요한 쓰기 권한을 검사합니다. 권한이 부족하면 일부만 설치하지 않고 원인을 안내합니다.

기본 테이블 접두어는 `jus`를 권장합니다.

## 파일 업로드

- 기본 업로드 한도는 이미지와 일반 파일 모두 최대 500MB입니다.
- 실제 허용 크기는 PHP와 웹서버의 업로드 제한보다 클 수 없으므로 서버 설정도 함께 확인하세요.
- 실행파일과 스크립트 등 위험 확장자는 업로드할 수 없습니다.

## 소셜 로그인

관리자 페이지의 소셜링크 설정에서 네이버, 구글, 페이스북, X의 Client ID와 Client Secret을 등록할 수 있습니다. 각 개발자센터에는 설정 화면에 표시되는 Callback URL을 정확히 등록해야 합니다.

## 배포본 제외 항목

- 운영 서버의 DB 접속정보와 테이블 매핑
- 운영 도메인 및 사이트별 설정
- 회원·게시글 등 운영 DB 데이터
- 업로드 자료, 세션, 캐시, 백업 파일
- 소셜 로그인 비밀키
- 별도 마켓 상품으로 제공되는 바이오리듬 위젯

## 보안 안내

- 설치 직후 관리자 비밀번호를 12자 이상으로 설정하세요.
- HTTPS를 적용하세요.
- `_var`와 `_tmp` 디렉터리에 직접 웹 접근이 허용되지 않도록 확인하세요.
- 운영 DB 접속정보와 소셜 로그인 Secret을 소스 저장소에 올리지 마세요.
