move_detect/server/deploy/README-UPLOAD.md

카페24 업로드 안내

이 폴더의 내용물을 카페24 FTP 최상위에 그대로 올리면 됩니다. 고칠 파일은 config.php 하나뿐입니다.

---

1. 올리는 위치 (제일 중요)

폴더 2개만 올리면 됩니다. move_detect_app 과 www.

/                          <- FTP 최상위
├── (기존 사이트 파일)        <- 건드리지 않습니다
├── move_detect_app/       <- [올리기 1] 통째로. 웹에서 안 보입니다
│   ├── config.php            여기만 고칩니다
│   ├── src/
│   ├── vendor/
│   ├── storage/snapshots/    사진 저장
│   └── schema.sql            DB 넣고 나면 지웁니다
└── www/                   <- 원래 있던 폴더 (다른 사이트가 씀)
    ├── (기존 사이트 파일)     <- 건드리지 않습니다
    └── move_detect/       <- [올리기 2] 이 폴더만 새로 생깁니다
        ├── index.php
        ├── .htaccess
        ├── _preflight.php
        └── assets/

접속 주소는 https://내도메인/move_detect/ 입니다.

README-UPLOAD.md(이 파일)는 올릴 필요 없습니다.

왜 move_detect_app 을 www 밖에 두나: config.php 에 DB 비밀번호가, storage/snapshots/ 에 작업자 사진이 들어갑니다. www 안에 있으면 같은 www 를 쓰는 다른 사이트 주소로 접근될 수 있습니다. 한 폴더로 묶은 건 최상위에 있는 남의 파일(vendor/, config.php 같은 흔한 이름)과 겹쳐 덮어쓰는 사고를 막기 위해서입니다.

업로드가 끝나면 FTP 클라이언트에서 권한을 지정하세요. zip 과 FTP 는 유닉스 권한을 옮기지 못하므로, 패키지에 넣어둔 권한은 올리는 순간 사라집니다.

대상	권한
move_detect_app/config.php	600 (DB 비밀번호가 들어있습니다)
move_detect_app/storage/snapshots/	750

_preflight.php 가 실제 권한과 노출 여부를 확인해줍니다.

---

2. config.php 고치기

DB 세 줄만 카페24 관리자 페이지의 MySQL 정보로 바꿉니다.

'db_dsn'  => 'mysql:host=localhost;dbname=여기에_DB이름;charset=utf8mb4',
'db_user' => '여기에_MySQL아이디',
'db_pass' => '여기에_MySQL비밀번호',

나머지 값은 그대로 두면 됩니다. 비밀번호는 메일/메신저/깃에 올리지 마세요.

---

3. DB 만들기

처음 설치(빈 DB)

1. 카페24 관리자 → phpMyAdmin 열기
2. 이 앱용 DB 선택
3. Import(가져오기) 탭 → schema.sql 선택 → 실행
4. 표 11개가 생겼는지 확인
5. 서버에서 schema.sql 삭제 — 남겨둘 이유가 없습니다

schema.sql 은 항상 최신 상태입니다. 처음 설치라면 아래 마이그레이션은 실행하지 마세요 (이미 반영되어 있어 충돌합니다).

이미 쓰던 DB 업그레이드(기존 데이터 있음)

⚠️ 기존 DB에 schema.sql 을 다시 Import 하면 CREATE TABLE 충돌로 실패합니다. 대신 마이그레이션을 실행하세요.

반드시 아래 순서대로, 아직 적용하지 않은 것부터 전부 실행합니다. 하나라도 건너뛰면 그 컬럼·표를 쓰는 요청이 전부 500 이 됩니다. 순서가 중요한 이유는 뒤 파일이 앞 파일이 만든 표 이름(move_ 접두사)을 전제하기 때문입니다.

