# Direct Rider Platform - สรุปโครงการแบบละเอียด ## 1. 🎯 Concept ของแพลตฟอร์ม ### 1.1 Vision Statement > "ปฏิวัติวงการ Food Delivery โดยตัดตัวกลาง ให้ไรเดอร์เป็นผู้ประกอบการอิสระ สร้างระบบที่ทุกฝ่ายได้ประโยชน์" ### 1.2 Core Concept ``` Traditional Model (4 ฝ่าย): ร้านค้า → แพลตฟอร์ม → ไรเดอร์ → ลูกค้า Our Model (2 ฝ่าย): ไรเดอร์ ↔ ลูกค้า ``` ### 1.3 Key Innovation Points #### **Rider as Entrepreneur** - ไรเดอร์ไม่ใช่ลูกจ้าง แต่เป็นเจ้าของธุรกิจ - มีรหัสร้านส่วนตัว (เช่น #9834) - สร้าง Brand และฐานลูกค้าของตัวเอง - เลือกโซน/ร้านค้าที่ต้องการได้ #### **No Platform Commission** - ไม่หัก 25-35% เหมือนแพลตฟอร์มเดิม - เก็บเพียงค่าธรรมเนียมรายวัน 20-50฿ - ค่าธุรกรรม 1฿ ต่อออเดอร์ #### **Credit as Security System** - Credit ไม่ใช่เงินซื้อของ แต่เป็นหลักประกัน - ป้องกันการทุจริต 100% - ไรเดอร์ใช้เงินสดตัวเองซื้อของ - ได้รับเงินคืน + กำไรทันทีเมื่อส่งสำเร็จ #### **Multi-Store Shopping** - ลูกค้าสั่งจากหลายร้านในออเดอร์เดียว - ประหยัดค่าส่ง - สะดวก รวดเร็ว ### 1.4 Value Propositions | Stakeholder | Pain Points (Current) | Our Solution | Value Created | |-------------|----------------------|--------------|---------------| | **ไรเดอร์** | - รายได้ถูกหัก 25-35%
- ไม่มีอำนาจต่อรอง
- รอรอบจ่ายเงิน | - ได้รายได้เต็ม 100%
- เป็นเจ้าของธุรกิจ
- ได้เงินทันที | รายได้เพิ่ม 30-40% | | **ลูกค้า** | - ค่าอาหารแพง +30%
- ค่าส่งแพง
- สั่งได้ทีละร้าน | - ราคาอาหารจริง
- ค่าส่งถูกลง
- สั่งหลายร้านได้ | ประหยัด 25-35% | | **แพลตฟอร์ม** | - | - รายได้คงที่
- ต้นทุนต่ำ
- Scale ได้เร็ว | Profit margin 40% | --- ## 2. 💰 ระบบการคำนวณและตัวเลข ### 2.1 โครงสร้างราคาเปรียบเทียบ #### **ระบบเดิม (Grab/FoodPanda)** ``` ตัวอย่าง: ข้าวผัดกะเพรา ├── ราคาจริงที่ร้าน: 50฿ ├── ราคาบนแอพ: 65฿ (+30% markup) ├── ค่าส่ง: 25฿ ├── Platform fee: 9฿ ├── ค่าบริการอื่นๆ: 2฿ └── ลูกค้าจ่ายทั้งหมด: 101฿ การกระจายรายได้: - ร้านค้าได้: 50฿ (49.5%) - แพลตฟอร์มได้: 26฿ (25.7%) - ไรเดอร์ได้: 25฿ (24.7%) ``` #### **ระบบใหม่ (Direct Rider)** ``` ตัวอย่าง: ข้าวผัดกะเพรา ├── ราคาจริงที่ร้าน: 50฿ ├── ค่าส่ง: 25฿ ├── ค่าธุรกรรม: 1฿ └── ลูกค้าจ่ายทั้งหมด: 76฿ (ประหยัด 25฿ = 24.7%) การกระจายรายได้: - ร้านค้าได้: 50฿ (ไรเดอร์จ่ายเงินสด) - แพลตฟอร์มได้: 1฿ (1.3%) - ไรเดอร์ได้: 25฿ (32.9%) ``` ### 2.2 Multi-Store Order Calculation ```python # ตัวอย่างการคำนวณ Multi-Store Order order = { "stores": [ {"name": "ร้าน A", "items_total": 50}, {"name": "7-Eleven", "items_total": 35}, {"name": "ร้าน B", "items_total": 30} ], "distance_km": 4.2, "num_pickups": 3 } # Calculation items_total = sum(store["items_total"] for store in order["stores"]) # 115฿ base_delivery = 25 # สำหรับ 3-5 km pickup_fee = (order["num_pickups"] - 1) * 10 # 20฿ (2 ร้านเพิ่ม) platform_fee = 1 total = items_total + base_delivery + pickup_fee + platform_fee # 161฿ # เปรียบเทียบกับการสั่งแยก 3 แอพ traditional_cost = (65+25+11) + (45.5+25+11) + (39+25+11) # 257.5฿ savings = traditional_cost - total # 96.5฿ (37.5%) ``` ### 2.3 Credit System และ Working Capital #### **ระดับไรเดอร์และ Credit Requirements** | Level | Credit ประกัน | เงินสดสำรอง | ค่าธรรมเนียม/วัน | ออเดอร์สูงสุด/วัน | |-------|--------------|-------------|-----------------|------------------| | Bronze | 1,000฿ | 500-800฿ | 50฿ | 8-10 | | Silver | 2,000฿ | 1,000-1,500฿ | 40฿ | 15-18 | | Gold | 3,500฿ | 1,500-2,500฿ | 30฿ | 25-30 | | Platinum | 5,000฿ | 2,500-3,500฿ | 20฿ | 35-40 | #### **Cash Flow ของไรเดอร์ (ตัวอย่าง Silver)** ``` เช้า (เริ่มงาน): ├── Credit ในระบบ: 2,000฿ (หลักประกัน) ├── เงินสดในกระเป๋า: 1,500฿ └── หัก ค่าธรรมเนียมรายวัน: -40฿ ออเดอร์ที่ 1-5 (10:00-12:00): ├── ใช้เงินสดซื้อของ: -500฿ ├── เงินสดคงเหลือ: 1,000฿ ├── ส่งครบ 5 ออเดอร์ ├── ได้ Credit: 650฿ ├── ถอนทันที → เงินสด: 1,650฿ └── กำไรสะสม: +150฿ ออเดอร์ที่ 6-10 (12:00-15:00): ├── ใช้เงินสดซื้อของ: -700฿ ├── ส่งครบ → ได้ Credit: 910฿ ├── ถอน → เงินสด: 1,860฿ └── กำไรสะสม: +360฿ ออเดอร์ที่ 11-15 (17:00-20:00): ├── ใช้เงินสดซื้อของ: -650฿ ├── ส่งครบ → ได้ Credit: 845฿ ├── ถอน → เงินสด: 2,055฿ └── กำไรสะสม: +555฿ สรุปทั้งวัน: ├── เงินสดเริ่มต้น: 1,500฿ ├── เงินสดปลายวัน: 2,055฿ ├── กำไรก่อนหักค่าธรรมเนียม: 555฿ ├── หักค่าธรรมเนียม: -40฿ └── กำไรสุทธิ: 515฿ ``` ### 2.4 รายได้ประมาณการ #### **รายได้ไรเดอร์** ``` รายวัน: ├── Bronze: 400-500฿ ├── Silver: 500-750฿ ├── Gold: 750-1,200฿ └── Platinum: 1,200-1,800฿ รายเดือน (ทำงาน 26 วัน): ├── Bronze: 10,400-13,000฿ ├── Silver: 13,000-19,500฿ ├── Gold: 19,500-31,200฿ └── Platinum: 31,200-46,800฿ เพิ่มขึ้นจากระบบเดิม: 25-40% ``` #### **รายได้แพลตฟอร์ม** ``` Assumptions: - Active Riders: 1,000 คน - Average Orders/Day: 15,000 - Distribution: Bronze 20%, Silver 50%, Gold 25%, Platinum 5% Daily Revenue: ├── ค่าธรรมเนียมรายวัน: │ ├── Bronze (200): 10,000฿ │ ├── Silver (500): 20,000฿ │ ├── Gold (250): 7,500฿ │ └── Platinum (50): 1,000฿ ├── ค่าธุรกรรม (15,000 x 1฿): 15,000฿ └── Total Daily: 53,500฿ Monthly Revenue: 1,605,000฿ Monthly Costs: 880,000฿ Monthly Profit: 725,000฿ Profit Margin: 45.2% ``` ### 2.5 Dynamic Pricing Formula ```python def calculate_delivery_fee(distance_km, num_stores, time_of_day, weather): # Base fee structure if distance_km <= 2: base_fee = 20 elif distance_km <= 5: base_fee = 25 else: base_fee = 30 + (distance_km - 5) * 5 # Multi-store pickup fee pickup_fee = (num_stores - 1) * 10 # Time multiplier peak_hours = [(11, 13), (18, 20)] is_peak = any(start <= time_of_day.hour < end for start, end in peak_hours) time_multiplier = 1.3 if is_peak else 1.0 # Weather multiplier weather_multiplier = 1.5 if weather == "rain" else 1.0 # Final calculation total_fee = (base_fee + pickup_fee) * time_multiplier * weather_multiplier return round(total_fee) ``` --- ## 3. 🛠️ Tech Stack และการพัฒนา ### 3.1 System Architecture Overview ``` ┌─────────────────────────────────────────────────────────┐ │ Load Balancer │ │ (AWS ALB/Nginx) │ └─────────────────────────────────────────────────────────┘ │ ┌─────────────────────┴─────────────────────┐ │ │ ┌───────▼────────┐ ┌────────▼────────┐ │ API Gateway │ │ Admin Portal │ │ (Kong/AWS API)│ │ (React/Next) │ └───────┬────────┘ └─────────────────┘ │ ┌───────▼────────────────────────────────────────────────┐ │ Microservices Layer (Python) │ ├─────────────────────────────────────────────────────────┤ │ • Auth Service • Order Service │ │ • User Service • Tracking Service │ │ • Payment Service • Notification Service │ │ • Credit Service • Analytics Service │ └─────────────────────────────────────────────────────────┘ │ │ ┌───────▼────────┐ ┌───────▼────────┐ │ PostgreSQL │ │ Redis │ │ (Primary DB) │ │ (Cache) │ └────────────────┘ └─────────────────┘ ``` ### 3.2 Backend Development (Python) #### **3.2.1 Core Framework & Libraries** ```python # requirements.txt # Core Framework fastapi==0.104.1 uvicorn==0.24.0 pydantic==2.5.0 # Database sqlalchemy==2.0.23 alembic==1.12.1 asyncpg==0.29.0 redis==5.0.1 # Authentication & Security python-jose[cryptography]==3.3.0 passlib[bcrypt]==1.7.4 python-multipart==0.0.6 # Payment Integration stripe==7.0.0 omise==0.11.0 # Thai payment gateway # Async Tasks celery==5.3.4 flower==2.0.1 # Monitoring prometheus-client==0.19.0 sentry-sdk==1.38.0 # Testing pytest==7.4.3 pytest-asyncio==0.21.1 ``` #### **3.2.2 Project Structure** ``` backend/ ├── app/ │ ├── api/ │ │ ├── v1/ │ │ │ ├── endpoints/ │ │ │ │ ├── auth.py │ │ │ │ ├── riders.py │ │ │ │ ├── orders.py │ │ │ │ ├── payments.py │ │ │ │ └── credits.py │ │ │ └── dependencies.py │ │ └── v2/ │ ├── core/ │ │ ├── config.py │ │ ├── security.py │ │ └── database.py │ ├── models/ │ │ ├── user.py │ │ ├── rider.py │ │ ├── order.py │ │ └── transaction.py │ ├── schemas/ │ │ ├── user.py │ │ ├── rider.py │ │ └── order.py │ ├── services/ │ │ ├── auth_service.py │ │ ├── credit_service.py │ │ ├── payment_service.py │ │ ├── order_service.py │ │ └── notification_service.py │ ├── utils/ │ │ ├── validators.py │ │ ├── exceptions.py │ │ └── helpers.py │ └── main.py ├── migrations/ ├── tests/ ├── docker-compose.yml ├── Dockerfile └── .env.example ``` #### **3.2.3 Key Services Implementation** **Credit Management Service** ```python # services/credit_service.py from decimal import Decimal from typing import Optional from sqlalchemy.ext.asyncio import AsyncSession from app.models.credit import Credit, CreditTransaction from app.core.exceptions import InsufficientCreditError class CreditService: def __init__(self, db: AsyncSession): self.db = db async def add_credit( self, rider_id: int, amount: Decimal, transaction_type: str, reference_id: Optional[str] = None ): """Add credit to rider account""" async with self.db.begin(): # Get current credit with lock credit = await self.db.query(Credit).filter( Credit.rider_id == rider_id ).with_for_update().first() if not credit: credit = Credit(rider_id=rider_id, balance=Decimal(0)) self.db.add(credit) # Update balance credit.balance += amount # Create transaction record transaction = CreditTransaction( rider_id=rider_id, amount=amount, type=transaction_type, reference_id=reference_id, balance_after=credit.balance ) self.db.add(transaction) await self.db.commit() return credit.balance async def validate_credit( self, rider_id: int, required_amount: Decimal ): """Validate if rider has sufficient credit""" credit = await self.db.query(Credit).filter( Credit.rider_id == rider_id ).first() if not credit or credit.balance < required_amount: raise InsufficientCreditError( f"Insufficient credit. Required: {required_amount}, " f"Available: {credit.balance if credit else 0}" ) return True ``` **Payment Processing Service** ```python # services/payment_service.py import stripe from app.core.config import settings from app.schemas.payment import PaymentRequest, PaymentResponse class PaymentService: def __init__(self): stripe.api_key = settings.STRIPE_SECRET_KEY async def create_payment_intent( self, payment_request: PaymentRequest ) -> PaymentResponse: """Create payment intent for customer""" try: intent = stripe.PaymentIntent.create( amount=int(payment_request.amount * 100), # Convert to cents currency="thb", payment_method_types=["card", "promptpay"], metadata={ "order_id": payment_request.order_id, "customer_id": payment_request.customer_id } ) return PaymentResponse( payment_intent_id=intent.id, client_secret=intent.client_secret, status="pending" ) except stripe.error.StripeError as e: raise PaymentError(f"Payment processing failed: {str(e)}") async def confirm_payment( self, payment_intent_id: str ) -> bool: """Confirm payment completion""" intent = stripe.PaymentIntent.retrieve(payment_intent_id) return intent.status == "succeeded" ``` **Order Management Service** ```python # services/order_service.py from typing import List from app.models.order import Order, OrderItem from app.services.credit_service import CreditService from app.services.notification_service import NotificationService class OrderService: def __init__(self, db, credit_service, notification_service): self.db = db self.credit_service = credit_service self.notification_service = notification_service async def complete_order(self, order_id: int): """Complete order and process payments""" async with self.db.begin(): order = await self.db.query(Order).filter( Order.id == order_id ).with_for_update().first() if not order: raise OrderNotFoundError(f"Order {order_id} not found") # Calculate rider earnings total_amount = order.total_amount # Add credit to rider account await self.credit_service.add_credit( rider_id=order.rider_id, amount=total_amount, transaction_type="order_completion", reference_id=f"ORDER_{order_id}" ) # Update order status order.status = "completed" order.completed_at = datetime.utcnow() # Send notifications await self.notification_service.send_notification( user_id=order.customer_id, message=f"Your order #{order_id} has been delivered!" ) await self.db.commit() ``` ### 3.3 Frontend Development #### **3.3.1 Mobile Apps (React Native)** **Tech Stack** ```json // package.json { "dependencies": { "react-native": "0.72.7", "react-navigation": "^5.0.0", "react-native-maps": "^1.8.0", "react-native-vector-icons": "^10.0.0", "react-native-push-notification": "^8.1.1", "react-native-geolocation-service": "^5.3.1", "@react-native-async-storage/async-storage": "^1.19.5", "react-query": "^3.39.3", "zustand": "^4.4.7", "react-native-stripe": "^0.35.0" } } ``` **Project Structure (Monorepo)** ``` mobile/ ├── apps/ │ ├── rider/ │ │ ├── src/ │ │ │ ├── screens/ │ │ │ ├── components/ │ │ │ ├── navigation/ │ │ │ ├── services/ │ │ │ ├── store/ │ │ │ └── utils/ │ │ └── app.json │ └── customer/ │ ├── src/ │ └── app.json ├── packages/ │ ├── shared-ui/ │ ├── api-client/ │ └── utils/ └── package.json ``` **Key Components - Rider App** ```jsx // apps/rider/src/screens/OrderScreen.jsx import React, { useState, useEffect } from 'react'; import { View, Text, Button } from 'react-native'; import MapView, { Marker, Polyline } from 'react-native-maps'; import { useOrderStore } from '../store/orderStore'; export const OrderScreen = ({ route }) => { const { orderId } = route.params; const { order, updateOrderStatus } = useOrderStore(); const [currentLocation, setCurrentLocation] = useState(null); const handleStatusUpdate = async (newStatus) => { await updateOrderStatus(orderId, newStatus); if (newStatus === 'delivered') { // Trigger credit settlement await api.completeOrder(orderId); } }; return ( {/* Show route and markers */} Order #{orderId} Total: ฿{order.totalAmount}

SECURE_ACCESS

Direct Rider Platform (Updated)

CONFIRM_DELETE