# PharmQ 사용자 포털 및 구독 서비스 기획서 ## 1. 프로젝트 개요 ### 1.1 목적 - 약국 사용자가 PharmQ 서비스를 쉽게 이해하고 가입할 수 있는 포털 제공 - 카카오 SSO 기반 간편 가입 및 로그인 시스템 - 토스페이먼츠 연동을 통한 안전한 구독 결제 서비스 - 구독 후 사용자가 실제 서비스를 이용할 수 있는 사용자 대시보드 ### 1.2 서비스 구조 ``` PharmQ 생태계 ├── 🏢 Super Admin (PSA) - 관리자용 (현재 구현됨) ├── 🌐 Public Portal - 서비스 소개 및 가입 페이지 (신규 개발) └── 👤 User Dashboard - 구독자 전용 관리 페이지 (신규 개발) ``` --- ## 2. Public Portal (서비스 소개 및 가입 페이지) ### 2.1 페이지 구성 #### 2.1.1 메인 페이지 (`/`) - **헤더**: PharmQ 로고, 네비게이션, 로그인 버튼 - **히어로 섹션**: 캐치프레이즈 및 주요 가치 제안 - **서비스 소개**: 3가지 서비스 (클라우드 PC, AI CCTV, CRM) 간단 소개 - **고객 후기**: 기존 고객 사례 (익명화) - **가격 안내**: 서비스별 월 구독료 - **CTA 버튼**: "무료 상담 신청" 또는 "지금 시작하기" #### 2.1.2 서비스 상세 페이지 (`/services/{service_code}`) - **클라우드 PC** (`/services/cloud-pc`) - Proxmox 기반 가상 데스크톱 서비스 설명 - 원격 근무, 보안, 백업의 장점 - 스크린샷 및 데모 영상 - **AI CCTV** (`/services/ai-cctv`) - 인공지능 기반 보안 모니터링 설명 - 실시간 알림, 이상행동 감지 기능 - 설치 사례 및 효과 - **CRM 시스템** (`/services/crm`) - 고객 관계 관리 및 매출 분석 도구 - 고객 데이터 관리, 리포트 기능 - ROI 계산기 #### 2.1.3 가격 및 플랜 페이지 (`/pricing`) ``` ┌─────────────────────────────────────────────────────────────────┐ │ PharmQ 서비스 플랜 │ ├─────────────────────────────────────────────────────────────────┤ │ 🖥️ 클라우드 PC 📹 AI CCTV 📊 CRM 시스템 │ │ ₩60,000/월 ₩80,000/월 ₩40,000/월 │ │ • 가상 데스크톱 제공 • 24시간 모니터링 • 고객 DB 관리 │ │ • 자동 백업 • AI 이상행동 감지 • 매출 분석 리포트 │ │ • 원격 접속 지원 • 실시간 알림 • 마케팅 도구 │ │ │ │ ⭐ 추천: 전체 패키지 ₩150,000/월 (₩30,000 할인) │ │ [무료 상담 신청] [패키지 선택하기] │ └─────────────────────────────────────────────────────────────────┘ ``` #### 2.1.4 회사 소개 페이지 (`/about`) - Medivault & PharmQ 소개 - 팀 소개 및 비전 - 오시는 길 #### 2.1.5 고객센터 (`/support`) - FAQ (자주 묻는 질문) - 문의하기 폼 - 연락처 정보 ### 2.2 사용자 가입 프로세스 #### 2.2.1 카카오 SSO 로그인 (`/auth/kakao`) ``` 사용자 클릭: "카카오로 시작하기" ↓ 카카오 OAuth 인증 페이지 이동 ↓ 사용자 카카오 로그인 및 동의 ↓ PharmQ로 리다이렉트 + 사용자 정보 수신 ↓ 신규 사용자 → 추가 정보 입력 페이지 기존 사용자 → 사용자 대시보드 이동 ``` #### 2.2.2 추가 정보 입력 페이지 (`/signup/pharmacy-info`) 사용자가 카카오 로그인 후 입력해야 할 추가 정보: ```sql -- 사용자 기본 정보 (카카오에서 받음) kakao_user_id: VARCHAR(100) -- 카카오 고유 ID name: VARCHAR(50) -- 실명 email: VARCHAR(100) -- 이메일 phone: VARCHAR(20) -- 휴대폰 번호 -- 약국 정보 (사용자 직접 입력 또는 약준모 약사면허인증 API활용) pharmacy_name: VARCHAR(100) -- 약국명 * business_license: VARCHAR(20) -- 사업자등록번호 * pharmacy_address: TEXT -- 약국 주소 * pharmacist_license: VARCHAR(30) -- 약사 면허번호 * establishment_date: DATE -- 개업일 pharmacy_phone: VARCHAR(20) -- 약국 전화번호 fax_number: VARCHAR(20) -- 팩스번호 -- 선택 정보 staff_count: INTEGER -- 직원 수 monthly_customers: INTEGER -- 월 평균 고객 수 current_pos_system: VARCHAR(50) -- 현재 사용 중인 POS 시스템 special_requirements: TEXT -- 특별 요구사항 ``` #### 2.2.3 약관 동의 - **필수 동의** - 서비스 이용약관 - 개인정보 처리방침 - 약국 정보 수집 및 이용 동의 - **선택 동의** - 마케팅 정보 수신 동의 (SMS, 이메일) - 서비스 개선을 위한 데이터 활용 동의 #### 2.2.4 서비스 선택 및 구독 (`/subscription/select`) 1. **서비스 선택** - 개별 서비스 선택 (클라우드 PC, AI CCTV, CRM) - 패키지 선택 (전체 패키지 할인) - 구독 기간 선택 (월간, 연간 - 연간 10% 할인) 2. **결제 정보 확인** - 선택 서비스 및 금액 확인 - 할인 적용 여부 확인 - 첫 달 무료 체험 적용 3. **토스페이먼츠 결제** (`/payment/process`) ```javascript // 토스페이먼츠 연동 플로우 const payment = TossPayments(clientKey); payment.requestPayment('카드', { amount: subscription.amount, orderId: generate_order_id(), orderName: `PharmQ ${services.join(', ')} 구독`, customerName: user.name, customerEmail: user.email, successUrl: 'https://pharmq.co.kr/payment/success', failUrl: 'https://pharmq.co.kr/payment/fail', }); ``` --- ## 3. User Dashboard (구독자 전용 관리 페이지) ### 3.1 인증 및 접근 제어 - **로그인**: 카카오 SSO를 통한 로그인만 허용 - **권한 체크**: 활성 구독이 있는 사용자만 접근 가능 - **세션 관리**: JWT 토큰 기반 세션 관리 ### 3.2 대시보드 구성 (`/dashboard`) #### 3.2.1 메인 대시보드 ``` ┌─────────────────────────────────────────────────────────────────┐ │ 👋 안녕하세요, [약국명] [대표자명]님 │ ├─────────────────────────────────────────────────────────────────┤ │ 📊 구독 현황 │ │ • 🖥️ 클라우드 PC: 활성 (다음 결제: 2025.10.15) │ │ • 📹 AI CCTV: 활성 (다음 결제: 2025.10.01) │ │ • 📊 CRM: 구독 안함 [구독하기] │ │ │ │ 💳 이번 달 구독료: ₩140,000 │ │ 📈 서비스 이용 현황 │ │ • 클라우드 PC 접속: 15회 (이번 달) │ │ • AI CCTV 알림: 3건 (최근 7일) │ └─────────────────────────────────────────────────────────────────┘ ``` #### 3.2.2 서비스별 관리 페이지 **클라우드 PC 관리** (`/dashboard/cloud-pc`) - 가상 머신 상태 확인 - 원격 접속 링크 (VNC) - 백업 현황 및 복구 요청 - 사용량 통계 **AI CCTV 관리** (`/dashboard/ai-cctv`) - 실시간 모니터링 화면 - 알림 히스토리 - 이상행동 감지 로그 - 카메라 설정 관리 **CRM 시스템** (`/dashboard/crm`) - 고객 데이터 관리 - 매출 분석 리포트 - 마케팅 캠페인 관리 - 데이터 내보내기 #### 3.2.3 구독 관리 (`/dashboard/subscription`) - 현재 구독 서비스 확인 - 구독 업그레이드/다운그레이드 - 결제 이력 조회 - 구독 해지 (해지 사유 조사) #### 3.2.4 계정 설정 (`/dashboard/settings`) - 약국 정보 수정 - 비밀번호 변경 (카카오 연동이므로 제한적) - 알림 설정 (이메일, SMS) - 개인정보 수정 #### 3.2.5 고객지원 (`/dashboard/support`) - 1:1 문의하기 - 문의 내역 조회 - FAQ 및 도움말 - 원격 지원 요청 --- ## 4. 데이터베이스 설계 확장 ### 4.1 신규 테이블 추가 #### 4.1.1 사용자 계정 관리 ```sql CREATE TABLE user_accounts ( id INTEGER PRIMARY KEY AUTOINCREMENT, kakao_user_id VARCHAR(100) UNIQUE NOT NULL, email VARCHAR(100) NOT NULL, name VARCHAR(50) NOT NULL, phone VARCHAR(20), profile_image_url TEXT, is_active BOOLEAN DEFAULT TRUE, last_login_at TIMESTAMP, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ); CREATE TABLE user_pharmacy_info ( id INTEGER PRIMARY KEY AUTOINCREMENT, user_id INTEGER NOT NULL, pharmacy_name VARCHAR(100) NOT NULL, business_license VARCHAR(20) NOT NULL, pharmacy_address TEXT NOT NULL, pharmacist_license VARCHAR(30) NOT NULL, establishment_date DATE, pharmacy_phone VARCHAR(20), fax_number VARCHAR(20), staff_count INTEGER, monthly_customers INTEGER, current_pos_system VARCHAR(50), special_requirements TEXT, verification_status VARCHAR(20) DEFAULT 'PENDING', -- PENDING, VERIFIED, REJECTED created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (user_id) REFERENCES user_accounts(id) ); ``` #### 4.1.2 구독 및 결제 관리 ```sql CREATE TABLE user_subscriptions ( id INTEGER PRIMARY KEY AUTOINCREMENT, user_id INTEGER NOT NULL, product_id INTEGER NOT NULL, subscription_status VARCHAR(20) NOT NULL, -- ACTIVE, CANCELLED, SUSPENDED start_date DATE NOT NULL, end_date DATE, next_billing_date DATE, monthly_fee DECIMAL(10,2) NOT NULL, billing_cycle VARCHAR(10) DEFAULT 'MONTHLY', -- MONTHLY, YEARLY auto_renewal BOOLEAN DEFAULT TRUE, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (user_id) REFERENCES user_accounts(id), FOREIGN KEY (product_id) REFERENCES service_products(id) ); CREATE TABLE payment_transactions ( id INTEGER PRIMARY KEY AUTOINCREMENT, user_id INTEGER NOT NULL, subscription_id INTEGER, toss_payment_key VARCHAR(200) UNIQUE, toss_order_id VARCHAR(100) UNIQUE, amount DECIMAL(10,2) NOT NULL, payment_method VARCHAR(50), payment_status VARCHAR(20), -- SUCCESS, FAILED, CANCELLED, REFUNDED paid_at TIMESTAMP, failed_reason TEXT, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (user_id) REFERENCES user_accounts(id), FOREIGN KEY (subscription_id) REFERENCES user_subscriptions(id) ); ``` #### 4.1.3 서비스 사용 로그 ```sql CREATE TABLE service_usage_logs ( id INTEGER PRIMARY KEY AUTOINCREMENT, user_id INTEGER NOT NULL, subscription_id INTEGER NOT NULL, service_type VARCHAR(20) NOT NULL, -- CLOUD_PC, AI_CCTV, CRM action_type VARCHAR(50) NOT NULL, -- LOGIN, ACCESS, DOWNLOAD, etc. session_duration INTEGER, -- 세션 지속 시간 (초) ip_address VARCHAR(45), user_agent TEXT, created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, FOREIGN KEY (user_id) REFERENCES user_accounts(id), FOREIGN KEY (subscription_id) REFERENCES user_subscriptions(id) ); ``` --- ## 5. 기술 스택 및 구현 ### 5.1 백엔드 기술 스택 - **Framework**: Flask (기존 시스템과 통합) - **Authentication**: 카카오 OAuth 2.0 - **Payment**: 토스페이먼츠 API - **Database**: SQLite (개발) → PostgreSQL (운영) - **Session**: Flask-Session + Redis ### 5.2 프론트엔드 기술 스택 - **Template Engine**: Jinja2 - **CSS Framework**: Bootstrap 5 - **JavaScript**: Vanilla JS + Chart.js - **Icons**: Font Awesome - **Responsive**: Mobile-First 디자인 ### 5.3 보안 고려사항 - **데이터 암호화**: 민감 정보 AES-256 암호화 - **API 보안**: JWT 토큰 + Rate Limiting - **결제 보안**: 토스페이먼츠 Webhook 검증 - **개인정보 보호**: GDPR 준수, 최소한의 정보 수집 --- ## 6. 개발 로드맵 ### Phase 1: 기본 포털 구축 (2-3주) - [ ] Public Portal 메인 페이지 구현 - [ ] 서비스 소개 페이지 구현 - [ ] 가격 안내 페이지 구현 - [ ] 카카오 SSO 연동 ### Phase 2: 사용자 가입 및 구독 (3-4주) - [ ] 사용자 가입 플로우 구현 - [ ] 약국 정보 입력 및 검증 시스템 - [ ] 토스페이먼츠 결제 연동 - [ ] 구독 생성 및 관리 API ### Phase 3: 사용자 대시보드 (4-5주) - [ ] 사용자 대시보드 메인 페이지 - [ ] 서비스별 관리 페이지 구현 - [ ] 구독 관리 및 결제 이력 페이지 - [ ] 계정 설정 및 고객 지원 ### Phase 4: 고도화 및 운영 (2-3주) - [ ] 사용량 추적 및 분석 시스템 - [ ] 이메일/SMS 알림 시스템 - [ ] 관리자 승인 워크플로우 - [ ] 성능 최적화 및 보안 강화 --- ## 7. 예상 효과 ### 7.1 비즈니스 효과 - **자동화된 고객 획득**: 24/7 온라인 가입 가능 - **결제 자동화**: 토스페이먼츠를 통한 안정적인 정기 결제 - **고객 셀프 서비스**: 고객 지원 비용 절감 - **데이터 기반 의사결정**: 사용자 행동 분석을 통한 서비스 개선 ### 7.2 사용자 경험 개선 - **간편한 가입**: 카카오 SSO로 1분 내 가입 완료 - **투명한 가격**: 명확한 가격 정보 및 할인 혜택 - **통합 관리**: 모든 서비스를 하나의 대시보드에서 관리 - **실시간 지원**: 채팅 및 원격 지원을 통한 빠른 문제 해결 --- **작성일**: 2025년 9월 11일 **작성자**: PharmQ Development Team **버전**: v1.0 ## 8. 추가 고려사항 ### 8.1 법적 컴플라이언스 - **약사법** 준수: 약국 정보 관리 시 관련 법규 준수 - **개인정보보호법**: 고객 데이터 수집, 처리, 보관 시 법적 요구사항 충족 - **전자상거래법**: 구독 서비스 약관 및 취소 정책 명시 ### 8.2 확장성 고려 - **멀티테넌트 아키텍처**: 향후 다양한 업종 확장 대비 - **API 우선 설계**: 모바일 앱 및 제3자 연동 대비 - **클라우드 네이티브**: 서비스 확장에 따른 인프라 자동 스케일링 ### 8.3 운영 및 모니터링 - **서비스 상태 모니터링**: 각 서비스별 실시간 상태 체크 - **사용자 행동 분석**: 가입 전환율, 이탈률, 서비스 사용 패턴 분석 - **고객 만족도 조사**: 정기적인 NPS 조사 및 피드백 수집