Deployment Architecture

🏛️ DEPLOYMENT_ARCHITECTURE.md - Deployment Architecture (สถาปัตยกรรมการขึ้นติดตั้งระบบ)

This document describes the physical and container deployment topology of the SplitDee platform.
เอกสารฉบับนี้สรุปภาพรวมและผังโครงสร้างการจัดส่งระบบ (Deployment) ในการรันแอปพลิเคชันจริงบน Docker คอนเทนเนอร์

---

🇹🇭 ภาษาไทย (สำหรับผู้ใช้งาน)

📊 สรุปโครงสร้างการจัดวางระบบ (Deployment Topology)

• ด่านหน้าเว็บเซิร์ฟเวอร์ (Nginx Ingress Proxy):
  • ตู้บริการ: splitdee-nginx
  • พอร์ตเปิดรับ: พอร์ต 80 (HTTP ทำการสลับเด้งเส้นทางไป 443 อัตโนมัติ) และพอร์ต 443 (HTTPS)
  • การเข้ารหัส: จัดตั้งใบรับรองความปลอดภัยและคีย์ลับ SSL ผ่าน Certbot Let’s Encrypt และคัดส่งต่อไปหาแอปหลังบ้านพอร์ต 8000
• แอปพลิเคชันเวอร์เวอร์หลังบ้าน (FastAPI backend server):
  • ตู้บริการ: splitdee-backend
  • สภาพแวดล้อม: รันบนภาพจำลองไพทอน 3.12 (Python 3.12) คู่กับ Uvicorn ASGI server หลายเวิร์กเกอร์แยกเธรด
  • ความปลอดภัย: ปิดกั้นพอร์ตภายนอก รับสายต่อตรงจากตู้ Nginx Proxy ด้านในเน็ตเวิร์กภายในเท่านั้น
• หมวดฐานข้อมูลและแคชด่วน (Storage Layer):
  • ตู้บริการ: splitdee-db (PostgreSQL) และ splitdee-redis (Redis Cache)
  • ความปลอดภัย: ปิดช่องเชื่อมจากอินเตอร์เน็ตภายนอก 100% เชื่อมต่อตรงได้เฉพาะแอปหลังบ้านภายใน Docker network เท่านั้น
  • การรักษาข้อมูล: ใช้กลไก mounts ออกแอลฟ่าโวลลุ่มหลักโฮสต์โฮมเครื่อง (pgdata และ media) ป้องกันข้อมูลและหลักฐานรูปภาพสลิปใบเสร็จสูญหาย

---

🇬🇧 English (For AI Agents)

🗺️ Deployment Diagram

graph TD
    UserClient[Mobile App Client]
    Internet((Internet))

    subgraph LinuxVPS [Production Linux VPS Server]
        subgraph DockerNetwork [Isolated Docker Bridge Network]
            Nginx[Nginx Reverse Proxy Container]
            FastAPI[FastAPI App Container]
            Postgres[PostgreSQL DB Container]
            Redis[Redis Cache Container]
        end

        subgraph LocalDisk [Local Host Disk Storage]
            PGVolume[(pgdata volume)]
            MediaVolume[(media volume)]
        end
    end

    subgraph ExternalCloud [Third-Party Cloud Services]
        S3Bucket[AWS S3 Secure Storage]
        BankAPI[Bank Slip Verification API]
        FCMService[Firebase Cloud Messaging]
    end

    UserClient -- HTTPS (443) / WSS --> Internet
    Internet --> Nginx
    Nginx -- Proxy Pass (8000) --> FastAPI
    FastAPI --> Postgres
    FastAPI --> Redis
    
    Postgres -- Mounts --> PGVolume
    FastAPI -- Mounts --> MediaVolume
    FastAPI -- Secure Upload --> S3Bucket
    FastAPI -- HTTPS Web Request --> BankAPI
    FastAPI -- Admin SDK push --> FCMService

📝 Topology Details

• 1. Ingress Proxy (Nginx)
  • Container Name: splitdee-nginx
  • Ports: Exposes port 80 (redirects to 443) and port 443 (SSL).
  • SSL: Terminated via Certbot Let’s Encrypt. Routes /api/v1 calls to FastAPI backend container port 8000.
• 2. Application Server (FastAPI)
  • Container Name: splitdee-backend
  • Runtime: Python 3.12 multi-worker process running under Uvicorn ASGI server.
  • Security: Isolated behind the Nginx reverse proxy. Exposes no public ports.
• 3. Storage Layer (PostgreSQL & Redis)
  • Container Names: splitdee-db, splitdee-redis
  • Security: Private inside the Docker network. Strictly inaccessible from the public internet.
  • Persistence: Mounted host directory volumes pgdata for Postgres and media for static slip uploads.