diff --git a/backend/app/seo_pages.py b/backend/app/seo_pages.py
index 463c9e9..995751e 100644
--- a/backend/app/seo_pages.py
+++ b/backend/app/seo_pages.py
@@ -32,7 +32,7 @@ from urllib.parse import quote
from fastapi import APIRouter, Depends, Response
from fastapi.encoders import jsonable_encoder
-from fastapi.responses import HTMLResponse
+from fastapi.responses import HTMLResponse, RedirectResponse
from sqlalchemy.orm import Session
from . import models
@@ -50,6 +50,11 @@ FALLBACK_EN_BRAND = "Aramesh Construction Group"
# تصویر پیشفرض شبکههای اجتماعی — در frontend/public بیلد میشود
DEFAULT_OG_IMAGE = "/og-default.jpg"
DEFAULT_OG_SIZE = (1200, 630)
+# مختصات دفتر مرکزی (اصفهان، ملاصدرا شمالی) — همان مقدار فرانتاند
+# (frontend/src/data/mapProjects.ts: OFFICE_LOCATION)؛ در اسکیمای LocalBusiness
+# به geo و hasMap تبدیل میشود. دو مقدار باید همیشه یکی بمانند.
+OFFICE_GEO = (32.61764688216492, 51.666306342927214)
+OFFICE_MAPS_URL = f"https://www.google.com/maps/search/?api=1&query={OFFICE_GEO[0]},{OFFICE_GEO[1]}"
# کلید IndexNow — اثبات مالکیت برای اعلام فوری نشانیهای سایت به Bing/Copilot و
# موتورهای مشارکتکننده در پروتکل (فایل در /.well-known/indexnow-key.txt سرو میشود)
INDEXNOW_KEY = "daa4488a8e2905312b5efd02ad5fc614"
@@ -90,8 +95,10 @@ def _fa_path(path: str) -> str:
def _url_escape(url: str) -> str:
- """درصدگذاری نویسههای غیر-ASCII (اسلاگهای فارسی) — استاندارد sitemap و IndexNow."""
- return quote(url, safe=":/?#[]@!$&'()*+,;=")
+ """درصدگذاری نویسههای غیر-ASCII و ناامن (اسلاگهای فارسی، فاصله و «?» در
+ اسلاگ انگلیسی) — استاندارد sitemap و IndexNow. ? و # عمداً «امن» نیستند:
+ در اسلاگِ خام، شروع query/fragment میشوند و URL را میشکنند."""
+ return quote(url, safe=":/[]@!$&'()*+,;=")
def _clip(text: str, limit: int) -> str:
@@ -164,24 +171,33 @@ def _iso_stamp(value: datetime | None) -> str | None:
# ---------- alternates — فقط وقتی ترجمهٔ انگلیسی واقعاً وجود دارد ----------
-def _alternate_pairs(path: str, lang: str, has_en: bool) -> list[tuple[str, str]]:
+def _alternate_pairs(
+ path: str,
+ lang: str,
+ has_en: bool,
+ fa_override: str = "",
+ en_override: str = "",
+) -> list[tuple[str, str]]:
"""جفتهای (hreflang، href) یک صفحه — مبنای مشترک head و sitemap.
- صفحهٔ انگلیسیِ ترجمهنشده هیچ ادعایی ندارد (لیست خالی)."""
- fa = path if lang == "fa" else _fa_path(path)
+ صفحهٔ انگلیسیِ ترجمهنشده هیچ ادعایی ندارد (لیست خالی). مقالهها میتوانند
+ در دو زبان اسلاگ متفاوت داشته باشند؛ overrideها همان نشانی واقعیاند."""
+ fa = fa_override or (path if lang == "fa" else _fa_path(path))
if lang == "en" and not has_en:
return []
+ # نشانیها خام برمیگردند — درصدگذاری URL با مصرفکننده است
+ # (_alternates برای head و url_entry برای sitemap)
pairs = [("fa", _absolute(fa)), ("x-default", _absolute(fa))]
if has_en:
- en = _en_path(path) if lang == "fa" else path
+ en = en_override or (_en_path(path) if lang == "fa" else path)
pairs.insert(1, ("en", _absolute(en)))
return pairs
-def _alternates(path: str, lang: str, has_en: bool = True) -> str:
- """تگهای link alternate برای head — از همان جفتهای sitemap."""
- pairs = _alternate_pairs(path, lang, has_en)
+def _alternates(path: str, lang: str, has_en: bool = True, fa_override: str = "", en_override: str = "") -> str:
+ """تگهای link alternate برای head — از همان جفتهای sitemap (درصدگذاری اینجا)."""
+ pairs = _alternate_pairs(path, lang, has_en, fa_override, en_override)
return "\n ".join(
- f''
+ f''
for lang_code, href_ in pairs
)
@@ -251,6 +267,10 @@ def _shell(
path: str,
lang: str = "fa",
has_en: bool = True,
+ # نشانیهای override برای مقالههایی که دو زبان اسلاگ متفاوت دارند —
+ # پیشفرض همان مسیر با پیشوند /en است (اسلاگ مشترک)
+ alt_fa: str = "",
+ alt_en: str = "",
og_image: str = "",
og_image_alt: str = "",
og_type: str = "website",
@@ -264,9 +284,9 @@ def _shell(
"""index.html فرانتاند با متای تزریقی؛ اگر بیلد در دسترس نبود، صفحه حداقلی."""
title = title.strip() or (FALLBACK_EN_BRAND if lang == "en" else FALLBACK_FA_BRAND)
description = description.strip()
- canonical = _absolute(path)
+ canonical = _url_escape(_absolute(path))
esc = html.escape
- alternates = _alternates(path, lang, has_en)
+ alternates = _alternates(path, lang, has_en, alt_fa, alt_en)
# تصویر OG — تصویر اختصاصی صفحه یا تصویر پیشفرض برند
custom_image = (og_image or "").strip()
@@ -476,6 +496,14 @@ def _localbusiness_jsonld(db: Session, lang: str, path: str) -> dict | None:
business["address"] = addresses[0] if len(addresses) == 1 else addresses
if areas:
business["areaServed"] = sorted(set(areas))
+ # دادهٔ مکانی دقیق دفتر — سیگنال مستقیم برای گوگل و دستیارهای AI؛
+ # hasMap همان قالب رسمی Maps URLs بدون کلید API است که فرانتاند هم میسازد
+ business["geo"] = {
+ "@type": "GeoCoordinates",
+ "latitude": OFFICE_GEO[0],
+ "longitude": OFFICE_GEO[1],
+ }
+ business["hasMap"] = OFFICE_MAPS_URL
return business
@@ -485,7 +513,7 @@ def _breadcrumb_jsonld(items: list[tuple[str, str]]) -> dict:
"@context": "https://schema.org",
"@type": "BreadcrumbList",
"itemListElement": [
- {"@type": "ListItem", "position": i + 1, "name": name, "item": _absolute(url)}
+ {"@type": "ListItem", "position": i + 1, "name": name, "item": _url_escape(_absolute(url))}
for i, (name, url) in enumerate(items)
],
}
@@ -633,7 +661,12 @@ def sitemap(db: Session = Depends(get_db)):
}
def entry(loc: str, lang: str, has_en: bool, lastmod: str | None = None) -> str:
- pairs = _alternate_pairs(loc, lang, has_en)
+ """ورودی sitemap با جفتهای alternateِ هماسلاگ (صفحات استاتیک/پروژهها)."""
+ return url_entry(loc, _alternate_pairs(loc, lang, has_en), lastmod)
+
+ def url_entry(loc: str, pairs: list[tuple[str, str]], lastmod: str | None = None) -> str:
+ """ورودی sitemap با جفتهای alternate صریح — برای مقالههایی که دو زبان
+ اسلاگ جدا دارند."""
links = "\n".join(
f' '
for code, href_ in pairs
@@ -650,14 +683,22 @@ def sitemap(db: Session = Depends(get_db)):
urls.append(entry(path, "fa", has_en))
if has_en:
urls.append(entry(_en_path(path), "en", True))
- # مقالهها و پروژهها — alternate انگلیسی فقط با وجود ترجمهٔ واقعی
+ # مقالهها — نشانی انگلیسی، اسلاگ انگلیسیِ خودش را دارد (اگر ثبت شده)؛
+ # جفتهای alternate صریحاند چون دو زبان میتوانند اسلاگ متفاوت داشته باشند
for slug, article in articles.items():
fa_path = f"/blog/{slug}"
has_en = _article_has_en(article)
stamp = _iso_stamp(article.updated_at)
- urls.append(entry(fa_path, "fa", has_en, stamp))
if has_en:
- urls.append(entry(_en_path(fa_path), "en", True, stamp))
+ en_slug = (article.slug_en or "").strip() or slug
+ en_path = f"/en/blog/{en_slug}"
+ # مسیرهای خام — url_entry خودش درصدگذاری میکند (یکبار، نه دوبار)
+ pairs = [("fa", fa_path), ("en", en_path), ("x-default", fa_path)]
+ urls.append(url_entry(fa_path, pairs, stamp))
+ urls.append(url_entry(en_path, pairs, stamp))
+ else:
+ urls.append(entry(fa_path, "fa", False, stamp))
+ # پروژهها — اسلاگ مشترک دو زبان است
for slug, project in projects.items():
fa_path = f"/projects/{slug}"
has_en = _project_has_en(project)
@@ -746,7 +787,7 @@ def llms_txt(db: Session = Depends(get_db)):
summary = _clip(summary, 140)
# بدون ترجمهٔ انگلیسی، همان نشانی فارسی اعلام میشود؛ توضیح خالی هم حذف میشود
path = f"/en/projects/{p.slug}" if _project_has_en(p) else f"/projects/{p.slug}"
- lines.append(f"- [{title}]({_absolute(path)})" + (f": {summary}" if summary else ""))
+ lines.append(f"- [{title}]({_url_escape(_absolute(path))})" + (f": {summary}" if summary else ""))
latest = (
db.query(models.Article)
.filter(models.Article.status == "published")
@@ -761,8 +802,12 @@ def llms_txt(db: Session = Depends(get_db)):
title = (title_en or a.title.strip()) + ("" if title_en else " (Persian)")
summary = ((a.excerpt_en or "").strip() if title_en else "") or (a.excerpt or "").strip()
summary = _clip(summary, 140)
- path = f"/en/blog/{a.slug}" if _article_has_en(a) else f"/blog/{a.slug}"
- lines.append(f"- [{title}]({_absolute(path)})" + (f": {summary}" if summary else ""))
+ # نشانی انگلیسی اسلاگ انگلیسی خودش را دارد (اگر ثبت شده باشد)
+ if _article_has_en(a):
+ path = f"/en/blog/{(a.slug_en or '').strip() or a.slug}"
+ else:
+ path = f"/blog/{a.slug}"
+ lines.append(f"- [{title}]({_url_escape(_absolute(path))})" + (f": {summary}" if summary else ""))
brand_row = _brand_row(db)
contact_lines = []
if brand_row and (brand_row.phone or "").strip():
@@ -776,6 +821,8 @@ def llms_txt(db: Session = Depends(get_db)):
detail = street if (city and city in street) else (street + ("، " + city if city and street else city))
if detail:
contact_lines.append(f"- Office: {_clip(detail, 120)}")
+ # مختصات و پیوند نقشهٔ دفتر مرکزی — دادهٔ مکانی مستقیم برای دستیارهای AI
+ contact_lines.append(f"- Head office on map: {OFFICE_MAPS_URL}")
if contact_lines:
lines += ["", "## Contact", *contact_lines]
# راهنمای دستیارهای AI: تصاویر هر پروژه بهصورت آرشیو ZIP با manifest قابل دریافت است
@@ -894,6 +941,31 @@ def _site_content_html(db: Session, page_key: str, lang: str) -> str:
items += f"
{line}
"
parts.append(f"
{'Our Projects' if lang == 'en' else 'پروژههای ما'}
{items}
")
+ # مقالههای منتشرشده — فهرست وبلاگ برای خزندههای بدون جاوااسکریپت (رباتهای AI)؛
+ # نشانی انگلیسی همان اسلاگ انگلیسی مقاله است (اگر ثبت شده باشد)
+ if page_key in ("home", "blog"):
+ blog_items = (
+ db.query(models.Article)
+ .filter(models.Article.status == "published")
+ .order_by(models.Article.position, models.Article.id)
+ .limit(6)
+ .all()
+ )
+ if blog_items:
+ items = ""
+ for a in blog_items:
+ title = en(a.title, a.title_en)
+ if lang == "en" and _article_has_en(a):
+ href = f"/en/blog/{quote((a.slug_en or '').strip() or a.slug, safe='')}"
+ else:
+ href = f"/blog/{quote(a.slug, safe='')}"
+ items += f'
")
+ # بخش «تیم ما» موقتاً از خروجی حذف شده — همراه صفحهٔ درباره در فرانتاند غیرفعال شد
+ # تا خزندهها و دستیارهای AI هم چیزی از آن نبینند؛ برای بازگردانی این بلوک را دوباره فعال کنید
+ # if page_key == "about":
+ # team = db.query(models.TeamMember).order_by(models.TeamMember.position).all()
+ # if team:
+ # items = "".join(
+ # f"
")
if page_key in ("home", "contact"):
offices = db.query(models.Office).order_by(models.Office.position, models.Office.id).all()
@@ -945,6 +1019,11 @@ def _site_content_html(db: Session, page_key: str, lang: str) -> str:
hours = en(o.hours, o.hours_en)
detail = addr if (city and city in addr) else f"{addr}، {city}" if addr and city else (addr or city)
contact_bits.append(f"
")
+ # موقعیت روی نقشه — خزندههای بدون جاوااسکریپت (رباتهای AI) هم مختصات و پیوند را میبینند
+ map_label = "Location on map" if lang == "en" else "موقعیت روی نقشه"
+ contact_bits.append(
+ f'