청약 관리 API 추가 (/api/subscription)

- subscription_items 테이블: 청약 목록 CRUD (GET/POST/PUT/DELETE)
- subscription_profile 테이블: 내 청약 조건 프로필 싱글톤 (GET/PUT, upsert)
- specialQuals JSON 배열, bool → int SQLite 변환 처리

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

backend/app/main.py

@@ -16,6 +16,10 @@ from .db import (
     get_all_posts, create_post, update_post, delete_post,
     # realestate
     get_all_complexes, get_complex, create_complex, update_complex, delete_complex,
+    # subscription
+    get_all_subscription_items, create_subscription_item,
+    update_subscription_item, delete_subscription_item,
+    get_subscription_profile, upsert_subscription_profile,
 )
 from .recommender import recommend_numbers, recommend_with_heatmap
 from .collector import sync_latest, sync_ensure_all
@@ -751,3 +755,110 @@ def api_realestate_delete(complex_id: int):
     if not ok:
         raise HTTPException(status_code=404, detail="Complex not found")
     return {"ok": True}
+
+
+# ── Subscription API ───────────────────────────────────────────────────────────
+
+class SubscriptionItemCreate(BaseModel):
+    complexName: str
+    address: str = ""
+    pyeong: Optional[str] = None
+    totalPrice: Optional[int] = None
+    type: Optional[str] = None
+    specialType: Optional[str] = None
+    supplyType: Optional[str] = None
+    status: str = "검토중"
+    minScore: Optional[int] = None
+    maxIncome: Optional[int] = None
+    homelessRequired: Optional[int] = None
+    subscriptionStart: Optional[str] = None
+    subscriptionEnd: Optional[str] = None
+    contractDate: Optional[str] = None
+    interimDate: Optional[str] = None
+    balanceDate: Optional[str] = None
+    resultDate: Optional[str] = None
+    depositRate: int = 10
+    interimRate: int = 60
+    balanceRate: int = 30
+    loanType: Optional[str] = None
+    loanRate: Optional[float] = None
+    memo: str = ""
+    naverUrl: str = ""
+
+
+class SubscriptionItemUpdate(BaseModel):
+    complexName: Optional[str] = None
+    address: Optional[str] = None
+    pyeong: Optional[str] = None
+    totalPrice: Optional[int] = None
+    type: Optional[str] = None
+    specialType: Optional[str] = None
+    supplyType: Optional[str] = None
+    status: Optional[str] = None
+    minScore: Optional[int] = None
+    maxIncome: Optional[int] = None
+    homelessRequired: Optional[int] = None
+    subscriptionStart: Optional[str] = None
+    subscriptionEnd: Optional[str] = None
+    contractDate: Optional[str] = None
+    interimDate: Optional[str] = None
+    balanceDate: Optional[str] = None
+    resultDate: Optional[str] = None
+    depositRate: Optional[int] = None
+    interimRate: Optional[int] = None
+    balanceRate: Optional[int] = None
+    loanType: Optional[str] = None
+    loanRate: Optional[float] = None
+    memo: Optional[str] = None
+    naverUrl: Optional[str] = None
+
+
+class SubscriptionProfile(BaseModel):
+    isHouseholdHead: Optional[bool] = None
+    isHomeless: Optional[bool] = None
+    homelessPeriod: Optional[int] = None
+    savingsMonths: Optional[int] = None
+    savingsCount: Optional[int] = None
+    dependents: Optional[int] = None
+    residencyArea: Optional[str] = None
+    isMarried: Optional[bool] = None
+    marriageMonths: Optional[int] = None
+    monthlyIncome: Optional[int] = None
+    specialQuals: Optional[List[str]] = None
+
+
+@app.get("/api/subscription/items")
+def api_subscription_list():
+    return get_all_subscription_items()
+
+
+@app.post("/api/subscription/items", status_code=201)
+def api_subscription_create(body: SubscriptionItemCreate):
+    return create_subscription_item(body.model_dump())
+
+
+@app.put("/api/subscription/items/{item_id}")
+def api_subscription_update(item_id: int, body: SubscriptionItemUpdate):
+    updated = update_subscription_item(item_id, body.model_dump(exclude_none=True))
+    if updated is None:
+        raise HTTPException(status_code=404, detail="Item not found")
+    return updated
+
+
+@app.delete("/api/subscription/items/{item_id}")
+def api_subscription_delete(item_id: int):
+    ok = delete_subscription_item(item_id)
+    if not ok:
+        raise HTTPException(status_code=404, detail="Item not found")
+    return {"ok": True}
+
+
+@app.get("/api/subscription/profile")
+def api_subscription_profile_get():
+    profile = get_subscription_profile()
+    return profile if profile is not None else {}
+
+
+@app.put("/api/subscription/profile")
+def api_subscription_profile_put(body: SubscriptionProfile):
+    return upsert_subscription_profile(body.model_dump(exclude_none=True))