6b1f4c483f
프로젝트 8개 차원 감사(종합 82/100)에서 확정된 상위 3건 수정. 1. 개선 조치(move_actions)가 유일하게 site 스코프 규율에서 이탈 — 스코프 운영자가 타 현장의 조치 기록(카메라 ID·메모·작성자)을 목록에서 읽고, 타 현장 카메라에 조치를 기록해 그 현장 리포트의 전후 효과 지표를 오염시킬 수 있었다. - move_actions.site 컬럼 + (site, taken_at) 인덱스, 기존 행 백필 마이그레이션 - 카메라 소유 현장은 이벤트에서 해석 (move_cameras는 등록 플로우가 없어 항상 비어 있음) - 오타 카메라는 400: 전후 효과가 영원히 0/0이 되는 조치를 애초에 못 만들게 한다 - 타 현장 카메라는 404: 존재 여부를 숨기는 기존 규약 유지 2. README-UPLOAD 업그레이드 절차가 마이그레이션 7종 중 1종만 지시했다. move_ 접두 리네임을 건너뛰면 이후 전부 실패하고 전 요청이 500이 된다 — 순서·적용조건·재실행 비안전성을 표로 명시. 문서 4곳의 테이블 수(10→11)·비프리픽스 표기도 정정. 3. 두 납품 번들 재생성: 8/6 이후 4개 기능 커밋이 반영되지 않아 Report/Export/Actions 컨트롤러와 8/7 마이그레이션이 빠진 채였다. 엣지 소스 패리티도 회복. 검증: pytest 235 passed / PHPUnit 147 passed (PDO 4 skip), 번들 산출물 내부 검증 (28 클래스 해석·전 파일 php -l·SHA256SUMS 55행·휠 11개·HEF 다이제스트 일치).
186 lines
7.2 KiB
Markdown
186 lines
7.2 KiB
Markdown
# 카페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 정보로 바꿉니다.
|
|
|
|
```php
|
|
'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 기록에 남지 않게):
|
|
|
|
```bash
|
|
php -r "echo password_hash('여기에_진짜_비밀번호', PASSWORD_ARGON2ID), \"\n\";"
|
|
```
|
|
|
|
phpMyAdmin → SQL 탭:
|
|
|
|
```sql
|
|
INSERT INTO move_users (username, password_hash, role, site_scope, failed_attempts, locked_until)
|
|
VALUES ('admin', '여기에_해시_붙여넣기', 'admin', NULL, 0, 0);
|
|
```
|
|
|
|
---
|
|
|
|
## 7. 라즈베리파이(장비) 등록
|
|
|
|
장비마다 비밀키를 하나씩 만들어 DB 에 넣습니다.
|
|
|
|
```bash
|
|
php -r "echo bin2hex(random_bytes(32)), \"\n\";"
|
|
```
|
|
|
|
```sql
|
|
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` 가 안 열린다 (열리면 위치가 잘못된 것)
|