feat: add laposte and expiditor etiquette

Author: Leoglme

api/EBAY.md

@@ -20,6 +20,14 @@ In the developer portal, configure OAuth:
 
 **Important:** no mismatch in trailing slash, `http` vs `https`, or host (`localhost` vs `127.0.0.1`) between the eBay portal, `EBAY_REDIRECT_URI`, and the URL actually opened in the browser.
 
+### Local dev / desktop (Tauri) — “j’ai l’impression de passer sur une vieille version”
+
+After you approve eBay, **the browser always lands on `EBAY_REDIRECT_URI`**, not on whatever tab you started from.
+
+If `EBAY_REDIRECT_URI` points to **production** (e.g. `https://goupixdex.example/settings/marketplaces`) but you started OAuth from **`http://localhost:3000`** or a **Tauri dev** window, you will be redirected to **that production URL**. You then load the **deployed** front-end: no Nuxt devtools, no floating “Redémarrer workers / Sync DB” (those only exist when `import.meta.dev` is true), and the UI may lag behind your local branch.
+
+**Fix:** for local work, register and set `EBAY_REDIRECT_URI` to the **same origin** as the app you are running (e.g. `http://localhost:3000/settings/marketplaces` or your Tauri dev URL if eBay allows it). Use a separate eBay keyset/sandbox RuName if needed.
+
 ## 3. Scopes used by GoupixDex
 
 The API requests these scopes (already set in the backend):
