DOCS/plans/250831_todo_and_tech_debt.md

TODO 및 기술 부채 정리

작성일: 2025년 8월 31일

1. 긴급 해결 필요 사항 🔴

Git Merge Conflict 해결

영향받는 파일들:

• /home/admin/auth-server/app/providers/gmail_passport.py (HEAD vs eaed063)
• /home/admin/auth-server/app/providers/gmail.py
• /home/admin/auth-server/app/api/gmail_refresh.py

충돌 내용:

• HEAD: 최신 변경사항 (UUID/username 처리 개선)
• eaed063: rb8001 크론잡 트러블슈팅 관련 변경

해결 방법:

cd /home/admin/auth-server
git status
# 각 파일 수동 병합 필요
git add .
git commit -m "fix: merge conflicts - Slack OAuth implementation"

DB 스키마 불일치

문제:

• companies 테이블 vs workspaces 테이블 공존
• SlackWorkspace 모델이 잘못된 FK 참조
• Relationship 주석 처리로 임시 해결 중

현재 상태:

-- 실제 DB
slack_workspaces.company_id → companies.id
workspace_members.workspace_id → workspaces.id

-- 모델 파일 (잘못됨)
SlackWorkspace.workspace_id → workspaces.id (실제로는 company_id)

해결 계획:

1. 데이터 백업
2. companies 데이터를 workspaces로 마이그레이션
3. FK 관계 재설정
4. 모델 파일 통일

2. 중요도 높음 🟡

Frontend-Backend 인증 방식 불일치

현재 상태:

• Frontend: Gmail 방식 (/auth/verify 임시 코드)
• Slack: JWT 직접 전달 계획 → 임시 코드로 변경

영향:

• 불필요한 Redis 호출
• 60초 시간 제한
• 복잡한 인증 플로우

해결 방법:

1. Frontend auth-context.tsx 수정
   • JWT 직접 처리 로직 구현
   • Provider별 분기 처리
2. 또는 통합 인증 서비스 구현

하드코딩된 설정값

위치 및 내용:

# /home/admin/auth-server/app/providers/slack.py
redirect_uri = "http://localhost:3000"  # 하드코딩
login_callback_url = "https://auth.ro-being.com/auth/slack/login/callback"

# docker-compose.yml
DATABASE_URL=postgresql://robeings:robeings@192.168.219.45/main_db

해결:

• .env 파일로 이동
• 환경별 설정 분리 (dev/staging/prod)

3. 개선 사항 🟢

코드 품질

1. 에러 처리 개선

   • 구체적인 에러 메시지
   • 사용자 친화적 에러 페이지
   • 로깅 강화

2. 테스트 추가

   • 단위 테스트
   • 통합 테스트
   • E2E 테스트

3. 문서화

   • API 문서 (OpenAPI/Swagger)
   • 시퀀스 다이어그램
   • 배포 가이드

보안 강화

1. 토큰 관리

   • Refresh Token 구현
   • 토큰 암호화 저장
   • Rate Limiting

2. OAuth 개선

   • PKCE 구현
   • State 파라미터 강화
   • Nonce 추가

4. 장기 로드맵 📅

Q4 2025

• DB 스키마 통일
• Frontend 인증 방식 통일
• 환경변수 정리
• Git 충돌 해결

Q1 2026

• Multi-tenant 아키텍처
• SSO 구현
• 2FA 지원
• 감사 로그

Q2 2026

• 마이크로서비스 분리
• API Gateway 도입
• 중앙 인증 서버
• 모니터링 대시보드

5. 현재 작업 중인 파일 목록

수정된 파일 (commit 필요)

/home/admin/auth-server/
├── app/
│   ├── api/gmail_refresh.py (CONFLICT)
│   ├── models/workspace.py
│   ├── providers/
│   │   ├── gmail.py (CONFLICT)
│   │   ├── gmail_passport.py (CONFLICT)
│   │   └── slack.py (NEW IMPLEMENTATION)
├── docker-compose.yml
└── tokens/unknown_gmail.json

/home/heejae/frontend-customer/
└── src/contexts/auth-context.tsx

신규 생성된 문서

/home/heejae/DOCS/
├── troubleshooting/
│   └── 250831_slack_oauth_login_implementation.md
├── 300_architecture/
│   └── 380_authentication_system.md
└── plans/
    └── 250831_todo_and_tech_debt.md (this file)

6. 명령어 참조

Docker 관련

# Auth server 재시작
cd /home/admin/auth-server
docker compose down && docker compose up -d --build

# 로그 확인
docker logs auth-server --tail 100 -f
docker logs auth-redis --tail 50

Git 관련

# 충돌 해결
git status
git diff <file>
git add <file>
git commit -m "fix: resolve conflicts"

# 변경사항 확인
git log --oneline -10
git diff HEAD~1

DB 관련

# PostgreSQL 접속
PGPASSWORD=robeings psql -h localhost -U robeings -d main_db

# 테이블 구조 확인
\d companies
\d workspaces
\d slack_workspaces
\d users
\d slack_user_mapping

# 데이터 확인
SELECT * FROM companies;
SELECT * FROM workspaces;
SELECT * FROM slack_workspaces;

Redis 관련

# Redis CLI
docker exec -it auth-redis redis-cli

# Keys 확인
KEYS oauth:state:*
KEYS auth:temp:*

# TTL 확인
TTL oauth:state:<uuid>

7. 연락처 및 참고

관련 시스템

• Auth Server: https://auth.ro-being.com (포트 9000)
• Frontend: https://ro-being.com (포트 3000)
• Gitea: https://git.ro-being.com
• PostgreSQL: 192.168.219.45:5432
• Redis: localhost:6379

환경변수 위치

• /home/admin/auth-server/.env
• /home/heejae/frontend-customer/.env

주요 문서

• Slack OAuth 구현 상세
• 인증 시스템 아키텍처
• UUID 변환 시스템

8. 체크리스트

배포 전 확인사항

• Git 충돌 해결
• 환경변수 설정
• DB 마이그레이션
• Docker 이미지 빌드
• 로그 모니터링
• 에러 처리 테스트
• 롤백 계획 수립

테스트 시나리오

• Gmail 로그인
• Slack 로그인
• 기존 사용자 연동
• 신규 사용자 생성
• 토큰 만료 처리
• 에러 케이스
• 동시 로그인