멀티테넌시
단지별 tenant_id로 데이터를 격리합니다. RLS(Row Level Security)로 다른 단지 접근을 차단하며, pgBouncer 등 커넥션 풀로 성능을 유지합니다.
Platform
플랫폼 · 보안 · 운영
단일 URL SaaS, PostgreSQL 멀티테넌시, Docker 배포 — 운영 단지를 전제로 한 아키텍처입니다.
FastAPI · PostgreSQL
비동기 API, SQLAlchemy + 파라미터 바인딩, 모듈별 dev/·api/ 분리. 100개 이상 모듈 확장을 전제로 폴더 구조를 유지합니다.
백업 · 배포
전체·단지별 일일 백업, Docker 기반 배포. 운영 서버 직접 수정 없이 릴리스 절차를 따릅니다.
인증 · 권한
단지·역할별 로그인, OTP·비밀번호 정책, 프로그램·메뉴 권한. 동일 employ_id도 단지별로 독립합니다.
데이터 보안
비밀번호 bcrypt, 오류 메시지에 tenant_id·apt_name 미노출, 로그인 ID 표시 규칙(역할별). 사용자에게 멀티테넌시를 암시하지 않습니다.
CSS · UI 격리
화면별 CSS 모듈, 프로그램별 브랜드(관리사무소 teal, 동대표 purple). 대규모 화면에서도 스타일 충돌을 방지합니다.
프로그램 URL 구조
| 프로그램 | URL | 사용자 |
|---|---|---|
| 수퍼관리자 | /super-admin/ | 서버 운영·단지 생성 |
| 관리사무소 | /app/ | 단지 관리자·직원 |
| 동대표 | /head/ | 입주자대표 |
| 입주민 | /resident/ | 입주민(모바일) |