feat: rename app to Last Signal

Rename service, UI, storage, and target-path configuration; clarify expiration cleanup behavior.
This commit is contained in:
2026-09-30 11:55:58 +09:00
parent d56c6ea1ac
commit aeaa1b37c2
19 changed files with 115 additions and 85 deletions

View File

@@ -1,4 +1,4 @@
# Collection Keeper 설치 가이드
# Last Signal 설치 가이드
이 문서는 컴퓨터를 잘 모르는 분도 따라할 수 있도록 작성했습니다.
@@ -12,16 +12,18 @@
## 1. 이 프로그램이 하는 일
Collection Keeper는 웹페이지에 들어와서 가끔 클릭해 주는 작은 서비스입니다.
Last Signal은 웹페이지에 들어와서 가끔 생존 확인 버튼을 눌러주는 서비스입니다.
- 클릭하면 "아직 살아있음" 기록이 남습니다.
- 일정 기간 동안 아무도 클릭하지 않으면, 미리 준비한 스크립트가 실행됩니다.
- NAS에서는 `/home/zenn/Collection` 폴더를 삭제하도록 설정되어 있습니다.
- 확인이 설정된 기간 동안 없으면 지정된 스크립트를 실행합니다.
- 기본 스크립트는 `/home/zenn/Collection` 폴더 **안의 내용 전체를 삭제**합니다. 폴더 자체는 남습니다.
중요:
- 웹앱이 직접 폴더를 지우지 않습니다.
- 실제 삭제는 `scripts/cleanup.sh`가 담당합니다.
- 웹앱이 직접 파일을 지우지는 않습니다. 기본 `scripts/cleanup.sh`가 `TARGET_PATH`의 내용을 삭제합니다.
- `docker-compose.yml`에서 호스트 폴더를 컨테이너에 마운트하고, `TARGET_PATH`에는 컨테이너 쪽 경로를 지정합니다.
---
@@ -173,7 +175,7 @@ config/default.json
| --- | --- | --- |
| `threshold_days` | `90` | 며칠 동안 클릭이 없으면 스크립트 실행 |
| `cooldown_seconds` | `1` | 클릭 인정 최소 간격 |
| `collection_path` | `/home/zenn/Collection` | 삭제 대상 폴더 |
| `target_path` | `/home/zenn/Collection` | 만료 시 스크립트가 처리할 대상 폴더 |
| `trigger_script` | `./scripts/cleanup.sh` | 실행할 스크립트 |
| `port` | `40100` | 웹 접속 포트 |
@@ -207,13 +209,13 @@ docker compose up -d --build
```bash
docker compose ps
docker compose logs -f collection-keeper
docker compose logs -f last-signal
```
브라우저 접속:
```text
http://NAS_IP:40100
http://NAS_IP:44092
```
---
@@ -228,10 +230,10 @@ http://NAS_IP:40100
| `threshold_seconds` | `null` | 테스트용 초 단위 타이머. 값이 있으면 일수보다 우선 |
| `cooldown_seconds` | `1` | 클릭 인정 쿨다운 |
| `check_interval_seconds` | `60` | 스크립트 검사 주기 |
| `database_path` | `./data/keeper.sqlite` | SQLite 경로 |
| `database_path` | `./data/last-signal.sqlite` | SQLite 경로 |
| `trigger_script` | `./scripts/cleanup.sh` | 만료 시 실행 스크립트 |
| `background` | `random` | 배경 이미지 설정 |
| `collection_path` | `/home/zenn/Collection` | Collection 폴더 |
| `target_path` | `/home/zenn/Collection` | 만료 시 스크립트가 처리할 대상 폴더 |
| `port` | `40100` | 웹 포트 |
| `recent_traces_limit` | `5` | 최근 흔적 개수 |
| `reset_token` | `""` | 초기화 API 보호 토큰 |
@@ -264,7 +266,7 @@ http://NAS_IP:40100
- `PORT`
- `DATABASE_PATH`
- `TRIGGER_SCRIPT`
- `COLLECTION_PATH`
- `TARGET_PATH`
- `BACKGROUND`
- `RESET_TOKEN`
- `TZ`
@@ -284,10 +286,12 @@ http://NAS_IP:40100
```bash
cd /home/zenn/docker/collection.sori.studio
git pull
docker compose down
docker compose down --remove-orphans
docker compose up -d --build
```
새 데이터 볼륨 이름은 `last-signal-data`입니다. 기존 `keeper-data` 볼륨은 새 설정에서 사용하지 않습니다.
개발 서버:
```bash