Merge branch 'bilingual-en'

# Conflicts: # frontend/src/admin/ArticleWritePage.tsx # frontend/src/admin/EntityDrawer.tsx # frontend/src/admin/entities.ts # frontend/src/components/ArticleCard.tsx # frontend/src/index.css # frontend/src/pages/ArticleDetail.tsx
2026-09-13 18:45:06 +03:30
parent 9d55f521a0 4fb57dfd67
commit 53673d0f9b
52 changed files with 2731 additions and 321 deletions
@@ -126,7 +126,7 @@ function ChangePasswordModal({ onClose }: { onClose: () => void }) {

 /** نوار شناور ادمین — فقط برای کاربر واردشده رندر می‌شود */
 export function AdminBar() {
-  const { isEditMode, toggleEditMode, saveStatus, logout } = useAdmin()
+  const { isEditMode, toggleEditMode, saveStatus, logout, editLang, toggleEditLang } = useAdmin()
  const [pwOpen, setPwOpen] = useState(false)

  return (
@@ -161,6 +161,19 @@ export function AdminBar() {
          {isEditMode ? 'حالت ویرایش فعال' : 'حالت ویرایش خاموش'}
        </button>

+        <button
+          type="button"
+          onClick={toggleEditLang}
+          title="تعیین می‌کند ویرایش‌ها روی کدام ستون زبان ذخیره شوند"
+          className={`flex items-center gap-1.5 border px-3 py-1.5 text-xs font-light transition-colors duration-200 ${
+            editLang === 'en'
+              ? 'border-copper bg-copper/10 text-copper'
+              : 'border-ivory/20 text-ivory/70 hover:border-copper hover:text-copper'
+          }`}
+        >
+          زبان ویرایش: {editLang === 'fa' ? 'فارسی' : 'English'}
+        </button>
+
        <span className="flex items-center gap-2 border-r border-ivory/10 pr-5 text-xs font-light text-ivory/60">
          <span className={`h-1.5 w-1.5 rounded-full ${STATUS_COLOR[saveStatus]}`} aria-hidden="true" />
          {STATUS_TEXT[saveStatus]}
@@ -4,8 +4,11 @@ import Swal from 'sweetalert2'
 import type { SiteData } from '../api'
 import { useSiteData } from '../api'
 import { adminApi, getToken, HttpError, setToken } from './adminClient'
+import { ENTITIES, isTranslatable } from './entities'

 export type SaveStatus = 'idle' | 'saving' | 'error'
+/** زبان ویرایش محتوا — رابط مدیریتی فارسی می‌ماند؛ این فقط تعیین می‌کند کدام ستون زبان ذخیره شود */
+export type EditLang = 'fa' | 'en'

 interface AdminContextValue {
  isAuthenticated: boolean
@@ -16,6 +19,9 @@ interface AdminContextValue {
  saveStatus: SaveStatus
  /** اجرای یک عملیات ذخیره — وضعیت نوار ادمین را به‌روز می‌کند و خطاها را با دکمه تلاش دوباره نشان می‌دهد */
  runSave: (action: () => Promise<void>) => Promise<boolean>
+  /** زبان محتوایی که در حالت ویرایش ذخیره می‌شود (فارسی یا انگلیسی) */
+  editLang: EditLang
+  toggleEditLang: () => void
 }

 const AdminContext = createContext<AdminContextValue | null>(null)
@@ -54,6 +60,9 @@ export function AdminProvider({ children }: { children: ReactNode }) {
  const [isEditMode, setIsEditMode] = useState<boolean>(
    () => sessionStorage.getItem('aramesh_edit_mode') === '1',
  )
+  const [editLang, setEditLang] = useState<EditLang>(
+    () => (sessionStorage.getItem('aramesh_edit_lang') === 'en' ? 'en' : 'fa'),
+  )
  const [saveStatus, setSaveStatus] = useState<SaveStatus>('idle')
  const { reload } = useSiteData()

@@ -64,6 +73,14 @@ export function AdminProvider({ children }: { children: ReactNode }) {
    })
  }, [])

+  const toggleEditLang = useCallback(() => {
+    setEditLang((v) => {
+      const next: EditLang = v === 'fa' ? 'en' : 'fa'
+      sessionStorage.setItem('aramesh_edit_lang', next)
+      return next
+    })
+  }, [])
+
  const login = useCallback(async (username: string, password: string) => {
    await adminApi.login(username, password)
    setIsAuthenticated(true)
@@ -131,8 +148,10 @@ export function AdminProvider({ children }: { children: ReactNode }) {
      logout,
      saveStatus,
      runSave,
+      editLang,
+      toggleEditLang,
    }),
-    [isAuthenticated, isEditMode, toggleEditMode, login, logout, saveStatus, runSave],
+    [isAuthenticated, isEditMode, toggleEditMode, login, logout, saveStatus, runSave, editLang, toggleEditLang],
  )

  return <AdminContext.Provider value={value}>{children}</AdminContext.Provider>
@@ -141,9 +160,14 @@ export function AdminProvider({ children }: { children: ReactNode }) {
 /**
 * پرکاربردترین کمک‌ساز ویرایش: یک فیلد واحد را PATCH می‌کند و پس از موفقیت
 * همان تغییر را به‌صورت خوش‌بینانه در درخت داده سایت اعمال می‌کند.
+ *
+ * در حالت ویرایش انگلیسی، کلیدهای قابل ترجمه به پسوند _en نگاشت می‌شوند؛ چون
+ * برخی mutatorهای کامپوننت‌ها نام فیلد را جداگانه می‌نویسند، مقدار قبلی فیلدهای
+ * فارسی اسنپ‌شات می‌شود و پس از اجرای mutator بازگردانده می‌شود تا متن انگلیسی
+ * هرگز جای متن فارسی در درخت خام ننشیند.
 */
 export function useFieldSaver() {
-  const { runSave } = useAdmin()
+  const { runSave, editLang } = useAdmin()
  const { updateSite } = useSiteData()

  return useCallback(
@@ -154,9 +178,50 @@ export function useFieldSaver() {
      apply: (data: SiteData) => void,
    ): Promise<boolean> =>
      runSave(async () => {
+        const originalKeys = Object.keys(changes)
+        if (editLang === 'en') {
+          const mapped: Record<string, unknown> = {}
+          for (const [key, value] of Object.entries(changes)) {
+            mapped[isTranslatable(resource, key) ? `${key}_en` : key] = value
+          }
+          for (const key of Object.keys(changes)) delete changes[key]
+          Object.assign(changes, mapped)
+        }
        await adminApi.patch(resource, id, changes)
-        updateSite(apply)
+        updateSite((d) => {
+          const config = ENTITIES[resource]
+          let node: Record<string, unknown> | undefined
+          if (config) {
+            const target = d[config.dataKey as keyof SiteData] as unknown
+            node =
+              config.kind === 'singleton'
+                ? (target as Record<string, unknown> | undefined)
+                : (target as { id: number }[] | undefined)?.find((x) => x.id === id)
+          }
+          const snapshot =
+            editLang === 'en' && node
+              ? Object.fromEntries(originalKeys.filter((k) => k !== 'id').map((k) => [k, node![k]]))
+              : null
+          apply(d)
+          if (snapshot && node) {
+            Object.assign(node, snapshot)
+            Object.assign(node, changes)
+          }
+        })
      }),
-    [runSave, updateSite],
+    [runSave, updateSite, editLang],
+  )
+}
+
+/**
+ * نام فیلد متناظر با زبان ویرایش جاری — در حالت انگلیسی فیلدهای قابل ترجمه
+ * پسوند _en می‌گیرند. برای جاهایی که نام فیلد جدا از شیء تغییرات ذخیره می‌شود.
+ */
+export function useEditField() {
+  const { editLang } = useAdmin()
+  return useCallback(
+    (resource: string, field: string) =>
+      editLang === 'en' && isTranslatable(resource, field) ? `${field}_en` : field,
+    [editLang],
  )
 }
@@ -15,8 +15,8 @@ import type { Article, ArticleBodyDoc } from '../data/site'

 const EMPTY_DOC = { type: 'doc', content: [{ type: 'paragraph' }] } as unknown as ArticleBodyDoc

-/** پیش‌نویس صفحه نوشتن — همان شکل Article با بدنه ساختاریافته */
-type Draft = Omit<Article, 'body'> & { body: ArticleBodyDoc }
+/** پیش‌نویس صفحه نوشتن — همان شکل Article با بدنه ساختاریافته دو زبانه */
+type Draft = Omit<Article, 'body'> & { body: ArticleBodyDoc; body_en: ArticleBodyDoc }

 /** داده‌های قدیمی ممکن است هشتگ را رشته کاماشده داشته باشند */
 function normalizeTags(value: unknown): string[] {
@@ -36,7 +36,7 @@ const STATUS_TEXT: Record<string, string> = {
 * مسیرها: /admin/write (مقاله جدید) و /admin/write/:id (ویرایش).
 */
 export function ArticleWritePage() {
-  const { isAuthenticated, saveStatus, runSave } = useAdmin()
+  const { isAuthenticated, saveStatus, runSave, editLang, toggleEditLang } = useAdmin()
  const { id } = useParams<{ id: string }>()
  const navigate = useNavigate()
  const { data, updateSite } = useSiteData()
@@ -49,16 +49,22 @@ export function ArticleWritePage() {
    id: 0,
    slug: `article-${Date.now()}`,
    title: '',
+    title_en: '',
    date: new Date().toISOString().split('T')[0],
+    date_en: '',
    category: ARTICLE_CATEGORIES[0],
+    category_en: '',
    tags: [],
    image: '',
    image_alt: '',
    author: '',
    meta_description: '',
    read: '۵ دقیقه',
+    read_en: '',
    excerpt: '',
+    excerpt_en: '',
    body: EMPTY_DOC,
+    body_en: EMPTY_DOC,
    status: 'draft',
    seo_keyphrase: '',
  })
@@ -93,10 +99,15 @@ export function ArticleWritePage() {
  // وقتی مقاله موجود شناخته شد، فرم و شناسه ساخته‌شده یک‌بار مقداردهی می‌شود
  useEffect(() => {
    if (!article || createdRef.current) return
+    const rawEnBody = (article as unknown as { body_en?: unknown }).body_en
    setDraft({
-      ...article,
-      tags: normalizeTags(article.tags),
+      ...(article as unknown as Draft),
+      tags: normalizeTags((article as unknown as { tags?: unknown }).tags),
      body: (Array.isArray(article.body) ? EMPTY_DOC : article.body) as ArticleBodyDoc,
+      body_en:
+        rawEnBody && typeof rawEnBody === 'object' && !Array.isArray(rawEnBody)
+          ? (rawEnBody as ArticleBodyDoc)
+          : EMPTY_DOC,
    })
    setCreatedId(article.id)
    // eslint-disable-next-line react-hooks/exhaustive-deps
@@ -195,6 +206,8 @@ export function ArticleWritePage() {
  })

  const metaLength = (draft.meta_description ?? '').trim().length
+  // در زبان انگلیسی، فیلدهای متنی به ستون‌های _en می‌روند؛ اسلاگ/تصویر/وضعیت مشترک‌اند
+  const suf = <N extends string>(name: N) => `${name}${editLang === 'en' ? '_en' : ''}` as keyof Draft

  return (
    <div dir="rtl" className="min-h-screen bg-ink font-pinar text-ivory">
@@ -211,6 +224,18 @@ export function ArticleWritePage() {
          </Link>

          <div className="flex items-center gap-4">
+            <button
+              type="button"
+              onClick={toggleEditLang}
+              title="تعیین می‌کند متن مقاله روی کدام زبان ذخیره شود"
+              className={`px-4 py-2 text-xs font-bold transition-colors duration-200 ${
+                editLang === 'en'
+                  ? 'bg-copper text-char'
+                  : 'border border-ivory/20 text-ivory/70 hover:border-copper hover:text-copper'
+              }`}
+            >
+              {editLang === 'fa' ? 'ویرایش: فارسی' : 'Edit: English'}
+            </button>
            <span className="flex items-center gap-2 text-xs font-light text-ivory/60">
              {saveStatus === 'idle' && <CheckIcon className="h-3.5 w-3.5 text-emerald-400" />}
              {STATUS_TEXT[saveStatus]}
@@ -245,7 +270,7 @@ export function ArticleWritePage() {
                  {draft.status === 'draft' ? 'انتشار در سایت' : 'تبدیل به پیش‌نویس'}
                </button>
                <Link
-                  to={`/blog/${draft.slug}`}
+                  to={`${editLang === 'en' ? '/en' : ''}/blog/${draft.slug}`}
                  data-admin-link
                  className="flex items-center gap-1.5 border border-ivory/20 px-4 py-2 text-xs font-light text-ivory/70 transition-colors hover:border-copper hover:text-copper"
                >
@@ -276,11 +301,11 @@ export function ArticleWritePage() {
              : 'مقاله منتشرشده — تغییرها همان لحظه در سایت اعمال می‌شود'}
        </p>

-        {/* عنوان */}
+        {/* عنوان — در ویرایش انگلیسی، متن فارسی فعلی جای‌نگهدار می‌ماند */}
        <input
          type="text"
-          {...textField('title')}
-          placeholder="عنوان مقاله…"
+          {...textField(suf('title'))}
+          placeholder={editLang === 'en' ? draft.title || 'English article title…' : 'عنوان مقاله…'}
          aria-label="عنوان مقاله"
          className="mt-4 w-full bg-transparent text-4xl font-bold leading-[1.6] text-ivory placeholder:text-ivory/25 focus:outline-none"
        />
@@ -304,16 +329,21 @@ export function ArticleWritePage() {
          />
        </div>

-        {/* متن */}
+        {/* متن — ویرایشگر روی سند زبان جاری کار می‌کند */}
        <div className="mt-8">
          <ArticleEditor
-            doc={draft.body as unknown as Record<string, unknown>}
+            doc={(editLang === 'en' ? draft.body_en : draft.body) as unknown as Record<string, unknown>}
            onChange={(json) => {
-              // محاسبه خودکار زمان مطالعه بر اساس تعداد کلمات متن
+              // محاسبه خودکار زمان مطالعه بر اساس تعداد کلمات متن — به زبان جاری
              const textContent = JSON.stringify(json)
              const wordCount = textContent.split(/\s+/).length
-              const calculatedReadTime = Math.max(1, Math.ceil(wordCount / 200)) + ' دقیقه'
-              queueSave({ body: json, read: calculatedReadTime })
+              if (editLang === 'en') {
+                const minutes = Math.max(1, Math.ceil(wordCount / 200))
+                queueSave({ [suf('body')]: json, [suf('read')]: `${minutes} min read` })
+              } else {
+                const calculatedReadTime = Math.max(1, Math.ceil(wordCount / 200)) + ' دقیقه'
+                queueSave({ body: json, read: calculatedReadTime })
+              }
            }}
          />
        </div>
@@ -373,8 +403,8 @@ export function ArticleWritePage() {
                <label className="text-xs font-light text-ivory/50">چکیده (روی کارت مقاله نمایش داده می‌شود)</label>
                <textarea
                  rows={2}
-                  {...textField('excerpt')}
-                  placeholder="خلاصه کوتاه مقاله برای کارت‌های وبلاگ…"
+                  {...textField(suf('excerpt'))}
+                  placeholder={editLang === 'en' ? draft.excerpt || 'English excerpt…' : 'خلاصه کوتاه مقاله برای کارت‌های وبلاگ…'}
                  className="mt-2 w-full resize-y border border-ivory/15 bg-char px-3 py-2 text-sm font-light leading-8 text-ivory focus:border-copper focus:outline-none"
                />
              </div>
@@ -428,9 +458,13 @@ export function ArticleWritePage() {
                <label className="text-xs font-light text-ivory/50">زمان مطالعه (محاسبه خودکار)</label>
                <input
                  type="text"
-                  disabled
-                  {...textField('read')}
-                  className="mt-2 w-full cursor-not-allowed border border-ivory/15 bg-char/50 px-3 py-2 text-sm font-light text-ivory/50"
+                  disabled={editLang !== 'en'}
+                  {...(editLang === 'en' ? textField('read_en') : { value: String(draft.read ?? '') })}
+                  className={`mt-2 w-full text-sm font-light ${
+                    editLang === 'en'
+                      ? 'border border-ivory/15 bg-char px-3 py-2 text-ivory focus:border-copper focus:outline-none'
+                      : 'cursor-not-allowed border border-ivory/15 bg-char/50 px-3 py-2 text-ivory/50'
+                  }`}
                />
              </div>
              <div>
@@ -5,6 +5,7 @@ import Swal from 'sweetalert2'
 import { useSiteData } from '../api'
 import { useAdmin, useFieldSaver } from './AdminContext'
 import { adminApi } from './adminClient'
+import { editableFields } from './entities'
 import type { EntityConfig, FieldConfig } from './entities'
 import { ImageField } from '../components/admin/ImageField'
 import { JalaliDatePicker } from '../components/admin/JalaliDatePicker'
@@ -22,11 +23,16 @@ type EntityDrawerProps = {

 export function EntityDrawer({ config, item, onClose, deletable = false }: EntityDrawerProps) {
  const save = useFieldSaver()
-  const { runSave } = useAdmin()
+  const { runSave, editLang } = useAdmin()
  const { reload } = useSiteData()
  const [deleting, setDeleting] = useState(false)
  const flushRef = useRef<() => void>(() => {})

+  // در ویرایش انگلیسی فقط فیلدهای قابل ترجمه با نام انگلیسی رندر می‌شوند؛
+  // متن فارسی همان فیلد به‌عنوان جای‌نگهدار نشان داده می‌شود تا مترجم زمینه را ببیند
+  const fields = editableFields(config, editLang)
+  const faBase = (name: string) => name.replace(/_en$/, '')
+
  const closeWithFlush = () => {
    flushRef.current()
    onClose()
@@ -113,7 +119,7 @@ export function EntityDrawer({ config, item, onClose, deletable = false }: Entit

        <div className="flex-1 overflow-y-auto px-6 py-6">
          <div className="grid gap-6">
-            {config.fields.map((field) => {
+            {fields.map((field) => {
              // فیلد Alt تصویر: برای گالری همان ستون alt و برای بقیه <نام فیلد>_alt
              const altKey =
                field.type === 'image'
@@ -126,6 +132,7 @@ export function EntityDrawer({ config, item, onClose, deletable = false }: Entit
                  key={field.name}
                  field={field}
                  value={item[field.name]}
+                  placeholder={editLang === 'en' ? item[faBase(field.name)] : undefined}
                  altValue={altKey ? String(item[altKey] ?? '') : undefined}
                  altFallback={String(item[config.titleKey] ?? '')}
                  onSave={(value) => saveField(field.name, value)}
@@ -166,6 +173,7 @@ function FieldControl({
  value,
  altValue,
  altFallback,
+  placeholder,
  onSave,
  onSaveAlt,
  registerFlush,
@@ -175,6 +183,8 @@ function FieldControl({
  /** مقدار Alt تصویر — فقط برای فیلدهای image */
  altValue?: string
  altFallback?: string
+  /** مقدار فارسی همان فیلد — فقط در ویرایش انگلیسی به‌عنوان جای‌نگهدار نمایش داده می‌شود */
+  placeholder?: unknown
  onSave: (value: unknown) => Promise<boolean>
  onSaveAlt?: (alt: string) => Promise<boolean>
  registerFlush?: (fn: () => void) => void
@@ -238,14 +248,22 @@ function FieldControl({
  }

  if (field.type === 'wysiwyg') {
-    return <WysiwygField field={field} value={value} onSave={onSave} registerFlush={registerFlush} />
+    return (
+      <WysiwygField
+        field={field}
+        value={value}
+        onSave={onSave}
+        registerFlush={registerFlush}
+        hint={placeholder ? 'خالی = بازدیدکننده متن فارسی را می‌بیند' : undefined}
+      />
+    )
  }

  if (field.type === 'list') {
    return field.ui === 'tags' ? (
      <TagsField field={field} value={value} onSave={onSave} />
    ) : (
-      <ListField field={field} value={value} onSave={onSave} />
+      <ListField field={field} value={value} onSave={onSave} hint={placeholder ? 'خالی = بازدیدکننده فهرست فارسی را می‌بیند' : undefined} />
    )
  }

@@ -256,6 +274,7 @@ function FieldControl({
        <textarea
          dir="auto"
          rows={4}
+          placeholder={placeholder ? String(placeholder) : undefined}
          value={text}
          onChange={(e) => setText(e.target.value)}
          onBlur={commitText}
@@ -272,6 +291,7 @@ function FieldControl({
      <input
        dir={field.type === 'number' ? 'ltr' : 'auto'}
        type={field.type === 'number' ? 'number' : 'text'}
+        placeholder={placeholder ? String(placeholder) : undefined}
        value={text}
        onChange={(e) => setText(e.target.value)}
        onBlur={commitText}
@@ -314,10 +334,12 @@ function ListField({
  field,
  value,
  onSave,
+  hint,
 }: {
  field: FieldConfig
  value: unknown
  onSave: (value: unknown) => Promise<boolean>
+  hint?: string
 }) {
  const [lines, setLines] = useState<string[]>(Array.isArray(value) ? (value as string[]) : [])

@@ -330,6 +352,7 @@ function ListField({
    <div>
      <p className="text-xs font-bold text-ivory/80">{field.label}</p>
      {field.hint && <p className="mt-1 text-[10px] font-light text-ivory/40">{field.hint}</p>}
+      {hint && <p className="mt-1 text-[10px] font-light text-copper/70">{hint}</p>}
      <div className="mt-2 grid gap-2">
        {lines.map((line, i) => (
          <div key={i} className="flex items-start gap-2">
@@ -377,11 +400,13 @@ function WysiwygField({
  value,
  onSave,
  registerFlush,
+  hint,
 }: {
  field: FieldConfig
  value: unknown
  onSave: (value: unknown) => Promise<boolean>
  registerFlush?: (fn: () => void) => void
+  hint?: string
 }) {
  const [doc, setDoc] = useState<Record<string, unknown>>(() =>
    value && typeof value === 'object' && !Array.isArray(value)
@@ -427,6 +452,7 @@ function WysiwygField({
  return (
    <div>
      <p className="text-xs font-bold text-ivory/80">{field.label}</p>
+      {hint && <p className="mt-1 text-[10px] font-light text-copper/70">{hint}</p>}
      <p className="mt-1 text-[10px] font-light text-ivory/40">
        ذخیره خودکار — تصویر را داخل متن بچسبانید یا بکشید
      </p>
@@ -11,6 +11,8 @@ export type FieldConfig = {
  options?: string[]
  /** ویجت سفارشی نوع list — 'tags' یعنی react-select قابل ساخت (Creatable) */
  ui?: 'lines' | 'tags'
+  /** فیلدهای مشترک بین دو زبان (تصویر، لینک، اسلاگ، وضعیت، آیکون، عدد) ترجمه نمی‌شوند */
+  shared?: boolean
 }

 export type EntityConfig = {
@@ -28,13 +30,15 @@ const F = (
  label: string,
  type: FieldType = 'text',
  hint?: string,
-  extra?: Partial<FieldConfig>,
+  sharedOrExtra?: boolean | Partial<FieldConfig>,
 ): FieldConfig => ({
  name,
  label,
  type,
  hint,
-  ...extra,
+  ...(typeof sharedOrExtra === 'object' && sharedOrExtra !== null
+    ? sharedOrExtra
+    : { shared: !!sharedOrExtra }),
 })

 /** دسته‌بندی‌های استاندارد مقاله — با react-select در کشو و صفحه نوشتن نمایش داده می‌شوند */
@@ -50,16 +54,16 @@ export const ENTITIES: Record<string, EntityConfig> = {
  services: {
    resource: 'services', dataKey: 'services', title: 'خدمات', kind: 'collection',
    titleKey: 'title',
-    fields: [F('title', 'عنوان'), F('desc', 'توضیح', 'textarea'), F('icon', 'آیکون', 'text', 'draft / tower / mall / villa / renew / manage / invest / landscape')],
+    fields: [F('title', 'عنوان'), F('desc', 'توضیح', 'textarea'), F('icon', 'آیکون', 'text', 'draft / tower / mall / villa / renew / manage / invest / landscape', true)],
    defaults: { title: 'خدمت جدید', desc: '', icon: 'draft' },
  },
  projects: {
    resource: 'projects', dataKey: 'projects', title: 'پروژه‌ها', kind: 'collection',
    titleKey: 'title',
    fields: [
-      F('title', 'عنوان'), F('slug', 'نشانی (slug)'), F('location', 'موقعیت'),
-      F('year', 'سال'), F('status', 'وضعیت', 'text', 'done یا progress'),
-      F('image', 'تصویر شاخص', 'image'), F('gallery', 'گالری (هر خط یک URL)', 'list'),
+      F('title', 'عنوان'), F('slug', 'نشانی (slug)', 'text', undefined, true), F('location', 'موقعیت'),
+      F('year', 'سال'), F('status', 'وضعیت', 'text', 'done یا progress', true),
+      F('image', 'تصویر شاخص', 'image', undefined, true), F('gallery', 'گالری (هر خط یک URL)', 'list', undefined, true),
      F('area', 'زیربنا'), F('floors', 'طبقات'), F('units', 'واحدها'), F('client', 'کارفرما'),
      F('summary', 'خلاصه', 'textarea'), F('body', 'متن پروژه (هر پاراگراف یک خط)', 'list'),
    ],
@@ -71,30 +75,29 @@ export const ENTITIES: Record<string, EntityConfig> = {
    fields: [
      F('title', 'عنوان'),
      F('body', 'متن مقاله', 'wysiwyg'),
-      F('excerpt', 'چکیده (روی کارت مقاله)'),
-      F('meta_description', 'توضیحات سئو (Meta Description)', 'textarea', '۱۵۰ تا ۱۶۰ کاراکتر — زیر عنوان در نتایج گوگل نمایش داده می‌شود'),
-      F('image', 'تصویر شاخص', 'image'),
-      F('category', 'دسته‌بندی (Category)', 'select', undefined, { options: ARTICLE_CATEGORIES }),
-      F('tags', 'هشتگ‌ها / برچسب‌ها', 'list', 'با Enter هر هشتگ جدید را اضافه کنید', { ui: 'tags' }),
-      F('author', 'نویسنده'),
-      F('date', 'تاریخ انتشار (شمسی)', 'date'),
+      F('excerpt', 'چکیده (روی کارت مقاله)', 'textarea'),
+      F('meta_description', 'توضیحات سئو (Meta Description)', 'textarea', '۱۵۰ تا ۱۶۰ کاراکتر — زیر عنوان در نتایج گوگل نمایش داده می‌شود', true),
+      F('image', 'تصویر شاخص', 'image', undefined, true),
+      F('category', 'دسته‌بندی (Category)', 'select', undefined, { options: ARTICLE_CATEGORIES, shared: true }),
+      F('tags', 'هشتگ‌ها / برچسب‌ها', 'list', 'با Enter هر هشتگ جدید را اضافه کنید', { ui: 'tags', shared: true }),
+      F('author', 'نویسنده', 'text', undefined, true),
+      F('date', 'تاریخ انتشار (شمسی)', 'date', undefined, true),
      F('read', 'زمان مطالعه (دقیقه)'),
-      F('slug', 'نشانی (slug)'),
+      F('slug', 'نشانی (slug)', 'text', undefined, true),
    ],
-    defaults: { 
-      title: 'مقاله جدید', 
-      slug: `article-${Date.now()}`, 
-      date: new Date().toISOString().split('T')[0], 
-      category: ARTICLE_CATEGORIES[0], 
-      tags: ['مدیریت پروژه', 'ساخت‌وساز'], 
-      image: '', 
-      image_alt: '',
+    defaults: {
+      title: 'مقاله جدید',
+      slug: `article-${Date.now()}`,
+      date: new Date().toISOString().split('T')[0],
+      category: ARTICLE_CATEGORIES[0],
+      tags: ['مدیریت پروژه', 'ساخت‌وساز'],
+      image: '',
      author: '',
      meta_description: '',
-      read: '۵ دقیقه', 
-      excerpt: '', 
+      read: '۵ دقیقه',
+      excerpt: '',
      seo_keyphrase: '',
-      body: { type: 'doc', content: [{ type: 'paragraph' }] } 
+      body: { type: 'doc', content: [{ type: 'paragraph' }] }
    },
  },
  testimonials: {
@@ -118,13 +121,13 @@ export const ENTITIES: Record<string, EntityConfig> = {
  timeline: {
    resource: 'timeline', dataKey: 'timeline', title: 'تایم‌لاین', kind: 'collection',
    titleKey: 'title',
-    fields: [F('year', 'سال'), F('title', 'عنوان'), F('desc', 'توضیح', 'textarea'), F('image', 'تصویر', 'image')],
+    fields: [F('year', 'سال'), F('title', 'عنوان'), F('desc', 'توضیح', 'textarea'), F('image', 'تصویر', 'image', undefined, true)],
    defaults: { year: '۱۴۰۰', title: 'رویداد جدید', desc: '', image: '' },
  },
  stats: {
    resource: 'stats', dataKey: 'stats', title: 'آمار', kind: 'collection',
    titleKey: 'label',
-    fields: [F('label', 'برچسب'), F('value', 'عدد', 'number'), F('suffix', 'پسوند (مثل + یا هزار)')],
+    fields: [F('label', 'برچسب'), F('value', 'عدد', 'number', undefined, true), F('suffix', 'پسوند (مثل + یا هزار)')],
    defaults: { label: 'شاخص جدید', value: 0, suffix: '' },
  },
  why_us: {
@@ -154,20 +157,20 @@ export const ENTITIES: Record<string, EntityConfig> = {
  gallery: {
    resource: 'gallery', dataKey: 'gallery', title: 'گالری تصاویر', kind: 'collection',
    titleKey: 'alt',
-    fields: [F('src', 'تصویر', 'image'), F('alt', 'متن جایگزین')],
+    fields: [F('src', 'تصویر', 'image', undefined, true), F('alt', 'متن جایگزین')],
    defaults: { src: '', alt: 'تصویر گالری' },
  },
  nav: {
    resource: 'nav', dataKey: 'nav', title: 'منوی ناوبری', kind: 'collection',
    titleKey: 'label',
-    fields: [F('label', 'عنوان'), F('href', 'مسیر (مثل /about)')],
+    fields: [F('label', 'عنوان'), F('href', 'مسیر (مثل /about)', 'text', undefined, true)],
    defaults: { label: 'آیتم جدید', href: '/' },
  },
  seo_meta: {
    resource: 'seo-meta', dataKey: 'seo_meta', title: 'سئوی صفحه', kind: 'collection',
    titleKey: 'page_key',
    fields: [
-      F('page_key', 'کلید صفحه', 'text', 'home / about / services / projects / investment / blog / faq / contact'),
+      F('page_key', 'کلید صفحه', 'text', 'home / about / services / projects / investment / blog / faq / contact', true),
      F('title', 'عنوان سئو (عنوان تب مرورگر و گوگل)'),
      F('description', 'توضیح سئو (متا دیسکریپشن)', 'textarea'),
    ],
@@ -176,25 +179,25 @@ export const ENTITIES: Record<string, EntityConfig> = {
  brand: {
    resource: 'brand', dataKey: 'brand', title: 'برند و تماس', kind: 'singleton',
    titleKey: 'name',
-    fields: [F('name', 'نام برند'), F('logo', 'لوگو', 'image'), F('hero', 'تصویر هیرو', 'image'), F('contact_bg', 'پس‌زمینه بخش تماس', 'image'), F('phone', 'تلفن نمایشی'), F('phone_href', 'لینک تلفن'), F('email', 'ایمیل'), F('address', 'نشانی', 'textarea')],
+    fields: [F('name', 'نام برند'), F('logo', 'لوگو', 'image', undefined, true), F('hero', 'تصویر هیرو', 'image', undefined, true), F('contact_bg', 'پس‌زمینه بخش تماس', 'image', undefined, true), F('phone', 'تلفن نمایشی', 'text', undefined, true), F('phone_href', 'لینک تلفن', 'text', undefined, true), F('email', 'ایمیل', 'text', undefined, true), F('address', 'نشانی', 'textarea')],
    defaults: {},
  },
  hero: {
    resource: 'hero', dataKey: 'hero', title: 'تنظیمات هیرو', kind: 'singleton',
    titleKey: 'title',
-    fields: [F('title_highlight', 'واژه مسیِ تیتر'), F('badge_value', 'عدد کارت کنار'), F('badge_label', 'متن کارت کنار', 'textarea'), F('cta_primary_label', 'متن دکمه اصلی'), F('cta_primary_href', 'لینک دکمه اصلی'), F('cta_secondary_label', 'متن دکمه دوم'), F('cta_secondary_href', 'لینک دکمه دوم'), F('scroll_label', 'متن اسکرول'), F('kicker', 'متن بالای تیتر', 'textarea')],
+    fields: [F('title_highlight', 'واژه مسیِ تیتر'), F('badge_value', 'عدد کارت کنار'), F('badge_label', 'متن کارت کنار', 'textarea'), F('cta_primary_label', 'متن دکمه اصلی'), F('cta_primary_href', 'لینک دکمه اصلی', 'text', undefined, true), F('cta_secondary_label', 'متن دکمه دوم'), F('cta_secondary_href', 'لینک دکمه دوم', 'text', undefined, true), F('scroll_label', 'متن اسکرول'), F('kicker', 'متن بالای تیتر', 'textarea')],
    defaults: {},
  },
  story: {
    resource: 'story', dataKey: 'story', title: 'تصاویر بخش درباره ما', kind: 'singleton',
    titleKey: 'title',
-    fields: [F('quote', 'نقل‌قول مدیرعامل', 'textarea'), F('quote_author', 'استناد نقل‌قول'), F('stat1_value', 'آمار ۱ — عدد'), F('stat1_label', 'آمار ۱ — برچسب'), F('stat2_value', 'آمار ۲ — عدد'), F('stat2_label', 'آمار ۲ — برچسب'), F('link_label', 'متن دکمه'), F('link_href', 'لینک دکمه')],
+    fields: [F('title', 'عنوان بخش'), F('paragraphs', 'پاراگراف‌های معرفی', 'list'), F('quote', 'نقل‌قول مدیرعامل', 'textarea'), F('quote_author', 'استناد نقل‌قول'), F('stat1_value', 'آمار ۱ — عدد'), F('stat1_label', 'آمار ۱ — برچسب'), F('stat2_value', 'آمار ۲ — عدد'), F('stat2_label', 'آمار ۲ — برچسب'), F('link_label', 'متن دکمه'), F('link_href', 'لینک دکمه', 'text', undefined, true)],
    defaults: {},
  },
  before_after: {
    resource: 'before-after', dataKey: 'before_after', title: 'بخش قبل/بعد', kind: 'singleton',
    titleKey: 'title',
-    fields: [F('title', 'عنوان'), F('lead', 'توضیح', 'textarea'), F('before', 'تصویر قبل', 'image'), F('after', 'تصویر بعد', 'image'), F('before_label', 'برچسب قبل'), F('after_label', 'برچسب بعد')],
+    fields: [F('title', 'عنوان'), F('lead', 'توضیح', 'textarea'), F('before', 'تصویر قبل', 'image', undefined, true), F('after', 'تصویر بعد', 'image', undefined, true), F('before_label', 'برچسب قبل'), F('after_label', 'برچسب بعد')],
    defaults: {},
  },
  contact_section: {
@@ -225,6 +228,22 @@ export const ENTITIES: Record<string, EntityConfig> = {
  },
 }

+/** آیا فیلد در منبع داده قابل ترجمه است؟ (فیلدهای مشترک و پسوندهای انگلیسی قبلی خیر) */
+export function isTranslatable(resource: string, name: string): boolean {
+  if (name.endsWith('_en')) return false
+  const config = ENTITIES[resource]
+  return !!config?.fields.some((f) => f.name === name && !f.shared)
+}
+
+/** فیلدهای قابل ویرایش یک منبع در زبان داده‌شده — انگلیسی: بدون فیلدهای مشترک و با پسوند _en */
+export function editableFields(config: EntityConfig, lang: 'fa' | 'en'): FieldConfig[] {
+  if (lang === 'fa') return config.fields
+  return config.fields
+    .filter((f) => !f.shared)
+    .map((f) => ({ ...f, name: `${f.name}_en` }))
+}
+
+/** دسترسی به آرایه/شیء منبع از درخت داده سایت */
 export function getEntityData(data: SiteData, config: EntityConfig): Record<string, unknown> & { id: number }[] | (Record<string, unknown> & { id: number }) {
  return data[config.dataKey as keyof SiteData] as never
-}
+}