diff --git a/frontend/admin-panel/SEO_TRACKING_VERIFICATION.md b/frontend/admin-panel/SEO_TRACKING_VERIFICATION.md new file mode 100644 index 00000000..2ed4d01b --- /dev/null +++ b/frontend/admin-panel/SEO_TRACKING_VERIFICATION.md @@ -0,0 +1,20 @@ +# SEO tracking UI local verification + +Scope: admin-panel only; no push, deployment, migration, scheduling or production writes. Reviewed specification/plan/tasks: `/opt/data/engineering/canina-spec-baseline/specs/002-seo-performance-tracking/`; contract: `/opt/data/analytics-engine/contract.md` v2. Source at start: develop `13f4fdc58dff96f192c612a8d38f33d314f70fad`; unrelated .specify/evidence existed. Shared worktree backend agent changes excluded from frontend commit. + +Graphify navigation query: `SeoTrackingPage seoTrackingApi adminRoutes Sidebar`, graph hash `6a73473cee9e207543fdeeb668bea544f766200a1b16b8a3a9ce18d4e42e51af` (4304 nodes, 287 matches; truncated query). Graph SHA binding not established, therefore navigation only; direct source verified route/sidebar, API interceptor, backend global DecimalInterceptor, controller, DTO and service. Axios preserves response, server returns raw bodies, not a success/data wrapper. + +Acceptance/implementation: server-driven page/search/status/sort with page reset; distinct loading/empty/error and retained stale rows after failed refetch; read cancellation and late-response guards; portal modal with labels, initial focus, inert page content, Tab wrap, Escape and focus restoration. Detail shows latest 30 stored snapshots, newest first, Tehran dates, source status/fetchedAt/period metadata. Null, unavailable and provenance-free legacy metrics never become measured zeros. Feedback is optional, requires expectedVersion, preserves snapshots and drafts after failure, rejects stale 409 save until explicit reload. Text does not claim downstream directive enforcement or live source queries. + +RED: 7 UI tests failed with missing labels/sort/dialog/error handling and null metric crash (3 unhandled errors); `/opt/data/cache/scratch/seo-ui-red.log`. Service RED: 12 failed / 6 passed before implementation, exercised missing cancellation/version/response validation. + +Final commands, all exit 0 (2026-10-28 UTC): +- `npm test -- --maxWorkers=2`: 53 files, 341 tests passed, 149.46s. Includes 10 SEO interaction tests plus 21 real Axios adapter/interceptor contract tests. +- `npx tsc -p tsconfig.app.json --noEmit`: passes actual application project. Root npm typecheck alone uses references and is not sufficient. +- `npm run lint`: 0 errors, 147 repository warnings; no lint errors introduced. +- `npm run build`: successful Vite production build. +- `git diff --check`: passes before commit. + +Command logs: `/opt/data/cache/scratch/seo-admin-{full-tests,typecheck,lint,build}.log`. + +Removed three unused Sidebar icon imports that prevented application typecheck. Route/sidebar SEO entry already existed and is unchanged. Verification uses mocked network fixtures, not live API/Google data; no browser/end-to-end or deployed acceptance is asserted. Backend version/schema rollout and legacy backfill remain backend/release responsibilities. diff --git a/frontend/admin-panel/src/components/Sidebar.tsx b/frontend/admin-panel/src/components/Sidebar.tsx index dc8dcab3..05961fe4 100644 --- a/frontend/admin-panel/src/components/Sidebar.tsx +++ b/frontend/admin-panel/src/components/Sidebar.tsx @@ -1,6 +1,5 @@ import { Activity, - CheckSquare, BookOpen, Building2, ChevronDown, @@ -36,8 +35,6 @@ import { UserCheck, Users, Video, - History, - Briefcase } from 'lucide-react'; import { useEffect, useRef, useState } from 'react'; import { Link, useLocation } from 'react-router-dom'; diff --git a/frontend/admin-panel/src/pages/SeoTrackingPage.test.tsx b/frontend/admin-panel/src/pages/SeoTrackingPage.test.tsx index 66d10fcf..54b4a120 100644 --- a/frontend/admin-panel/src/pages/SeoTrackingPage.test.tsx +++ b/frontend/admin-panel/src/pages/SeoTrackingPage.test.tsx @@ -1,64 +1,86 @@ -import { render, screen, waitFor } from '@testing-library/react'; -import { BrowserRouter } from 'react-router-dom'; +import { cleanup, fireEvent, render, screen, waitFor, within } from '@testing-library/react'; +import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest'; import SeoTrackingPage from './SeoTrackingPage'; -import { seoTrackingApi } from '../services/seoTrackingApi'; -import { vi, describe, it, expect, beforeEach } from 'vitest'; - -vi.mock('../services/seoTrackingApi', () => ({ - seoTrackingApi: { - getFindings: vi.fn(), - getFindingById: vi.fn(), - updateCeoFeedback: vi.fn(), - }, -})); - -describe('SeoTrackingPage Admin UI', () => { - beforeEach(() => { - vi.clearAllMocks(); - }); - - it('renders table headers and findings correctly', async () => { - (seoTrackingApi.getFindings as any).mockResolvedValueOnce({ - data: [ - { - id: 'test-finding-1', - title: 'بررسی پوکی استخوان در سگ‌های مسن', - hypothesis: 'کمبود گلوکزآمین در جیره غذایی', - primaryKeyword: 'گلوکزآمین سگ', - targetKeywords: ['گلوکزآمین سگ'], - expectedOutcome: 'افزایش فروش مکمل مفاصل', - status: 'ACTIONED', - blog: { - id: 'b1', - title: 'مقاله سلامت مفاصل', - slug: 'dog-joint-health', - }, - ceoFeedback: 'روی نژاد ژرمن شپرد تمرکز شود', - }, - ], - meta: { - total: 1, - page: 1, - limit: 10, - totalPages: 1, - lastPage: 1, - hasNextPage: false, - hasPrevPage: false, - }, - }); - - render( - - - - ); - - expect(screen.getByText('پایش عملکرد سئو و بازخورد مدیرعامل')).toBeDefined(); - - await waitFor(() => { - expect(screen.getByText('بررسی پوکی استخوان در سگ‌های مسن')).toBeDefined(); - expect(screen.getByText('گلوکزآمین سگ')).toBeDefined(); - expect(screen.getByText('دستور ثبت‌شده')).toBeDefined(); - }); - }); +import { seoTrackingApi, type ResearchFinding } from '../services/seoTrackingApi'; +vi.mock('../services/seoTrackingApi', () => ({ seoTrackingApi: { getFindings: vi.fn(), getFindingById: vi.fn(), updateCeoFeedback: vi.fn() } })); +const finding = { id: 'f1', title: 'موضوع آزمایشی', hypothesis: 'فرضیه', primaryKeyword: 'کلید', targetKeywords: ['کلید', 'دوم'], expectedOutcome: 'هدف', status: 'ACTIONED', version: 0, createdAt: '2026-10-01T00:00:00Z', updatedAt: '2026-10-02T00:00:00Z', snapshots: [{ id: 's1', snapshotDate: '2026-10-03T00:00:00Z', sourceMetadata: { gsc: { status: 'available', source: 'Search Console', fetchedAt: '2026-10-03T00:00:00Z' }, ga4: { status: 'unavailable', source: 'GA4', fetchedAt: '2026-10-03T00:00:00Z' }, commerce: { status: 'unavailable', source: 'Orders', fetchedAt: '2026-10-03T00:00:00Z' } }, gscImpressions: 0, gscClicks: null, ga4ActiveUsers: null, attributedOrdersCount: null, attributedSalesValue: null }] } as ResearchFinding; +const response = (data = [finding], page = 1, totalPages = 2) => ({ data, meta: { total: 11, page, limit: 10, totalPages, lastPage: totalPages, hasNextPage: page < totalPages, hasPrevPage: page > 1 } }); +const list = vi.mocked(seoTrackingApi.getFindings); +const detail = vi.mocked(seoTrackingApi.getFindingById); +const save = vi.mocked(seoTrackingApi.updateCeoFeedback); +async function open() { render(); const trigger = await screen.findByRole('button', { name: /مشاهده و پایش/ }); fireEvent.click(trigger); await screen.findByRole('textbox', { name: 'بازخورد مدیرعامل' }); return trigger; } +beforeEach(() => { vi.resetAllMocks(); list.mockResolvedValue(response()); detail.mockResolvedValue(finding); save.mockResolvedValue({ ...finding, ceoFeedback: 'دستور', updatedAt: '2026-10-04T00:00:00Z', snapshots: undefined }); }); +afterEach(cleanup); +describe('SEO tracking interactions', () => { + it('renders all history newest first, source periods and legacy provenance without claiming measured zeros', async () => { + detail.mockResolvedValue({ ...finding, snapshots: [ + { ...finding.snapshots![0], id: 'old', snapshotDate: '2026-01-01T00:00:00Z', sourceMetadata: null, actionRecommendation: 'OLD' }, + { ...finding.snapshots![0], id: 'new', snapshotDate: '2026-10-03T00:00:00Z', periodStart: '2026-10-01T00:00:00Z', periodEnd: '2026-10-02T00:00:00Z', actionRecommendation: 'NEW' }, + ] }); + await open(); const articles = within(screen.getByRole('dialog')).getAllByRole('article'); + expect(articles).toHaveLength(2); expect(articles[0].textContent).toContain('NEW'); expect(articles[1].textContent).toContain('OLD'); + expect(articles[0].textContent).toContain('Search Console'); expect(articles[0].textContent).toContain('available'); expect(articles[0].textContent).toContain('۱۴۰۵/۷/۹'); + expect(articles[1].textContent).toContain('منبع تأییدنشده (تاریخی)'); expect(within(articles[1]).queryByText('۰')).toBeNull(); + }); + it('preserves draft on save failure and sends the new version on subsequent saves, including clear', async () => { + await open(); save.mockRejectedValueOnce(new Error('offline')); + const field = screen.getByLabelText('بازخورد مدیرعامل'); fireEvent.change(field, { target: { value: 'draft' } }); fireEvent.click(screen.getByRole('button', { name: 'ثبت بازخورد' })); + await screen.findByText(/خطا در ثبت بازخورد/); expect((field as HTMLTextAreaElement).value).toBe('draft'); + save.mockResolvedValueOnce({ ...finding, ceoFeedback: 'draft', version: 1, snapshots: undefined }); fireEvent.click(screen.getByRole('button', { name: 'ثبت بازخورد' })); await screen.findByText('بازخورد ثبت شد.'); + fireEvent.change(field, { target: { value: ' ' } }); fireEvent.click(screen.getByRole('button', { name: 'ثبت بازخورد' })); + await waitFor(() => expect(save).toHaveBeenLastCalledWith('f1', '', 1)); + }); + it('shows no-snapshot state and initial upstream/access errors distinctly from empty data', async () => { + list.mockRejectedValueOnce({ response: { status: 403 } }); render(); await screen.findByText('دسترسی به این بخش مجاز نیست.'); expect(screen.queryByText('موردی یافت نشد.')).toBeNull(); + fireEvent.click(screen.getByRole('button', { name: 'تلاش مجدد' })); detail.mockResolvedValue({ ...finding, snapshots: [] }); fireEvent.click(await screen.findByRole('button', { name: /مشاهده و پایش/ })); await screen.findByText('هنوز اولین پایش سنجه‌ها برای این موضوع ثبت نشده است.'); + }); + it('sends server paging, search, filters and sort and resets page', async () => { + render(); await screen.findByText(finding.title); + fireEvent.click(screen.getByRole('button', { name: 'صفحه بعد' })); + await waitFor(() => expect(list).toHaveBeenLastCalledWith(expect.objectContaining({ page: 2 }), expect.any(AbortSignal))); + fireEvent.change(screen.getByLabelText('جستجو'), { target: { value: 'سگ' } }); + fireEvent.change(screen.getByLabelText('وضعیت'), { target: { value: 'ACTIONED' } }); + fireEvent.change(screen.getByLabelText('مرتب‌سازی'), { target: { value: 'title' } }); + fireEvent.change(screen.getByLabelText('جهت مرتب‌سازی'), { target: { value: 'asc' } }); + await waitFor(() => expect(list).toHaveBeenLastCalledWith(expect.objectContaining({ page: 1, search: 'سگ', status: 'ACTIONED', sortBy: 'title', sortOrder: 'asc' }), expect.any(AbortSignal))); + }); + it('distinguishes empty from errors, retaining old rows on failed refresh', async () => { + render(); await screen.findByText(finding.title); list.mockRejectedValueOnce(new Error('offline')); + fireEvent.click(screen.getByRole('button', { name: 'به‌روزرسانی' })); + await screen.findByRole('alert'); expect(screen.getByText(finding.title)).toBeDefined(); expect(screen.queryByText('موردی یافت نشد.')).toBeNull(); + list.mockResolvedValueOnce(response([], 1, 0)); fireEvent.click(screen.getByRole('button', { name: 'تلاش مجدد' })); await screen.findByText('موردی یافت نشد.'); + }); + it('renders snapshot history, real zero vs unavailable, saves version and retains history', async () => { + await open(); const dialog = screen.getByRole('dialog'); + expect(within(dialog).getByText('تاریخچه سنجه‌های ثبت‌شده')).toBeDefined(); expect(within(dialog).getAllByText('ناموجود').length).toBeGreaterThan(0); expect(within(dialog).getByText('۰')).toBeDefined(); + expect(within(dialog).queryByText(/پایش زنده/)).toBeNull(); + fireEvent.change(screen.getByLabelText('بازخورد مدیرعامل'), { target: { value: 'دستور' } }); fireEvent.click(screen.getByRole('button', { name: 'ثبت بازخورد' })); + await waitFor(() => expect(save).toHaveBeenCalledWith('f1', 'دستور', finding.version)); await screen.findByText('بازخورد ثبت شد.'); expect(screen.getByText('۰')).toBeDefined(); + }); + it('handles conflict without discarding draft, and explicitly reloads latest', async () => { + save.mockRejectedValue({ response: { status: 409 } }); await open(); + fireEvent.change(screen.getByLabelText('بازخورد مدیرعامل'), { target: { value: 'پیش‌نویس' } }); fireEvent.click(screen.getByRole('button', { name: 'ثبت بازخورد' })); + await screen.findByText(/رکورد تغییر کرده/); expect((screen.getByLabelText('بازخورد مدیرعامل') as HTMLTextAreaElement).value).toBe('پیش‌نویس'); + expect(screen.getByRole('button', { name: 'ثبت بازخورد' }).hasAttribute('disabled')).toBe(true); + detail.mockResolvedValue({ ...finding, ceoFeedback: 'جدید' }); fireEvent.click(screen.getByRole('button', { name: 'دریافت نسخه جدید' })); await waitFor(() => expect((screen.getByLabelText('بازخورد مدیرعامل') as HTMLTextAreaElement).value).toBe('جدید')); + }); + it('focuses modal, traps tabs, Escape closes and restores trigger focus', async () => { + const trigger = await open(); const dialog = screen.getByRole('dialog'); const close = within(dialog).getByRole('button', { name: 'بستن' }); + expect(dialog.getAttribute('aria-modal')).toBe('true'); expect(document.activeElement).toBe(close); + close.focus(); fireEvent.keyDown(dialog, { key: 'Tab', shiftKey: true }); expect(document.activeElement).toBe(screen.getByRole('button', { name: 'ثبت بازخورد' })); + fireEvent.keyDown(dialog, { key: 'Escape' }); expect(screen.queryByRole('dialog')).toBeNull(); expect(document.activeElement).toBe(trigger); + }); + it('shows loading detail immediately and distinct not-found/access errors with retry', async () => { + detail.mockRejectedValueOnce({ response: { status: 404 } }); render(); fireEvent.click(await screen.findByRole('button', { name: /مشاهده و پایش/ })); await screen.findByText('یافته پیدا نشد.'); + fireEvent.click(screen.getByRole('button', { name: 'تلاش مجدد جزئیات' })); await screen.findByLabelText('بازخورد مدیرعامل'); + }); + it('cancels requests and ignores stale list/detail completions', async () => { + let resolveOld!: (value: ReturnType) => void; + list.mockImplementationOnce(() => new Promise(resolve => { resolveOld = resolve; })); render(); + fireEvent.change(screen.getByLabelText('جستجو'), { target: { value: 'new' } }); await screen.findByText(finding.title); + expect(list.mock.calls[0][1]?.aborted).toBe(true); resolveOld(response([{ ...finding, title: 'stale' }])); await new Promise(resolve => setTimeout(resolve, 0)); expect(screen.queryByText('stale')).toBeNull(); + let finish!: (value: ResearchFinding) => void; detail.mockImplementationOnce(() => new Promise(resolve => { finish = resolve; })); + fireEvent.click(screen.getByRole('button', { name: /مشاهده و پایش/ })); expect(screen.getByRole('dialog')).toBeDefined(); fireEvent.click(screen.getByRole('button', { name: 'بستن' })); finish(finding); + await new Promise(resolve => setTimeout(resolve, 0)); expect(screen.queryByRole('dialog')).toBeNull(); expect(detail.mock.calls[0][1]?.aborted).toBe(true); + }); }); diff --git a/frontend/admin-panel/src/pages/SeoTrackingPage.tsx b/frontend/admin-panel/src/pages/SeoTrackingPage.tsx index 9c09f771..c79094ba 100644 --- a/frontend/admin-panel/src/pages/SeoTrackingPage.tsx +++ b/frontend/admin-panel/src/pages/SeoTrackingPage.tsx @@ -1,450 +1,125 @@ -import { useState, useEffect, useCallback } from 'react'; -import { - TrendingUp, - Search, - Filter, - Eye, - MessageSquare, - Sparkles, - RefreshCw, - ExternalLink, - ChevronLeft, - ChevronRight, - BarChart2, - Send, -} from 'lucide-react'; -import toast from 'react-hot-toast'; -import { - seoTrackingApi, - type ResearchFinding, - type PerformanceSnapshot, -} from '../services/seoTrackingApi'; +import { useEffect, useRef, useState } from 'react'; +import { createPortal } from 'react-dom'; +import { seoTrackingApi, type ResearchFinding, type PerformanceSnapshot } from '../services/seoTrackingApi'; -const STATUS_LABELS: Record = { - RESEARCHED: { label: 'تحقیق‌شده', color: 'bg-blue-50 text-blue-700 border-blue-200' }, - ACTIONED: { label: 'اقدام‌شده (مقاله زنده)', color: 'bg-emerald-50 text-emerald-700 border-emerald-200' }, - EVALUATING: { label: 'در حال پایش سنجه‌ها', color: 'bg-amber-50 text-amber-700 border-amber-200' }, - SCALED: { label: 'توسعه‌یافته (موفق)', color: 'bg-purple-50 text-purple-700 border-purple-200' }, - PRUNED: { label: 'بازنگری / حذف', color: 'bg-rose-50 text-rose-700 border-rose-200' }, -}; +const statuses: Record = { RESEARCHED: 'تحقیق‌شده', ACTIONED: 'اقدام‌شده', EVALUATING: 'در حال پایش', SCALED: 'توسعه‌یافته', PRUNED: 'بازنگری / حذف' }; +const date = (value?: string | null) => value && Number.isFinite(Date.parse(value)) ? new Date(value).toLocaleString('fa-IR', { timeZone: 'Asia/Tehran' }) : 'نامشخص'; +const metric = (value: unknown) => value !== null && value !== undefined && value !== '' && Number.isFinite(Number(value)) ? Number(value).toLocaleString('fa-IR') : 'ناموجود'; +function failure(error: unknown, fallback: string) { + const status = (error as { response?: { status?: number } })?.response?.status; + return status === 404 ? 'یافته پیدا نشد.' : status === 403 ? 'دسترسی به این بخش مجاز نیست.' : status === 401 ? 'نشست منقضی شده؛ دوباره وارد شوید.' : fallback; +} +const fields: [keyof PerformanceSnapshot, string][] = [['gscImpressions', 'ایمپرشن GSC'], ['gscClicks', 'کلیک GSC'], ['gscPosition', 'رتبه GSC'], ['ga4ActiveUsers', 'کاربران فعال GA4'], ['ga4AvgEngagementSec', 'تعامل GA4 (ثانیه)'], ['ga4BounceRate', 'نرخ پرش GA4'], ['ga4ScrollDepthRate', 'نرخ اسکرول GA4'], ['attributedOrdersCount', 'سفارش‌های منتسب'], ['attributedSalesValue', 'ارزش فروش منتسب']]; export default function SeoTrackingPage() { const [findings, setFindings] = useState([]); - const [loading, setLoading] = useState(true); const [page, setPage] = useState(1); - const [limit] = useState(10); - const [totalPages, setTotalPages] = useState(1); - const [totalCount, setTotalCount] = useState(0); + const [meta, setMeta] = useState({ total: 0, totalPages: 0, hasNextPage: false, hasPrevPage: false }); const [search, setSearch] = useState(''); - const [statusFilter, setStatusFilter] = useState(''); - - // Detail Modal & CEO Feedback - const [selectedFinding, setSelectedFinding] = useState(null); + const [status, setStatus] = useState(''); + const [sortBy, setSortBy] = useState('createdAt'); + const [sortOrder, setSortOrder] = useState<'asc' | 'desc'>('desc'); + const [reload, setReload] = useState(0); + const [loading, setLoading] = useState(true); + const [error, setError] = useState(''); + const [detailId, setDetailId] = useState(null); + const [selected, setSelected] = useState(null); const [detailLoading, setDetailLoading] = useState(false); - const [feedbackText, setFeedbackText] = useState(''); - const [submittingFeedback, setSubmittingFeedback] = useState(false); - - const fetchFindings = useCallback(async () => { - try { - setLoading(true); - const res = await seoTrackingApi.getFindings({ - page, - limit, - search: search.trim() || undefined, - status: statusFilter || undefined, - }); - setFindings(res.data); - setTotalPages(res.meta.totalPages); - setTotalCount(res.meta.total); - } catch { - toast.error('خطا در بارگذاری داده‌های پایش سئو'); - } finally { - setLoading(false); - } - }, [page, limit, search, statusFilter]); + const [detailError, setDetailError] = useState(''); + const [detailReload, setDetailReload] = useState(0); + const [feedback, setFeedback] = useState(''); + const [saving, setSaving] = useState(false); + const [conflict, setConflict] = useState(false); + const [feedbackMessage, setFeedbackMessage] = useState(''); + const pageContent = useRef(null); + const modal = useRef(null); + const closeButton = useRef(null); + const opener = useRef(null); + const detailGeneration = useRef(0); useEffect(() => { - fetchFindings(); - }, [fetchFindings]); + const controller = new AbortController(); + setLoading(true); setError(''); + seoTrackingApi.getFindings({ page, limit: 10, search: search.trim() || undefined, status: status || undefined, sortBy, sortOrder }, controller.signal) + .then(result => { if (!controller.signal.aborted) { setFindings(result.data); setMeta(result.meta); } }) + .catch(err => { if (!controller.signal.aborted) setError(failure(err, 'خطا در بارگذاری داده‌ها؛ داده‌های قبلی ممکن است قدیمی باشند.')); }) + .finally(() => { if (!controller.signal.aborted) setLoading(false); }); + return () => controller.abort(); + }, [page, search, status, sortBy, sortOrder, reload]); - const handleOpenDetail = async (id: string) => { + useEffect(() => { + if (!detailId) return; + const controller = new AbortController(); + const generation = ++detailGeneration.current; + setDetailLoading(true); setDetailError(''); setFeedbackMessage(''); + seoTrackingApi.getFindingById(detailId, controller.signal).then(data => { + if (!controller.signal.aborted && generation === detailGeneration.current) { setSelected(data); setFeedback(data.ceoFeedback ?? ''); setConflict(false); } + }).catch(err => { if (!controller.signal.aborted) setDetailError(failure(err, 'خطا در دریافت جزئیات.')); }) + .finally(() => { if (!controller.signal.aborted) setDetailLoading(false); }); + return () => controller.abort(); + }, [detailId, detailReload]); + + useEffect(() => { + if (!detailId) return; + const previousOverflow = document.body.style.overflow; + const content = pageContent.current; + if (content) content.inert = true; + document.body.style.overflow = 'hidden'; closeButton.current?.focus(); + return () => { if (content) content.inert = false; document.body.style.overflow = previousOverflow; opener.current?.focus(); }; + }, [detailId]); + + const close = () => { detailGeneration.current++; setDetailId(null); setSelected(null); setSaving(false); }; + const save = async () => { + if (!selected || saving || conflict) return; + const generation = detailGeneration.current; + setSaving(true); setFeedbackMessage(''); try { - setDetailLoading(true); - const data = await seoTrackingApi.getFindingById(id); - setSelectedFinding(data); - setFeedbackText(data.ceoFeedback || ''); - } catch { - toast.error('خطا در دریافت جزئیات یافته سئو'); - } finally { - setDetailLoading(false); - } + const updated = await seoTrackingApi.updateCeoFeedback(selected.id, feedback.trim(), selected.version); + if (generation !== detailGeneration.current) return; + setSelected(current => current ? { ...current, ...updated, snapshots: updated.snapshots ?? current.snapshots } : current); + setFeedback(updated.ceoFeedback ?? ''); setFeedbackMessage('بازخورد ثبت شد.'); setReload(value => value + 1); + } catch (err) { + if (generation !== detailGeneration.current) return; + if ((err as { response?: { status?: number } })?.response?.status === 409) { setConflict(true); setFeedbackMessage('رکورد تغییر کرده؛ پیش از ذخیره، نسخه جدید را دریافت کنید. پیش‌نویس شما حفظ شده است.'); } + else setFeedbackMessage(failure(err, 'خطا در ثبت بازخورد؛ پیش‌نویس حفظ شد.')); + } finally { if (generation === detailGeneration.current) setSaving(false); } }; - - const handleSaveCeoFeedback = async () => { - if (!selectedFinding) return; - try { - setSubmittingFeedback(true); - const updated = await seoTrackingApi.updateCeoFeedback( - selectedFinding.id, - feedbackText.trim() - ); - setSelectedFinding(updated); - toast.success('دستور و بازخورد مدیرعامل با موفقیت ثبت شد'); - fetchFindings(); - } catch { - toast.error('خطا در ثبت بازخورد مدیرعامل'); - } finally { - setSubmittingFeedback(false); - } - }; - - const latestSnapshot: PerformanceSnapshot | undefined = - selectedFinding?.snapshots && selectedFinding.snapshots.length > 0 - ? selectedFinding.snapshots[0] - : undefined; - - return ( -
- {/* Header */} -
-
-
- -
-
-