순서	파일	무엇이 바뀌나
1	2026-07-17-p1-9-p3-2b.sql	site / event_uuid 컬럼 + 인덱스, 기존 이벤트 site 백필
2	2026-07-20-move-table-prefix.sql	모든 표 이름에 move_ 접두사 부여 (이 단계를 건너뛰면 이후 전부 실패)
3	2026-08-06-zone-rules.sql	존 점유 규칙(rules_json)
4	2026-08-06-heatmap-spatial.sql	히트맵 좌표(spatial_x, spatial_y)
5	2026-08-06-false-positive-tag.sql	오탐 태그 컬럼
6	2026-08-07-improvement-actions.sql	개선 조치 표(move_actions)
7	2026-08-08-actions-site.sql	개선 조치의 현장(site) 스코프

1. phpMyAdmin → 해당 DB → SQL 탭
2. 위 표의 순서대로 파일 내용을 하나씩 붙여넣고 실행합니다 (각 파일 첫머리에 적용 조건이 주석으로 적혀 있습니다)
3. 각 파일 맨 아래 검증 쿼리로 컬럼·표가 생겼는지 확인
4. 전부 끝난 뒤에 새 코드를 배포합니다

이미 적용한 마이그레이션을 다시 실행하면 "Duplicate column" 같은 오류가 납니다 — 재실행은 안전하지 않으니, 어디까지 적용했는지 기록해 두세요. 어디까지 했는지 모르겠으면 phpMyAdmin 의 Structure(구조) 탭에서 위 표의 컬럼·표가 있는지 하나씩 확인하면 됩니다.

---

4. HTTPS 켜기

카페24 관리자에서 무료 SSL 인증서를 켭니다.

선택이 아니라 필수입니다. 로그인 세션 쿠키가 cookie_secure=true 라서, HTTP 로는 브라우저가 쿠키를 아예 안 보냅니다 → 로그인이 안 됩니다.

---

5. 점검하기

브라우저에서 엽니다:

https://내도메인/move_detect/_preflight.php

전부 OK 여야 합니다. 실패한 줄에 무엇을 하면 되는지 적혀 있습니다.

특히 이 둘은 카페24 요금제에 따라 없을 수 있고, 없으면 카페24에 문의해야 합니다:

항목	없으면 생기는 일
Argon2id	로그인 페이지가 즉시 죽습니다. 제일 흔한 실패 원인입니다.
gd	이벤트는 저장되는데 사진만 조용히 사라집니다. 에러도 안 납니다.

확인이 끝나면 www/move_detect/_preflight.php 를 지우세요.

---

6. 관리자 계정 만들기

앱에 회원가입 기능이 없습니다. 첫 계정은 직접 넣습니다.

비밀번호 해시를 만듭니다(로컬 PC 에서 실행 — 평문이 phpMyAdmin 기록에 남지 않게):

php -r "echo password_hash('여기에_진짜_비밀번호', PASSWORD_ARGON2ID), \"\n\";"

phpMyAdmin → SQL 탭:

INSERT INTO move_users (username, password_hash, role, site_scope, failed_attempts, locked_until)
VALUES ('admin', '여기에_해시_붙여넣기', 'admin', NULL, 0, 0);

---

7. 라즈베리파이(장비) 등록

장비마다 비밀키를 하나씩 만들어 DB 에 넣습니다.

php -r "echo bin2hex(random_bytes(32)), \"\n\";"

INSERT INTO move_devices (device_id, name, secret, config_version)
VALUES ('pi-01', '3라인 낙상 카메라', '여기에_비밀키_붙여넣기', 1);

같은 값을 파이 쪽 /etc/move-detect/edge.env 의 DEVICE_SECRET 에 넣습니다. CAFE24_URL 에는 https://내도메인/move_detect 를 넣습니다. (앱이 서브폴더에 있으므로 뒤의 /move_detect 까지 반드시 포함해야 합니다.)

비밀키는 메일/메신저로 보내지 마세요.

---

8. 마지막 확인

• https://내도메인/move_detect/login 이 열린다
• admin 으로 로그인되고 대시보드가 뜬다
• schema.sql 을 서버에서 지웠다
• www/move_detect/_preflight.php 를 서버에서 지웠다
• https://내도메인/move_detect_app/config.php 가 안 열린다 (열리면 위치가 잘못된 것)