Expose portfolio projectUrl and document it for websites.

Wire create/update/list/detail to project_url and sync website OpenAPI, Postman, and AI brief.

Co-authored-by: Cursor <cursoragent@cursor.com>

docs/website-api/AI_PROMPT.md

@@ -31,7 +31,7 @@ You are building a **Meshkee business website (storefront)**. You must use the M
 ### Typical bootstrap sequence
 1. `GET /tenants/{domain}` → branding + `businessId` + `specialProductsSource` (`product` or `store_item`)
 2. Homepage: business-info, **static-images**, sliders, category-groups, brand-groups, store-specials (`source` repeats the tenant setting; items are store listings when `source` is `store_item`)
-3. Catalog: categories, products (`GET /products/{slug}` includes `relatedProducts`: same category then same brand, in-stock first), store-items (`name` instant search: in-stock first, then `updatedAt`), **user-products** (customer stock listings). Portfolios list newest first (`sortOrder` desc, then `publishedAt` / `createdAt` desc). List filters: products/blogs/portfolios/videos accept `?tag=` (exact match on `metadata.tags`).
+3. Catalog: categories, products (`GET /products/{slug}` includes `relatedProducts`: same category then same brand, in-stock first), store-items (`name` instant search: in-stock first, then `updatedAt`), **user-products** (customer stock listings). Portfolios list newest first (`sortOrder` desc, then `publishedAt` / `createdAt` desc); each portfolio may include nullable `projectUrl` (external website link). List filters: products/blogs/portfolios/videos accept `?tag=` (exact match on `metadata.tags`).
 4. Auth: register/login → store tokens. Optional: `POST /auth/send-otp` then `POST /auth/login-otp` (passwordless) or `POST /auth/reset-password` (forgot password). `POST /auth/verify-otp` only marks the cell verified (no tokens).
 5. Cart checkout with `addressId` or inline `shippingAddress` + `payment`
    - For online pay: `payment.type = "e_payment_gate"`, `gatewayType` (e.g. `"mellat"` or `"zarinpal"`), and absolute `returnUrl`

docs/website-api/Meshkee-Website-API.postman_collection.json

@@ -906,6 +906,7 @@
           ],
           "request": {
             "method": "GET",
+            "description": "Published portfolios (newest / highest sortOrder first). Items include nullable `projectUrl` (external website link).",
             "url": {
               "raw": "{{baseUrl}}/tenants/{{domain}}/portfolios?page=1&pageSize=12",
               "host": [
@@ -948,9 +949,18 @@
           "name": "Get published portfolio by slug (website)",
           "request": {
             "method": "GET",
+            "description": "Portfolio detail. Includes nullable `projectUrl` (external website link).",
             "url": "{{baseUrl}}/tenants/{{domain}}/portfolios/{{portfolioSlug}}"
           }
         },
+        {
+          "name": "Get published portfolio by id (website)",
+          "request": {
+            "method": "GET",
+            "description": "Preferred for /portfolios/{id}/{titleFaSlug} pages. Includes nullable `projectUrl`.",
+            "url": "{{baseUrl}}/tenants/{{domain}}/portfolios/by-id/{{portfolioId}}"
+          }
+        },
         {
           "name": "List portfolio comments (website)",
           "request": {

docs/website-api/openapi.json

@@ -1512,7 +1512,7 @@
         ],
         "responses": {
           "200": {
-            "description": "{ items, total, page, pageSize }"
+            "description": "{ items, total, page, pageSize }. Each item includes id, title/titleFa/titleEn, slug, abstract, projectUrl (nullable website link), status, categoryId/categoryName, tags, titleImageUrl, gallery, sortOrder, publishedAt, createdAt, updatedAt. Ordered by sortOrder desc, then publishedAt/createdAt desc."
           }
         }
       }
@@ -1538,7 +1538,7 @@
         ],
         "responses": {
           "200": {
-            "description": "{ portfolio }"
+            "description": "{ portfolio } — same fields as list items, plus mainTextHtml, comments, and commentCount. Includes nullable projectUrl (external website link)."
           }
         }
       }
@@ -1564,7 +1564,7 @@
         ],
         "responses": {
           "200": {
-            "description": "{ portfolio }"
+            "description": "{ portfolio } — same fields as list items, plus mainTextHtml, comments, and commentCount. Includes nullable projectUrl (external website link)."
           }
         }
       }