- پایش عملکرد سئو و بازخورد مدیرعامل -

-

- اتصال هوشمند نتایج تحقیقات روزانه سئو به سنجه‌های زنده گوگل (GSC)، رفتار کاربر (GA4) و فروش استور -

-
-
- - -
- - {/* Filter and Search Bar */} -
-
- - { - setSearch(e.target.value); - setPage(1); - }} - placeholder="جستجو در موضوع، کلیدواژه یا فرضیه سئو..." - className="w-full pl-4 pr-11 py-2.5 bg-white border border-gray-200 rounded-xl text-sm focus:outline-none focus:ring-2 focus:ring-purple-500" - /> -
- -
- - -
-
- - {/* Main Table */} -
-
- - - - - - - - - - - - - {loading ? ( - - - - ) : findings.length === 0 ? ( - - - - ) : ( - findings.map((f) => { - const statusInfo = STATUS_LABELS[f.status] || { - label: f.status, - color: 'bg-gray-100 text-gray-600 border-gray-200', - }; - - return ( - - - - - - - - - ); - }) - )} - -
موضوع و فرضیهکلیدواژه اصلیوضعیتمقاله مرتبطدستور مدیرعاملعملیات
- - در حال دریافت داده‌ها... -
- موردی یافت نشد. -
-
{f.title}
-
{f.hypothesis}
-
- - {f.primaryKeyword} - - - - {statusInfo.label} - - - {f.blog ? ( - - {f.blog.title} - - - ) : ( - بدون مقاله - )} - - {f.ceoFeedback ? ( - - - دستور ثبت‌شده - - ) : ( - ثبت‌نشده - )} - - -
-
- - {/* Pagination Footer */} -
-
- تعداد کل: {totalCount} مورد -
- -
- - - صفحه {page} از {totalPages || 1} - - -
-
-
- - {/* Detail & CEO Feedback Modal */} - {selectedFinding && ( -
-
- {/* Modal Header */} -
-
-

{selectedFinding.title}

-
- کلیدواژه اصلی: - - {selectedFinding.primaryKeyword} - -
-
- -
- - {/* Modal Body */} -
- {detailLoading ? ( -
- - در حال بارگذاری جزئیات... -
- ) : ( - <> - {/* Hypothesis & Outcome */} -
-
-

فرضیه و منطق سئو:

-

- {selectedFinding.hypothesis} -

-
- -
-

نتیجه مورد انتظار بیزینس:

-

- {selectedFinding.expectedOutcome} -

-
-
- - {/* Performance Metrics Cards */} -
-

- - آخرین پایش زنده سنجه‌ها -

- - {latestSnapshot ? ( -
-
- ایمپرشن سرچ گوگل -
- {latestSnapshot.gscImpressions.toLocaleString('fa-IR')} -
- کلیک: {latestSnapshot.gscClicks} -
- -
- کاربر فعال GA4 -
- {latestSnapshot.ga4ActiveUsers.toLocaleString('fa-IR')} -
- - میانگین حضور: {Math.round(latestSnapshot.ga4AvgEngagementSec)} ثانیه - -
- -
- سفارش‌های متصل -
- {latestSnapshot.attributedOrdersCount} سفارش -
- - فروش: {Number(latestSnapshot.attributedSalesValue).toLocaleString('fa-IR')} ت - -
- -
- پیشنهاد سیستم -
- {latestSnapshot.actionRecommendation || 'ادامه پایش'} -
- خودکار -
-
- ) : ( -
- هنوز اولین پایش سنجه‌ها برای این موضوع ثبت نشده است. -
- )} -
- - {/* CEO Feedback Directive Section */} -
-
- -

- دستور و بازخورد مستقیم مدیرعامل (Parsa Aghayi) -

-
-

- ثبت نظر در اینجا اختیاری است، ولی در صورت ثبت، به عنوان دستور الزام‌آور در چرخه خودکار بعدی رعایت می‌شود. -

- -