From b7d29d102839b6a190092ffa871371e0cb00e1e0 Mon Sep 17 00:00:00 2001
From: MMD <mola313002@gmail.com>
Date: Sun, 6 Sep 2026 22:30:17 +0330
Subject: [PATCH] =?UTF-8?q?=D9=85=D8=B3=D8=AA=D9=86=D8=AF=D8=B3=D8=A7?=
 =?UTF-8?q?=D8=B2=DB=8C=20=D9=88=DB=8C=D8=B1=D8=A7=DB=8C=D8=B4=20=D8=B2?=
 =?UTF-8?q?=D9=86=D8=AF=D9=87=20=D9=88=20=D8=A7=D9=86=D8=AA=D9=87=D8=A7?=
 =?UTF-8?q?=DB=8C=E2=80=8C=D9=86=D9=82=D8=B7=D9=87=E2=80=8C=D9=87=D8=A7?=
 =?UTF-8?q?=DB=8C=20=D8=AC=D8=AF=DB=8C=D8=AF=20=D8=AF=D8=B1=20README?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- README ریشه: بخش «ویرایش زنده سایت» — ورود از /admin/login، حالت
  ویرایش، ذخیره خودکار هر فیلد، ویرایش/حذف/ترتیب مجموعه‌ها، آپلود تصویر
  و نامرئی بودن لایه برای بازدیدکنندگان
- README بک‌اند: افزودن PATCH (ویرایش جزئی) و reorder به جدول
  انتهای‌نقطه‌ها + فهرست منابع دارای ستون position و نحوه مهاجرت سبک
---
 README.md         | 19 +++++++++++++++++++
 backend/README.md |  6 +++++-
 2 files changed, 24 insertions(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 2c6924d..c83e635 100644
--- a/README.md
+++ b/README.md
@@ -85,10 +85,29 @@ npm run dev
   و سپس CRUD کامل همه محتواها در `/api/admin/...`
 - **آپلود تصویر** `POST /api/admin/upload` (فقط توکن ادمین، حداکثر ۱۰MB) — فایل در MinIO
   ذخیره و URL نسبی `/media/...` برمی‌گردد
+- **ویرایش جزئی** `PATCH /api/admin/{resource}/{id}` — فقط فیلدهای ارسال‌شده عوض می‌شوند
+- **ترتیب‌بندی** `POST /api/admin/{resource}/reorder` — با `{"ids": [...]}`
 - همه محتوا در یک درخواست: `GET /api/site`
 
 > در محیط واقعی حتماً `SECRET_KEY`، `ADMIN_PASSWORD` و `MINIO_ROOT_PASSWORD` را تغییر دهید.
 
+## ویرایش زنده سایت (دوقلوی دیجیتال)
+
+ادمین‌ها نیازی به داشبورد جدا ندارند — خود سایت ویرایشگر است:
+
+1. به `/admin/login` بروید و وارد شوید
+2. نوار شناور پایین صفحه ظاهر می‌شود؛ **حالت ویرایش** را روشن کنید
+3. روی هر متن کلیک کنید و ویرایش کنید — **خروج از کادر، بلافاصله ذخیره می‌شود**
+   (Enter ذخیره، Esc لغو)؛ وضعیت ذخیره در نوار پایین دیده می‌شود
+4. آیتم‌های مجموعه‌ها (خدمات، پروژه‌ها، مقالات، نظرات، تیم و...) با هاور، دکمه‌های
+   ویرایش / حذف / جابه‌جایی ترتیب نشان می‌دهند؛ دکمه «افزودن» هم انتهای هر لیست هست
+5. تصویرها از همان کشوها به MinIO آپلود می‌شوند
+
+- در حالت ویرایش، لینک‌ها کلیک نمی‌شوند تا ویرایش متن ممکن باشد
+- بازدیدکننده‌های عادی هیچ اثری از این لایه نمی‌بینند (بدون توکن، همه درخواست‌های
+  مدیریتی `401` برمی‌گردند)
+- تمام تغییرها بلافاصله در PostgreSQL ثبت می‌شوند — با Ctrl+F5 هم می‌مانند
+
 ## نکات امنیتی
 
 - فایل `.env` هرگز commit نمی‌شود (در `.gitignore` است)
diff --git a/backend/README.md b/backend/README.md
index 3371252..4431439 100644
--- a/backend/README.md
+++ b/backend/README.md
@@ -119,7 +119,9 @@ Authorization: Bearer <access_token>
 | متد | مسیر | توضیح |
 |---|---|---|
 | GET/POST | `/api/admin/{resource}` | لیست / ساخت |
-| GET/PUT/DELETE | `/api/admin/{resource}/{id}` | دریافت / ویرایش / حذف |
+| GET/PUT/DELETE | `/api/admin/{resource}/{id}` | دریافت / ویرایش کامل / حذف |
+| PATCH | `/api/admin/{resource}/{id}` | **ویرایش جزئی** — فقط فیلدهای ارسال‌شده به‌روزرسانی می‌شوند |
+| POST | `/api/admin/{resource}/reorder` | ذخیره ترتیب: `{"ids": [3, 1, 2, ...]}` |
 | GET | `/api/admin/messages` | پیام‌های تماس (با `?unread_only=true` فقط خوانده‌نشده‌ها) |
 | PATCH | `/api/admin/messages/{id}` | تغییر وضعیت خوانده‌شدن |
 | DELETE | `/api/admin/messages/{id}` | حذف پیام |
@@ -127,6 +129,8 @@ Authorization: Bearer <access_token>
 | DELETE | `/api/admin/subscribers/{id}` | حذف مشترک |
 | POST | `/api/admin/upload` | آپلود تصویر (multipart، حداکثر ۱۰MB — jpg/png/webp/gif/avif) → `{"url": "/media/..."}` |
 
+منابعی که `reorder` دارند (ستون `position`): `services`، `projects`، `articles`، `testimonials`، `faqs`، `team`، `timeline`، `stats`، `why-us`، `investment-models`، `process-steps`، `offices`، `gallery`، `nav`. ستون با مهاجرت سبک idempotent هنگام startup/seed به دیتابیس‌های موجود اضافه می‌شود.
+
 ### تصاویر و MinIO
 
 فایل‌های آپلودشده در باکت `aramesh-media` روی MinIO ذخیره می‌شوند و با مسیر نسبی `/media/<سال>/<ماه>/<فایل>` برگردانده می‌شوند. Traefik مسیر `/media` را به MinIO می‌برد، پس URLها مستقل از بک‌اند ذخیره‌سازی هستند — بعداً برای مهاجرت به R2/S3 فقط تنظیمات را عوض کنید، نه محتوای دیتابیس را.