API গেটওয়ে ও ব্যাক-এন্ড-ফর-ফ্রন্ট-এন্ড (BFF) প্যাটার্ন

# ---------- ব্যাকএন্ড সার্ভিস সিমুলেশন -- একাধিক আলাদা মাইক্রোসার্ভিস ----------
def user_service(user_id):
    return {
        "id": user_id,
        "name": "রিমা আক্তার",
        "email": "rima@example.com",
        "bio": "সফটওয়্যার ইঞ্জিনিয়ার, ঢাকা।",
        "joined": "2021-03-14",
    }

def orders_service(user_id):
    return [
        {"order_id": 101, "item": "কীবোর্ড", "price": 1200, "status": "ডেলিভারড"},
        {"order_id": 102, "item": "মাউস", "price": 450, "status": "প্রসেসিং"},
    ]

def recommendations_service(user_id):
    return ["মনিটর স্ট্যান্ড", "USB হাব", "ল্যাপটপ স্লিভ"]


# ---------- API গেটওয়ে (BFF) -- রাউট করে, একত্র করে, ক্লায়েন্ট-নির্দিষ্ট শেপে সাজায় ----------
def api_gateway(path, params, client_type="web"):
    if path == "/dashboard":
        # একাধিক ব্যাকএন্ড সার্ভিস থেকে ডেটা একত্র করা (aggregation) -- এটাই গেটওয়ের মূল কাজ
        user = user_service(params["user_id"])
        orders = orders_service(params["user_id"])
        recommendations = recommendations_service(params["user_id"])

        if client_type == "mobile":
            # BFF: মোবাইল ক্লায়েন্টের জন্য ছোট, ছাঁটাই করা রেসপন্স -- ব্যান্ডউইথ বাঁচাতে
            return {
                "name": user["name"],
                "order_count": len(orders),
                "latest_order_status": orders[0]["status"] if orders else None,
            }
        else:
            # BFF: ওয়েব ক্লায়েন্টের জন্য পূর্ণাঙ্গ, বিস্তারিত রেসপন্স
            return {
                "user": user,
                "orders": orders,
                "recommendations": recommendations,
            }

    elif path == "/orders":
        return {"orders": orders_service(params["user_id"])}

    else:
        return {"error": "404 Not Found"}


print("== একই /dashboard রিকোয়েস্ট, দুই ভিন্ন ক্লায়েন্ট টাইপে ==")

web_response = api_gateway("/dashboard", {"user_id": 7}, client_type="web")
print("ওয়েব ক্লায়েন্ট রেসপন্স:")
print(web_response)
print(f"ওয়েব রেসপন্সে মোট টপ-লেভেল কী: {len(web_response)}")

mobile_response = api_gateway("/dashboard", {"user_id": 7}, client_type="mobile")
print("\nমোবাইল ক্লায়েন্ট রেসপন্স:")
print(mobile_response)
print(f"মোবাইল রেসপন্সে মোট টপ-লেভেল কী: {len(mobile_response)}")

print("\n== একই গেটওয়ে দিয়ে ভিন্ন পাথ রাউট হচ্ছে ==")
print(api_gateway("/orders", {"user_id": 7}))
print(api_gateway("/unknown-path", {}))