✨ 노트북 관리 UI 완성
🎯 주요 개선사항: - 노트북 목록 조회/표시 기능 완성 - 노트북 생성/편집/삭제 모달 구현 - 토스트 알림 시스템 추가 (alert 대신) - 노트북 통계 대시보드 표시 - 노트북별 노트 관리 및 빠른 노트 생성 기능 - URL 파라미터를 통한 노트북 자동 설정 🔧 기술적 개선: - CSS line-clamp 클래스 추가 - 필드명 불일치 수정 (notebook.name → notebook.title) - 삭제 확인 모달로 UX 개선 - 노트 에디터에서 노트북 자동 설정 지원 📱 UI/UX 개선: - 노트북 카드 호버 효과 및 색상 테마 - 빈 노트북 상태 처리 및 안내 - 반응형 그리드 레이아웃 - 로딩 상태 및 에러 처리 개선
This commit is contained in:
215
README.md
215
README.md
@@ -103,7 +103,8 @@ PDF 문서를 OCR 처리하고 AI로 HTML로 변환한 후, 웹에서 효율적
|
||||
|
||||
### 인프라 & 배포
|
||||
- **컨테이너**: Docker 24+ & Docker Compose
|
||||
- **배포 환경**: Mac Mini / Synology NAS
|
||||
- **주 배포 환경**: Synology DS1525+ (32GB RAM, SSD 캐싱)
|
||||
- **보조 배포 환경**: Mac Mini (개발/테스트)
|
||||
- **프로세스 관리**: Docker (컨테이너 오케스트레이션)
|
||||
- **로그 관리**: Python logging + 파일 로테이션
|
||||
- **모니터링**: 기본 헬스체크 (향후 Prometheus + Grafana)
|
||||
@@ -231,18 +232,30 @@ notes (
|
||||
- [x] API 오류 처리 및 사용자 피드백
|
||||
- [x] 실시간 문서 목록 새로고침
|
||||
|
||||
### Phase 7: 최우선 개선사항 (진행 중) 🔥
|
||||
- [ ] **메모-하이라이트 통합**: 하이라이트 기반 메모 기능 완전 통합
|
||||
- [ ] **노트 뷰어 기능**: 노트에서 하이라이트, 메모, 링크 등 모든 기능 지원
|
||||
- [ ] **API 구조 정리**: 메모(`/api/notes/`) vs 노트(`/api/note-documents/`) 명확한 분리
|
||||
- [ ] **용어 통일**: 전체 시스템에서 메모/노트 용어 일관성 확보
|
||||
### Phase 7: 최우선 개선사항 ✅
|
||||
- [x] **메모-하이라이트 통합**: 하이라이트 기반 메모 기능 완전 통합
|
||||
- [x] **노트 뷰어 기능**: 노트에서 하이라이트, 메모, 링크 등 모든 기능 지원
|
||||
- [x] **API 구조 정리**: 메모(`/api/notes/`) vs 노트(`/api/note-documents/`) 명확한 분리
|
||||
- [x] **용어 통일**: 전체 시스템에서 메모/노트 용어 일관성 확보
|
||||
- [x] **노트북-서적 링크 시스템**: 양방향 링크/백링크 완전 구현
|
||||
|
||||
### Phase 8: 향후 개선사항 (예정)
|
||||
### Phase 8: 미완성 핵심 기능 (우선순위) 🚧
|
||||
- [x] **노트 편집기**: 노트 생성/편집 UI 완성 (`/note-editor.html`) ✅
|
||||
- [x] **노트북 관리 API**: 노트북 CRUD 백엔드 완성 ✅
|
||||
- [x] **노트북 관리 UI**: 프론트엔드 CRUD 기능 완성 (`/notebooks.html`) ✅
|
||||
- 노트북 목록 조회/표시, 생성/편집/삭제 모달
|
||||
- 토스트 알림 시스템, 통계 대시보드
|
||||
- 노트북별 노트 관리 및 빠른 노트 생성
|
||||
- [ ] **메모 트리 시스템**: 계층적 메모 구조 및 관리 (`/memo-tree.html` 완성)
|
||||
- [ ] **고급 검색**: 문서/노트/메모 통합 검색 필터링
|
||||
- [ ] **사용자 관리**: 다중 사용자 지원 및 권한 관리
|
||||
|
||||
### Phase 9: 관리 및 최적화 (예정)
|
||||
- [ ] 관리자 대시보드 UI
|
||||
- [ ] 문서 통계 및 분석
|
||||
- [ ] 모바일 반응형 최적화
|
||||
- [ ] 고급 검색 필터
|
||||
- [ ] 문서 버전 관리
|
||||
- [ ] 성능 최적화 및 캐싱
|
||||
|
||||
## 현재 상태 (2025-08-21)
|
||||
|
||||
@@ -289,6 +302,192 @@ docker-compose -f docker-compose.dev.yml up
|
||||
docker-compose -f docker-compose.prod.yml up -d
|
||||
```
|
||||
|
||||
## 🏢 Synology DS1525+ 최적화 배포
|
||||
|
||||
### 하드웨어 사양
|
||||
- **모델**: Synology DS1525+ (5-Bay NAS)
|
||||
- **CPU**: AMD Ryzen R1600 (4코어/8스레드)
|
||||
- **메모리**: 32GB DDR4 ECC
|
||||
- **스토리지**: SSD 읽기/쓰기 캐싱 활성화
|
||||
- **네트워크**: 기가비트 이더넷
|
||||
|
||||
### 스토리지 최적화 전략
|
||||
|
||||
#### SSD 배치 (고성능 요구)
|
||||
```bash
|
||||
# 시스템 및 고빈도 액세스 데이터
|
||||
/volume1/docker/document-server/
|
||||
├── database/ # PostgreSQL 데이터 (SSD)
|
||||
├── redis/ # Redis 캐시 (SSD)
|
||||
├── logs/ # 애플리케이션 로그 (SSD)
|
||||
└── config/ # 설정 파일 (SSD)
|
||||
```
|
||||
|
||||
#### HDD 배치 (대용량 저장)
|
||||
```bash
|
||||
# 대용량 파일 저장소
|
||||
/volume2/document-storage/
|
||||
├── documents/ # HTML 문서 파일 (HDD)
|
||||
├── uploads/ # 업로드된 원본 파일 (HDD)
|
||||
├── backups/ # 데이터베이스 백업 (HDD)
|
||||
└── archives/ # 아카이브 파일 (HDD)
|
||||
```
|
||||
|
||||
### Docker Compose 최적화 설정
|
||||
|
||||
#### 볼륨 매핑 (docker-compose.synology.yml)
|
||||
```yaml
|
||||
version: '3.8'
|
||||
|
||||
services:
|
||||
database:
|
||||
volumes:
|
||||
# SSD: 데이터베이스 성능 최적화
|
||||
- /volume1/docker/document-server/database:/var/lib/postgresql/data
|
||||
|
||||
redis:
|
||||
volumes:
|
||||
# SSD: 캐시 성능 최적화
|
||||
- /volume1/docker/document-server/redis:/data
|
||||
|
||||
backend:
|
||||
volumes:
|
||||
# SSD: 로그 및 설정
|
||||
- /volume1/docker/document-server/logs:/app/logs
|
||||
- /volume1/docker/document-server/config:/app/config
|
||||
# HDD: 대용량 파일 저장
|
||||
- /volume2/document-storage/uploads:/app/uploads
|
||||
- /volume2/document-storage/documents:/app/documents
|
||||
|
||||
nginx:
|
||||
volumes:
|
||||
# SSD: 설정 및 캐시
|
||||
- /volume1/docker/document-server/nginx:/etc/nginx/conf.d
|
||||
# HDD: 정적 파일 서빙
|
||||
- /volume2/document-storage/documents:/usr/share/nginx/html/documents:ro
|
||||
```
|
||||
|
||||
### 시놀로지 환경 배포 명령어
|
||||
|
||||
```bash
|
||||
# 1. 디렉토리 생성
|
||||
sudo mkdir -p /volume1/docker/document-server/{database,redis,logs,config,nginx}
|
||||
sudo mkdir -p /volume2/document-storage/{documents,uploads,backups,archives}
|
||||
|
||||
# 2. 권한 설정
|
||||
sudo chown -R 1000:1000 /volume1/docker/document-server/
|
||||
sudo chown -R 1000:1000 /volume2/document-storage/
|
||||
|
||||
# 3. 시놀로지 최적화 배포
|
||||
docker-compose -f docker-compose.synology.yml up -d
|
||||
|
||||
# 4. 서비스 상태 확인
|
||||
docker-compose -f docker-compose.synology.yml ps
|
||||
```
|
||||
|
||||
### 성능 최적화 설정
|
||||
|
||||
#### PostgreSQL 튜닝 (32GB RAM 환경)
|
||||
```ini
|
||||
# postgresql.conf
|
||||
shared_buffers = 8GB # RAM의 25%
|
||||
effective_cache_size = 24GB # RAM의 75%
|
||||
work_mem = 256MB # 복잡한 쿼리용
|
||||
maintenance_work_mem = 2GB # 인덱스 구축용
|
||||
checkpoint_completion_target = 0.9 # SSD 최적화
|
||||
wal_buffers = 64MB # WAL 버퍼
|
||||
random_page_cost = 1.1 # SSD 환경 최적화
|
||||
```
|
||||
|
||||
#### Redis 설정 (캐싱 최적화)
|
||||
```conf
|
||||
# redis.conf
|
||||
maxmemory 4gb # 캐시 메모리 제한
|
||||
maxmemory-policy allkeys-lru # LRU 정책
|
||||
save 900 1 # 자동 저장 설정
|
||||
save 300 10
|
||||
save 60 10000
|
||||
```
|
||||
|
||||
### 백업 전략
|
||||
|
||||
#### 자동 백업 스크립트
|
||||
```bash
|
||||
#!/bin/bash
|
||||
# /volume1/docker/document-server/scripts/backup.sh
|
||||
|
||||
BACKUP_DIR="/volume2/document-storage/backups"
|
||||
DATE=$(date +%Y%m%d_%H%M%S)
|
||||
|
||||
# 데이터베이스 백업
|
||||
docker-compose -f docker-compose.synology.yml exec -T database \
|
||||
pg_dump -U postgres document_server > "$BACKUP_DIR/db_backup_$DATE.sql"
|
||||
|
||||
# 설정 파일 백업
|
||||
tar -czf "$BACKUP_DIR/config_backup_$DATE.tar.gz" \
|
||||
/volume1/docker/document-server/config/
|
||||
|
||||
# 7일 이상 된 백업 파일 삭제
|
||||
find "$BACKUP_DIR" -name "*.sql" -mtime +7 -delete
|
||||
find "$BACKUP_DIR" -name "*.tar.gz" -mtime +7 -delete
|
||||
|
||||
echo "Backup completed: $DATE"
|
||||
```
|
||||
|
||||
#### 시놀로지 작업 스케줄러 설정
|
||||
```bash
|
||||
# 매일 새벽 2시 자동 백업
|
||||
# 제어판 > 작업 스케줄러 > 생성 > 사용자 정의 스크립트
|
||||
0 2 * * * /volume1/docker/document-server/scripts/backup.sh
|
||||
```
|
||||
|
||||
### 모니터링 및 유지보수
|
||||
|
||||
#### 리소스 모니터링
|
||||
```bash
|
||||
# 컨테이너 리소스 사용량 확인
|
||||
docker stats
|
||||
|
||||
# 디스크 사용량 확인
|
||||
df -h /volume1 /volume2
|
||||
|
||||
# 시놀로지 시스템 상태
|
||||
cat /proc/meminfo | grep -E "MemTotal|MemAvailable"
|
||||
```
|
||||
|
||||
#### 로그 로테이션 설정
|
||||
```bash
|
||||
# /etc/logrotate.d/document-server
|
||||
/volume1/docker/document-server/logs/*.log {
|
||||
daily
|
||||
rotate 30
|
||||
compress
|
||||
delaycompress
|
||||
missingok
|
||||
notifempty
|
||||
create 644 1000 1000
|
||||
postrotate
|
||||
docker-compose -f docker-compose.synology.yml restart backend
|
||||
endscript
|
||||
}
|
||||
```
|
||||
|
||||
### 네트워크 최적화
|
||||
|
||||
#### 포트 포워딩 설정
|
||||
- **외부 포트**: 24100 (HTTPS 리버스 프록시 권장)
|
||||
- **내부 포트**: 24100 (Nginx)
|
||||
- **방화벽**: 필요한 포트만 개방
|
||||
|
||||
#### SSL/TLS 설정 (Let's Encrypt)
|
||||
```bash
|
||||
# Certbot을 통한 SSL 인증서 자동 갱신
|
||||
docker run --rm -v /volume1/docker/document-server/ssl:/etc/letsencrypt \
|
||||
certbot/certbot certonly --webroot \
|
||||
-w /volume2/document-storage/documents \
|
||||
-d your-domain.com
|
||||
```
|
||||
|
||||
## API 엔드포인트 (예상)
|
||||
|
||||
### 인증 관리
|
||||
|
||||
Reference in New Issue
Block a user