ca9beab72986aa6106dd412e2426556547858d4d
보안 - 첨부 /inline: 업로드한 쪽이 정한 content-type 을 그대로 띄워 HTML/SVG 첨부로 저장형 XSS 가능 → 안전한 이미지 형식만 인라인, 나머지는 다운로드. nosniff + CSP sandbox 헤더 추가. - 설명란 sanitizer: URL 금지 목록이 "jav	ascript:" 로 우회됨 → 허용 목록(http/https/mailto/tel/상대경로, img 는 data: 이미지)으로 변경. 권한 - 업무 생성 시 parent_task_id 로 권한 없는 프로젝트에 하위 업무 생성 가능 → 거부. - 세션 수정/순서/삭제 API 가 세션이 URL 프로젝트 소속인지 안 봄 → 404. - 업무 생성·수정·연결 시 세션이 해당 프로젝트 것인지 검증. - 멤버/세션/업무/활동 조회 API 와 프로젝트 화면을 멤버·owner·admin 만. users/tasks 전체 조회는 볼 수 있는 프로젝트 업무만. 데이터 - 연결(멀티호밍) 업무를 연결된 프로젝트에서 열어 저장하면 세션 선택이 비어 stage_id=null 이 전송돼 원래 세션·완료 상태가 지워짐 → home_stage_id 사용, 빈 세션은 보내지 않음. - mergeTask 가 같은 id 의 첫 행만 고쳐 연결 업무 카드가 중복/사라짐 → 모든 맥락 행을 고치되 맥락별 세션 필드는 보존. 새 업무가 다음 동기화까지 안 보이던 문제도 수정. - 삭제·세션 이름변경·첨부 추가가 실시간 반영 안 됨 → 트리거 카운터 (마이그레이션 007, 미적용 시 MAX 폴백). 화면 열자마자 기준값을 잡아 첫 8초 사이 변경 누락도 해결. 동기화 시 이 프로젝트 행을 통째로 교체. - 사이드바 "내 업무" 개수가 화면마다 다르던 것 → count_my_open 하나로 통일. - 업무/프로젝트/댓글 삭제 시 디스크 첨부 파일 정리. 성능 - 라우터 핸들러 async def → def (동기 psycopg 가 이벤트 루프를 막음). - 프로젝트 화면 N+1 → 업무·세션 각각 쿼리 1회. - live-version 풀스캔 → PK 한 줄 조회. 탭 숨김 시 폴링 중지. - 동기화 API 3개 → /snapshot 1개, 배지 숫자는 /my-tasks/open-count. - 순서 변경 UPDATE N번 → unnest 1번. 첨부는 한도+1 바이트만 읽음. 기타 - 마이그레이션 003 번호 중복 → project_db_003b_task_times.sql. - CLAUDE.md 의 옛 권한 설명 정정, PROJECT_MODULE.md 갱신. 캐시 버전 20260923b. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
DBX 메인 페이지
Google Workspace 계정으로 로그인한 뒤 허용된 사용자만 업무 메뉴에 접근하는 FastAPI 웹앱입니다.
Nginx Proxy Manager(NPM) 뒤에서 Docker 컨테이너로 실행하는 구성을 기준으로 작성했습니다.
접속 허용 계정
허용 목록은 app/main.py의 ALLOWED_EMAILS에서 서버 측으로 검사합니다.
Google OAuth 설정
Google Cloud Console에서 OAuth 클라이언트를 만들고 아래 값을 등록합니다.
| 항목 | 값 |
|---|---|
| 승인된 JavaScript 원본 | https://dbx.no1king.freeddns.org |
| 승인된 리디렉션 URI (운영) | https://dbx.no1king.freeddns.org/auth/google |
| 승인된 리디렉션 URI (로컬) | http://localhost:8080/auth/google |
Google 로그인 화면에서 hd=dbxcorp.co.kr 힌트를 보내지만,
실제 접근 제한은 서버에서 이메일 도메인과 허용 계정 목록으로 다시 검사합니다.
환경 변수
| 변수 | 설명 |
|---|---|
GOOGLE_CLIENT_ID |
Google OAuth 클라이언트 ID |
GOOGLE_CLIENT_SECRET |
Google OAuth 클라이언트 보안 비밀 |
SESSION_SECRET_KEY |
세션 쿠키 서명용 랜덤 문자열 |
SESSION_COOKIE_SECURE |
HTTPS 환경 true / 로컬 HTTP false |
PUBLIC_BASE_URL |
외부 접속 주소 (예: https://dbx.no1king.freeddns.org) |
CS_ORDER_URL |
CS 발주 업무 버튼 이동 주소 |
CUSTOMER_ORDER_LIST_URL |
고객 주문리스트 프로그램 버튼 이동 주소 |
로컬 Docker 테스트
# 1. 환경 변수 파일 준비
copy .env.local.example .env.local
# .env.local 을 열어 Google OAuth 키 등 실제 값으로 수정
# 2. 이미지 빌드 및 컨테이너 실행
docker compose -f docker-compose.local.yml up --build
# 3. 브라우저에서 확인
# http://localhost:8080
Google 로컬 OAuth 주의
Google Cloud Console → OAuth 클라이언트 → 승인된 리디렉션 URI에
http://localhost:8080/auth/google를 반드시 추가해야 합니다.
서버 배포 (Ubuntu + NPM)
NPM은 dbx.no1king.freeddns.org → http://192.168.0.194:80 으로 이미 설정되어 있습니다.
# 서버에서 실행
# 1. 저장소 클론
git clone https://gitea.no1king.freeddns.org/king/dbx-main.git
cd dbx-main
# 2. 환경 변수 파일 준비
cp .env.example .env
# .env 를 열어 실제 값으로 수정
nano .env
# 3. 이미지 빌드 및 백그라운드 실행
docker compose up --build -d
# 4. 로그 확인
docker compose logs -f
업데이트 배포
git pull
docker compose up --build -d
컨테이너 관리
docker compose ps # 상태 확인
docker compose down # 중지
docker compose restart web # 재시작
폰트
app/static/fonts/ 에 Pretendard 폰트가 포함되어 있습니다.
| 파일 | 굵기 |
|---|---|
Pretendard-Thin.ttf |
100 (얇음) |
Pretendard-Regular.ttf |
400 (기본) |
Pretendard-Bold.ttf |
700 (굵음) |
Description
Languages
Python
46.2%
JavaScript
23.7%
HTML
11.3%
PLpgSQL
10.7%
CSS
7.3%
Other
0.7%