feat(blog): implement medical review gate for blog posts
- Added new fields to the Blog entity: sources, review_status, reviewer, reviewed_at, review_note, and topic_slug.
- Created API endpoints for reviewing blog posts: GET /api/v1/admin/blog/review-queue and POST /api/v1/admin/blog/{uuid}/review.
- Updated BlogController to handle review logic, including approval and rejection of posts.
- Introduced BlogReviewPage component for admin interface to manage blog reviews.
- Added migration to update the database schema for new fields.
- Implemented tests for review queue functionality and review decision handling.
This commit is contained in:
@@ -31,6 +31,7 @@ import LogsPage from './pages/LogsPage';
|
||||
import CategoriesPage from './pages/CategoriesPage';
|
||||
import BlogsPage from './pages/BlogsPage';
|
||||
import BlogFormPage from './pages/BlogFormPage';
|
||||
import BlogReviewPage from './pages/BlogReviewPage';
|
||||
import SecretariesPage from './pages/SecretariesPage';
|
||||
import ClinicDoctorsPage from './pages/ClinicDoctorsPage';
|
||||
import SettingsPage from './pages/SettingsPage';
|
||||
@@ -204,6 +205,7 @@ export default function App() {
|
||||
<Route path="blogs" element={<RoleRoute roles={['admin']}><BlogsPage /></RoleRoute>} />
|
||||
<Route path="blogs/new" element={<RoleRoute roles={['admin']}><BlogFormPage /></RoleRoute>} />
|
||||
<Route path="blogs/:uuid/edit" element={<RoleRoute roles={['admin']}><BlogFormPage /></RoleRoute>} />
|
||||
<Route path="blog-review" element={<RoleRoute roles={['admin']}><BlogReviewPage /></RoleRoute>} />
|
||||
<Route path="secretaries" element={<RoleRoute roles={['admin']}><SecretariesPage /></RoleRoute>} />
|
||||
<Route path="clinics" element={<RoleRoute roles={['admin', 'representation']}><ClinicsPage /></RoleRoute>} />
|
||||
<Route path="settings" element={<RoleRoute roles={['admin']}><SettingsPage /></RoleRoute>} />
|
||||
|
||||
@@ -191,6 +191,11 @@ function buildSections(
|
||||
icon: DocumentTextIcon,
|
||||
label: "بلاگ",
|
||||
},
|
||||
{
|
||||
to: "/admin/blog-review",
|
||||
icon: DocumentTextIcon,
|
||||
label: "بازبینی بلاگ",
|
||||
},
|
||||
{
|
||||
to: "/admin/sms",
|
||||
icon: DevicePhoneMobileIcon,
|
||||
|
||||
@@ -0,0 +1,214 @@
|
||||
import { useState } from 'react';
|
||||
import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
|
||||
import { toast } from 'sonner';
|
||||
import { api } from '../lib/api';
|
||||
import type { ApiResponse, PaginatedResponse } from '../lib/api';
|
||||
import type { Blog } from '../types';
|
||||
import { formatDate } from '../lib/utils';
|
||||
import PageHeader from '../components/ui/PageHeader';
|
||||
import DataTable, { Column } from '../components/ui/DataTable';
|
||||
import Pagination from '../components/ui/Pagination';
|
||||
import Modal from '../components/ui/Modal';
|
||||
import ConfirmDialog from '../components/ui/ConfirmDialog';
|
||||
|
||||
const limit = 15;
|
||||
|
||||
/** وضعیت بازبینی → رنگ نشان. مقالههای صف همه pending_review هستند. */
|
||||
function reviewBadgeColor(status?: string | null): string {
|
||||
switch (status) {
|
||||
case 'approved': return 'green';
|
||||
case 'rejected': return 'red';
|
||||
case 'pending_review': return 'amber';
|
||||
default: return 'gray';
|
||||
}
|
||||
}
|
||||
|
||||
function reviewBadgeLabel(status?: string | null): string {
|
||||
switch (status) {
|
||||
case 'approved': return 'تأییدشده';
|
||||
case 'rejected': return 'ردشده';
|
||||
case 'pending_review': return 'در انتظار بازبینی';
|
||||
default: return status ?? '—';
|
||||
}
|
||||
}
|
||||
|
||||
export default function BlogReviewPage() {
|
||||
const qc = useQueryClient();
|
||||
const [page, setPage] = useState(1);
|
||||
const [preview, setPreview] = useState<Blog | null>(null);
|
||||
const [rejectTarget, setRejectTarget] = useState<Blog | null>(null);
|
||||
const [rejectNote, setRejectNote] = useState('');
|
||||
|
||||
const { data, isLoading } = useQuery({
|
||||
queryKey: ['blog-review-queue', page],
|
||||
queryFn: () => {
|
||||
const params = new URLSearchParams({ page: String(page), limit: String(limit) });
|
||||
return api.get<PaginatedResponse<Blog>>(`/api/v1/admin/blog/review-queue?${params}`);
|
||||
},
|
||||
});
|
||||
|
||||
const items = data?.data ?? [];
|
||||
const total = data?.meta?.totalRecords ?? 0;
|
||||
|
||||
const approveMutation = useMutation({
|
||||
mutationFn: (blog: Blog) =>
|
||||
api.post<ApiResponse<Blog>>(`/api/v1/admin/blog/${blog.uuid}/review`, {
|
||||
decision: 'approved',
|
||||
publish: true,
|
||||
}),
|
||||
onSuccess: () => {
|
||||
toast.success('مقاله تأیید و منتشر شد');
|
||||
setPreview(null);
|
||||
qc.invalidateQueries({ queryKey: ['blog-review-queue'] });
|
||||
},
|
||||
onError: (err: Error) => toast.error(err.message),
|
||||
});
|
||||
|
||||
const rejectMutation = useMutation({
|
||||
mutationFn: (vars: { blog: Blog; note: string }) =>
|
||||
api.post<ApiResponse<Blog>>(`/api/v1/admin/blog/${vars.blog.uuid}/review`, {
|
||||
decision: 'rejected',
|
||||
note: vars.note,
|
||||
}),
|
||||
onSuccess: () => {
|
||||
toast.success('مقاله رد شد');
|
||||
setRejectTarget(null);
|
||||
setRejectNote('');
|
||||
setPreview(null);
|
||||
qc.invalidateQueries({ queryKey: ['blog-review-queue'] });
|
||||
},
|
||||
onError: (err: Error) => toast.error(err.message),
|
||||
});
|
||||
|
||||
const columns: Column<Blog>[] = [
|
||||
{ key: 'title', header: 'عنوان', render: (b) => <span className="fw-600">{b.title}</span> },
|
||||
{
|
||||
key: 'topic_slug',
|
||||
header: 'موضوع',
|
||||
render: (b) => <span className="muted mono">{b.topic_slug ?? '—'}</span>,
|
||||
},
|
||||
{
|
||||
key: 'review_status',
|
||||
header: 'وضعیت',
|
||||
render: (b) => (
|
||||
<span className={`badge ${reviewBadgeColor(b.review_status)}`}>
|
||||
<span className="bdot" />
|
||||
{reviewBadgeLabel(b.review_status)}
|
||||
</span>
|
||||
),
|
||||
},
|
||||
{ key: 'created_at', header: 'تاریخ', render: (b) => formatDate(b.created_at) },
|
||||
];
|
||||
|
||||
return (
|
||||
<div className="fade-in">
|
||||
<PageHeader
|
||||
title="بازبینی مقالات بلاگ"
|
||||
description="پیشنویسهای تولیدشده توسط پایپلاین محتوا؛ پس از بازبینی پزشک منتشر میشوند."
|
||||
breadcrumbs={[{ label: 'بلاگ', to: '/admin/blogs' }, { label: 'بازبینی' }]}
|
||||
/>
|
||||
|
||||
<div className="card card-pad" style={{ marginTop: 'var(--gap)' }}>
|
||||
<DataTable<Blog>
|
||||
columns={columns}
|
||||
data={items}
|
||||
loading={isLoading}
|
||||
emptyMessage="مقالهای در انتظار بازبینی نیست"
|
||||
actions={(b) => (
|
||||
<button className="mini-btn" onClick={() => setPreview(b)}>
|
||||
بازبینی
|
||||
</button>
|
||||
)}
|
||||
/>
|
||||
<Pagination page={page} total={total} limit={limit} onPageChange={setPage} />
|
||||
</div>
|
||||
|
||||
{/* پیشنمایش کامل + تصمیم */}
|
||||
<Modal
|
||||
open={!!preview}
|
||||
title={preview?.title ?? ''}
|
||||
size="xl"
|
||||
onClose={() => setPreview(null)}
|
||||
footer={
|
||||
preview ? (
|
||||
<div className="row-actions">
|
||||
<button
|
||||
className="btn danger sm"
|
||||
disabled={approveMutation.isPending}
|
||||
onClick={() => {
|
||||
setRejectTarget(preview);
|
||||
setRejectNote('');
|
||||
}}
|
||||
>
|
||||
رد مقاله
|
||||
</button>
|
||||
<button
|
||||
className="btn primary sm"
|
||||
disabled={approveMutation.isPending}
|
||||
onClick={() => approveMutation.mutate(preview)}
|
||||
>
|
||||
{approveMutation.isPending ? 'در حال انتشار...' : 'تأیید و انتشار'}
|
||||
</button>
|
||||
</div>
|
||||
) : undefined
|
||||
}
|
||||
>
|
||||
{preview && (
|
||||
<div className="blog-review-preview">
|
||||
{preview.summary && <p className="muted">{preview.summary}</p>}
|
||||
<div
|
||||
className="blog-body"
|
||||
/* محتوای تولیدشده و بازبینیشده توسط ادمین است */
|
||||
dangerouslySetInnerHTML={{ __html: preview.body }}
|
||||
/>
|
||||
{preview.sources && preview.sources.length > 0 && (
|
||||
<div className="blog-sources" style={{ marginTop: 'var(--gap)' }}>
|
||||
<h4 className="section-title">منابع</h4>
|
||||
<ul>
|
||||
{preview.sources.map((s) => (
|
||||
<li key={s.url}>
|
||||
<a href={s.url} target="_blank" rel="noopener noreferrer">
|
||||
{s.title || s.url}
|
||||
</a>
|
||||
</li>
|
||||
))}
|
||||
</ul>
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
)}
|
||||
</Modal>
|
||||
|
||||
{/* رد با درج دلیل الزامی */}
|
||||
<ConfirmDialog
|
||||
open={!!rejectTarget}
|
||||
title="رد مقاله"
|
||||
message="دلیل رد را وارد کنید. مقاله در وضعیت پیشنویس باقی میماند و منتشر نمیشود."
|
||||
confirmLabel="ثبت رد"
|
||||
danger
|
||||
loading={rejectMutation.isPending}
|
||||
onConfirm={() => {
|
||||
if (!rejectTarget) return;
|
||||
if (!rejectNote.trim()) {
|
||||
toast.error('درج دلیل الزامی است');
|
||||
return;
|
||||
}
|
||||
rejectMutation.mutate({ blog: rejectTarget, note: rejectNote.trim() });
|
||||
}}
|
||||
onCancel={() => {
|
||||
setRejectTarget(null);
|
||||
setRejectNote('');
|
||||
}}
|
||||
>
|
||||
<textarea
|
||||
className="field"
|
||||
rows={3}
|
||||
placeholder="مثلاً: ادعای پزشکی بدون منبع کافی"
|
||||
value={rejectNote}
|
||||
onChange={(e) => setRejectNote(e.target.value)}
|
||||
style={{ width: '100%', marginTop: 8 }}
|
||||
/>
|
||||
</ConfirmDialog>
|
||||
</div>
|
||||
);
|
||||
}
|
||||
@@ -437,6 +437,15 @@ export interface Blog {
|
||||
/** null = مقاله سراسری (روی همه دامنهها، canonical روی دامنه اصلی) */
|
||||
city?: { id: string; name: string } | null;
|
||||
tags: string[];
|
||||
/** منابع E-E-A-T مقالههای تولیدشده توسط پایپلاین محتوا */
|
||||
sources?: { url: string; title: string }[];
|
||||
/** null = پست دستی ادمین، خارج از گیت بازبینی؛ در غیر این صورت وضعیت بازبینی پزشک */
|
||||
review_status?: "pending_review" | "approved" | "rejected" | null;
|
||||
reviewer?: { uuid: string; name: string } | null;
|
||||
reviewed_at?: number | null;
|
||||
review_note?: string | null;
|
||||
/** کلید یکتای موضوع پایپلاین (specialty, angle) */
|
||||
topic_slug?: string | null;
|
||||
created_at: string;
|
||||
updated_at?: string;
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user