@@ -65,6 +73,7 @@ Fulfillment shipping options (multiple domestic rates, international, handling t
 
 ## 8. Quick troubleshooting
 
+- **Après « Se connecter à eBay », l’app ressemble à une vieille version / plus d’outils dev** : eBay vous renvoie toujours vers `EBAY_REDIRECT_URI`. Si cette URL est la **production** alors que vous étiez en **localhost** ou Tauri dev, vous chargez le site déployé (build sans mode dev). Alignez `EBAY_REDIRECT_URI` + RuName eBay sur l’origine où vous travaillez — voir §2 ci-dessus.
 - **Token exchange error**: `redirect_uri` does not match what is registered at eBay, or `code` already used / expired (codes are single-use and short-lived).
 - **“User is not eligible for Business Policy”** (logs: error 20403 on `fulfillment_policy`): the account must be enrolled in **business policies**. The API calls [`optInToProgram`](https://developer.ebay.com/api-docs/sell/account/resources/program/methods/optInToProgram) with `SELLING_POLICY_MANAGEMENT` before loading policies; eBay can take **up to ~24 h** to activate — retry later or check with `getOptedInPrograms`.
 - **Publishing error**: wrong category, policies incompatible with the marketplace, or **condition descriptors** required for some card categories — see API logs (`ebay_body`).

api/migrations/010_shipping_sender_address.sql

@@ -0,0 +1,6 @@
+-- Return / sender address for envelope flap labels (per user).
+ALTER TABLE settings ADD COLUMN IF NOT EXISTS sender_full_name VARCHAR(120) NULL;
+ALTER TABLE settings ADD COLUMN IF NOT EXISTS sender_line1 VARCHAR(180) NULL;
+ALTER TABLE settings ADD COLUMN IF NOT EXISTS sender_line2 VARCHAR(180) NULL;
+ALTER TABLE settings ADD COLUMN IF NOT EXISTS sender_postal_code VARCHAR(20) NULL;
+ALTER TABLE settings ADD COLUMN IF NOT EXISTS sender_city VARCHAR(80) NULL;

api/models/margin_settings.py

@@ -24,5 +24,11 @@ class MarginSettings(Base):
     ebay_fulfillment_policy_id: Mapped[str | None] = mapped_column(String(32), nullable=True)
     ebay_payment_policy_id: Mapped[str | None] = mapped_column(String(32), nullable=True)
     ebay_return_policy_id: Mapped[str | None] = mapped_column(String(32), nullable=True)
+    #: Envelope flap (return) address — used when printing shipping label sheets.
+    sender_full_name: Mapped[str | None] = mapped_column(String(120), nullable=True)
+    sender_line1: Mapped[str | None] = mapped_column(String(180), nullable=True)
+    sender_line2: Mapped[str | None] = mapped_column(String(180), nullable=True)
+    sender_postal_code: Mapped[str | None] = mapped_column(String(20), nullable=True)
+    sender_city: Mapped[str | None] = mapped_column(String(80), nullable=True)
 
     user: Mapped["User"] = relationship(back_populates="margin_settings")

api/requirements.txt

@@ -30,6 +30,7 @@ vinted-scraper>=3.0.0
 
 # Shipping label PDF generation (Avery L7173 — 8 labels per A4)
 reportlab>=4.0.0
+pymupdf>=1.24.0
 
 # Cardmarket order PDF text extraction
 pypdf>=5.0.0

api/routes/ebay_route.py

@@ -83,16 +83,18 @@ def ebay_authorize_url(
     force_login: Annotated[bool, Query()] = False,
 ) -> dict[str, str]:
     """Build the browser URL for eBay consent (User must open it)."""
+    app = get_settings()
     try:
-        url = build_authorization_url(state=state, force_login=force_login)
+        url = build_authorization_url(state=state, force_login=force_login, app=app)
     except RuntimeError as exc:
         if str(exc) == "ebay_oauth_not_configured":
             raise HTTPException(
                 status_code=status.HTTP_503_SERVICE_UNAVAILABLE,
                 detail="eBay OAuth is not configured on the server (EBAY_CLIENT_ID, EBAY_CLIENT_SECRET, EBAY_REDIRECT_URI).",
             ) from exc
         raise HTTPException(status_code=500, detail=str(exc)) from exc
-    return {"authorization_url": url, "state": state}
+    redirect = (app.ebay_redirect_uri or "").strip()
+    return {"authorization_url": url, "state": state, "redirect_uri": redirect}
 
 
 @router.post("/oauth/exchange", status_code=status.HTTP_200_OK)

api/routes/settings_route.py

@@ -14,7 +14,11 @@
 from models.user import User
 from schemas.settings import SettingsResponse, SettingsUpdate
 from services.ebay_oauth_service import ebay_oauth_configured
-from services.user_settings_service import ebay_listing_config_complete, get_or_create_user_settings
+from services.user_settings_service import (
+    ebay_listing_config_complete,
+    get_or_create_user_settings,
+    sender_address_complete,
+)
 
 router = APIRouter(prefix="/settings", tags=["settings"])
 
@@ -37,6 +41,12 @@ def _to_response(db: Session, user: User) -> SettingsResponse:
         ebay_listing_config_complete=ebay_listing_config_complete(s),
         ebay_oauth_configured=ebay_oauth_configured(app),
         ebay_environment="sandbox" if app.ebay_use_sandbox else "production",
+        sender_full_name=(s.sender_full_name or "").strip() or None,
+        sender_line1=(s.sender_line1 or "").strip() or None,
+        sender_line2=(s.sender_line2 or "").strip() or None,
+        sender_postal_code=(s.sender_postal_code or "").strip() or None,
+        sender_city=(s.sender_city or "").strip() or None,
+        sender_address_complete=sender_address_complete(s),
     )
 
 
@@ -82,6 +92,19 @@ def put_margin_settings(
                 setattr(s, key, None)
             else:
                 setattr(s, key, str(val).strip())
+    for key in (
+        "sender_full_name",
+        "sender_line1",
+        "sender_line2",
+        "sender_postal_code",
+        "sender_city",
+    ):
+        if key in data:
+            val = data[key]
+            if val is None or (isinstance(val, str) and not val.strip()):
+                setattr(s, key, None)
+            else:
+                setattr(s, key, str(val).strip())
     db.commit()
     db.refresh(s)
     return _to_response(db, user)

api/routes/shipping_route.py

@@ -17,11 +17,15 @@
 from services.ebay_orders_service import list_unshipped_orders
 from services.ebay_publish_service import ensure_ebay_access_token
 from services.shipping_label_service import LabelAddress, render_labels_pdf
-from services.user_settings_service import get_or_create_user_settings
+from services.stamp_overlay_service import decode_stamp_pdf_base64, overlay_stamps_on_labels_pdf
+from services.user_settings_service import get_or_create_user_settings, sender_address_complete
 
 router = APIRouter(prefix="/shipping", tags=["shipping"])
 
 
+_STAMP_B64_MAX_LEN = 6_000_000
+
+
 class ShippingLabelInput(BaseModel):
     """One recipient block. Edits made before printing never touch the eBay order."""
 
@@ -32,6 +36,11 @@ class ShippingLabelInput(BaseModel):
     city: str = Field(..., min_length=1, max_length=80)
     state: str | None = Field(default=None, max_length=80)
     country_code: str | None = Field(default="FR", max_length=3)
+    stamp_pdf_base64: str | None = Field(
+        default=None,
+        max_length=_STAMP_B64_MAX_LEN,
+        description="Optional La Poste stamp PDF (single-page), base64 or data URL.",
+    )
 
 
 class ShippingLabelsBody(BaseModel):
@@ -84,27 +93,71 @@ async def shipping_ebay_orders(
 @router.post("/labels.pdf")
 async def shipping_labels_pdf(
     body: ShippingLabelsBody,
+    db: Annotated[Session, Depends(get_db)],
     user: Annotated[User, Depends(get_current_user)],  # noqa: ARG001 (auth gate)
 ) -> Response:
     """
     Render the supplied recipient blocks as an A4 PDF (Avery L7173 — 99×57 mm, 8 per page).
 
-    Same endpoint serves both the in-app preview (iframe) and the final download — guarantees
-    the on-screen rendering matches the printed output byte-for-byte.
+    Each parcel uses **two** L7173 vignettes stacked vertically on the sheet (sender immediately below recipient).
+    The sender vignette uses a crop rectangle nearly full sticker width; address stays on **one line** under the name when
+    possible (font scales down, then ellipsis). Padding inside the crop marks is the same on top, bottom, left, and right.
+
+    Optional ``stamp_pdf_base64`` per row (PDF from laposte.fr): artwork on page 1 is overlaid at **native scale**
+    (no shrinking). Placement: **below** that parcel's sender vignette when the PDF grid leaves white space there (same
+    column); otherwise **flush-right** on the page, centred vertically on that parcel's recipient+sender pair; if neither
+    fits, an extra A4 page is appended for that stamp.
     """
-    addresses = [
-        LabelAddress(
-            full_name=row.full_name.strip(),
-            line1=row.line1.strip(),
-            line2=row.line2.strip() if row.line2 else None,
-            postal_code=row.postal_code.strip(),
-            city=row.city.strip(),
-            state=row.state.strip() if row.state else None,
-            country_code=(row.country_code or "FR").strip().upper() or "FR",
+    ms = get_or_create_user_settings(db, user.id)
+    if not sender_address_complete(ms):
+        raise HTTPException(
+            status_code=status.HTTP_400_BAD_REQUEST,
+            detail={
+                "code": "sender_address_incomplete",
+                "message": (
+                    "Configurez votre adresse expéditeur dans Paramètres → Configuration "
+                    "avant de générer les étiquettes."
+                ),
+            },
         )
-        for row in body.addresses
-    ]
-    pdf = render_labels_pdf(addresses)
+
+    stamps_by_parcel: list[bytes | None] = []
+    addresses: list[LabelAddress] = []
+    for idx, row in enumerate(body.addresses):
+        try:
+            stamp_bytes = decode_stamp_pdf_base64(row.stamp_pdf_base64)
+        except ValueError as exc:
+            raise HTTPException(
+                status_code=status.HTTP_400_BAD_REQUEST,
+                detail={
+                    "code": "invalid_stamp_pdf",
+                    "parcel_index": idx,
+                    "message": str(exc),
+                },
+            ) from exc
+        stamps_by_parcel.append(stamp_bytes)
+        addresses.append(
+            LabelAddress(
+                full_name=row.full_name.strip(),
+                line1=row.line1.strip(),
+                line2=row.line2.strip() if row.line2 else None,
+                postal_code=row.postal_code.strip(),
+                city=row.city.strip(),
+                state=row.state.strip() if row.state else None,
+                country_code=(row.country_code or "FR").strip().upper() or "FR",
+            )
+        )
+    sender = LabelAddress(
+        full_name=(ms.sender_full_name or "").strip(),
+        line1=(ms.sender_line1 or "").strip(),
+        line2=(ms.sender_line2 or "").strip() or None,
+        postal_code=(ms.sender_postal_code or "").strip(),
+        city=(ms.sender_city or "").strip(),
+        state=None,
+        country_code="FR",
+    )
+    pdf = render_labels_pdf(addresses, sender=sender)
+    pdf = overlay_stamps_on_labels_pdf(pdf, stamps_by_parcel)
     return Response(
         content=pdf,
         media_type="application/pdf",

api/schemas/settings.py

@@ -17,6 +17,12 @@ class SettingsResponse(BaseModel):
     ebay_listing_config_complete: bool
     ebay_oauth_configured: bool
     ebay_environment: str
+    sender_full_name: str | None
+    sender_line1: str | None
+    sender_line2: str | None
+    sender_postal_code: str | None
+    sender_city: str | None
+    sender_address_complete: bool
 
 
 class SettingsUpdate(BaseModel):
@@ -29,3 +35,8 @@ class SettingsUpdate(BaseModel):
     ebay_fulfillment_policy_id: str | None = Field(default=None, max_length=32)
     ebay_payment_policy_id: str | None = Field(default=None, max_length=32)
     ebay_return_policy_id: str | None = Field(default=None, max_length=32)
+    sender_full_name: str | None = Field(default=None, max_length=120)
+    sender_line1: str | None = Field(default=None, max_length=180)
+    sender_line2: str | None = Field(default=None, max_length=180)
+    sender_postal_code: str | None = Field(default=None, max_length=20)
+    sender_city: str | None = Field(default=None, max_length=80)