feat(asset): add photos, monitor links and deletion
Apply asset_db_002_photos_monitors.sql before rebuilding web. Restrict soft deletion to the super admin; retain reports and audit.
This commit is contained in:
@@ -4,6 +4,23 @@
|
||||
권한이 있는 사용자는 조회·등록·수정·배정·반납·상태 변경·보고서 다운로드가 가능하다.
|
||||
관리자 페이지의 기존 권한 토글로 접근을 부여한다.
|
||||
|
||||
수퍼 관리자(`SUPER_ADMIN_EMAIL`)만 자산을 삭제할 수 있다. 일반 관리자는 삭제할 수 없다.
|
||||
삭제 창에서 자산번호와 사유를 확인하며 API도 권한·CSRF·수정 버전을 확인한다.
|
||||
삭제한 자산은 대장·현황·엑셀·상세·첨부 다운로드에서 제외한다. 사진·보고서·이력과 기존 자산번호는 보존한다.
|
||||
|
||||
## 사진과 모니터 자산
|
||||
|
||||
- 자산 상세의 기본 정보에서 사진을 등록하고 갤러리로 조회한다. 자산당 10장, 파일당 8 MB 입력 제한.
|
||||
- JPG/PNG/WebP만 실제 이미지로 검사하며 최대 2천만 화소, 2400px로 축소한다.
|
||||
EXIF/GPS 등 메타데이터를 제거한 JPEG/PNG를 DB에 보관한다(저장 파일당 5 MB 이하).
|
||||
- 컴퓨터 주요 사양 상단에 보고서의 모니터 목록을 표시한다. 등록된 모니터는 자산번호·이름·상태·사용자·위치·구매금액·보증 개요와 상세 이동을 제공한다.
|
||||
- 시리얼이 유효하고 기존 모니터 한 대와 식별 정보가 일치하면 자동으로 찾는다.
|
||||
시리얼이 없거나 중복·제조사/모델 불일치인 경우 자동 확정하지 않고 후보를 직접 연결한다.
|
||||
- 미등록 모니터는 보고서의 이름/제조사/모델/시리얼과 컴퓨터의 위치/부서를 채운 등록 창을 연다.
|
||||
생성과 컴퓨터 연결은 한 트랜잭션으로 저장한다. 동시 등록은 컴퓨터 행 잠금과 시리얼 잠금으로 보호한다.
|
||||
- 등록·연결은 최신 보고서에서만 가능하다. 이전 보고서도 모니터와 자산 개요를 조회할 수 있다.
|
||||
기존에 업로드한 보고서도 재업로드 없이 지원한다.
|
||||
|
||||
## 업무 흐름
|
||||
|
||||
- 현황 카드: 전체·사용 중·사용 가능·수리 중·30일 이내 보증 만료. 분류 구성·최근 활동·보유 구매금액(폐기 제외).
|
||||
@@ -50,10 +67,43 @@ XML 분석 미리보기는 DB 없이 가능. 앱 시작 시 DB/테이블을 생
|
||||
| assets | 자산·상태·사용자·위치·현재 보고서·수정 버전 |
|
||||
| asset_reports | 원본 XML(BYTEA)·분석 JSONB·SHA-256·처리자/시각. 이전 버전 보존 |
|
||||
| asset_events | 등록·수정·배정·반납·상태·보고서 이력. 변경 전/후 값 |
|
||||
| asset_photos | 검증·재인코딩한 사진, MIME/크기/처리자/시각 |
|
||||
| asset_monitor_links | 컴퓨터의 보고서 장비 식별키와 모니터 자산 연결 |
|
||||
|
||||
자산/보고서/이력은 한 트랜잭션에서 변경한다. 원본과 분석 결과도 함께 저장하므로 별도 첨부 경로가 없다.
|
||||
앱 계정 `asset_app`은 자산 SELECT/INSERT/UPDATE, 보고서/이력 SELECT/INSERT, sequence USAGE/SELECT.
|
||||
소유자는 `postgres`. 최신 보고서의 복합 FK는 다른 자산의 보고서 연결을 막는다.
|
||||
`assets.deleted_at/deleted_by`로 삭제를 표시한다. DB 계정에 DELETE 권한은 부여하지 않는다.
|
||||
사진 SELECT/INSERT, 모니터 연결 SELECT/INSERT/UPDATE 권한을 사용한다.
|
||||
|
||||
### 기존 설치에 사진·모니터·삭제 기능 적용
|
||||
|
||||
`asset_db` / `postgres-db` / 컨테이너 포트 5432. 운영자는 현재 상태와 백업을 확인한 뒤
|
||||
`scripts/sql/asset_db_002_photos_monitors.sql`을 적용한다. 열과 테이블을 추가하는 멱등 SQL이다.
|
||||
새 환경변수는 필요 없다. 전체 초기화 SQL을 다시 실행하지 않는다.
|
||||
|
||||
```bash
|
||||
(
|
||||
set -euo pipefail
|
||||
cd /opt/www/main
|
||||
docker compose ps
|
||||
git status --short
|
||||
git pull --ff-only origin master
|
||||
docker exec postgres-db psql -U postgres -d asset_db -c 'SELECT current_database(),current_user;'
|
||||
sudo mkdir -p /var/backups/postgres
|
||||
ASSET_BACKUP="/var/backups/postgres/asset_db_before_002_$(date +%Y%m%d_%H%M%S).dump"
|
||||
sudo test ! -e "$ASSET_BACKUP"
|
||||
sudo install -m 600 /dev/null "$ASSET_BACKUP"
|
||||
docker exec postgres-db pg_dump -U postgres -F c -d asset_db | sudo tee "$ASSET_BACKUP" >/dev/null
|
||||
sudo cat "$ASSET_BACKUP" | docker exec -i postgres-db pg_restore --list >/dev/null
|
||||
echo "백업 확인: $ASSET_BACKUP"
|
||||
docker exec -i postgres-db psql -v ON_ERROR_STOP=1 -U postgres -d asset_db < scripts/sql/asset_db_002_photos_monitors.sql
|
||||
docker compose up -d --build web
|
||||
docker compose exec -T web python -c 'from app.main import app; s=app.state.asset_store; s is not None or exit("ASSET_DB_URL 설정 필요"); s.health(); print("asset_db 연결 및 스키마 정상")'
|
||||
docker compose ps
|
||||
docker compose logs --tail=50 web
|
||||
)
|
||||
```
|
||||
|
||||
**DB 생성은 서버 실행 명령을 제공하고 사용자가 직접 진행한다 (2026-10-06).**
|
||||
`scripts/sql/asset_db_init.sql`은 재실행 시 기존 데이터·비밀번호를 변경하지 않는다.
|
||||
|
||||
+3
-1
@@ -18,7 +18,9 @@
|
||||
## 명명 규칙
|
||||
|
||||
자산관리 전용 `asset_db` / 앱 계정 `asset_app` / 소유자 `postgres`.
|
||||
테이블 `assets`, `asset_reports`, `asset_events`; 원본 XML도 DB에 보존한다.
|
||||
테이블 `assets`, `asset_reports`, `asset_events`, `asset_photos`, `asset_monitor_links`.
|
||||
원본 XML과 검증된 사진을 DB에 보존한다. 수퍼 관리자 삭제는 `assets.deleted_at/deleted_by` 표시로 처리한다.
|
||||
기존 설치 추가 마이그레이션은 `scripts/sql/asset_db_002_photos_monitors.sql`.
|
||||
`ASSET_DB_URL`, 초기화 `scripts/sql/asset_db_init.sql`(사용자가 서버에서 직접 실행).
|
||||
백업 권장: 매일 `/var/backups/postgres/asset_db_YYYY-MM-DD.dump`.
|
||||
상세 설치·권한·업무 규칙은 [ASSET_MODULE.md](ASSET_MODULE.md).
|
||||
|
||||
@@ -105,6 +105,9 @@ docker exec postgres-db psql -U postgres -d project_db -c "SELECT column_name FR
|
||||
이미 생성한 DB에 프로그램을 적용할 때는 초기화 SQL을 다시 실행할 필요가 없다.
|
||||
`ASSET_DB_URL=postgresql://asset_app:<URL-encoded-password>@postgres-db:5432/asset_db`를 설정한다.
|
||||
원본 XML까지 DB 백업에 포함되며 별도 업로드 볼륨은 필요 없다.
|
||||
자산 사진·모니터 연결·수퍼 관리자 삭제 기능을 기존 설치에 추가할 때는 `asset_db` 백업 후
|
||||
`scripts/sql/asset_db_002_photos_monitors.sql`을 먼저 적용하고 web을 재빌드한다.
|
||||
사진도 DB 백업에 포함된다. 실행 명령은 [자산관리 설치 문서](ASSET_MODULE.md#기존-설치에-사진모니터삭제-기능-적용)를 참조한다.
|
||||
DB 미설정 시에도 기존 모듈은 동작하고 자산관리에서 설정 안내/보고서 분석을 제공한다.
|
||||
상태·백업 확인과 초기화 순서는 [ASSET_MODULE.md](ASSET_MODULE.md#저장소와-설치) 참조.
|
||||
|
||||
|
||||
@@ -27,6 +27,7 @@
|
||||
|
||||
자산관리: `app/modules/asset/`, `/asset/`, `asset_db` — 사무집기·전산장비 개별 등록,
|
||||
배정/반납/상태·구매/보증·활동 이력, HWiNFO XML 사양/보고서 보존. 상세 `docs/ASSET_MODULE.md`.
|
||||
사진 갤러리, 보고서 모니터 자산 개요·등록·연결, 수퍼 관리자 삭제(이력/원본 보존)를 제공한다.
|
||||
|
||||
| 키 | 종류 | 설명 |
|
||||
| --- | --- | --- |
|
||||
|
||||
Reference in New Issue
Block a user