feat(blog): add admin endpoint for blog details and cache invalidation

- Implemented `adminDetail()` method in `BlogController` to retrieve blog posts of any status for admin editing.
- Introduced `BlogCacheInvalidator` service to handle cache invalidation after blog create/update/delete actions.
- Updated existing methods in `BlogController` and `RepresentationBlogController` to call cache invalidation on blog modifications.
- Enhanced `BlogFormPage` and `RepresentationBlogFormPage` to utilize the new admin endpoint for fetching blog data.
- Added tests for `BlogCacheInvalidator` to ensure proper functionality and error handling.
- Updated documentation to reflect new API endpoint and cache invalidation behavior.
This commit is contained in:
hamed
2026-07-27 18:54:35 +03:30
parent e4edaea9b8
commit 15abcb5c8a
12 changed files with 972 additions and 47 deletions
+30 -13
View File
@@ -45,10 +45,13 @@ export default function BlogFormPage() {
const [uploading, setUploading] = useState(false);
const [aiOpen, setAiOpen] = useState(false);
const { data, isLoading } = useQuery({
const { data, isLoading, isError, error } = useQuery({
queryKey: ['blog', uuid],
queryFn: () => api.get<ApiResponse<{ data: Blog }>>(`/api/v1/blog/${uuid}`),
// اندپوینت ادمین پیش‌نویس و آرشیو را هم برمی‌گرداند؛ اندپوینت عمومی فقط
// published است و برای پیش‌نویس ۴۰۴ می‌داد → فرم خالی بدون هیچ پیام خطا.
queryFn: () => api.get<ApiResponse<{ data: Blog }>>(`/api/v1/admin/blog/${uuid}`),
enabled: isEdit,
retry: false,
});
const blog = data?.data?.data;
@@ -59,7 +62,7 @@ export default function BlogFormPage() {
});
const cityOptions = (citiesQuery.data?.data ?? []).map((c) => ({ value: c.id, label: c.name }));
const { register, handleSubmit, control, watch, setValue, formState: { errors, isSubmitting } } = useForm<BlogFormData>({
const { register, handleSubmit, control, watch, setValue, formState: { errors } } = useForm<BlogFormData>({
resolver: zodResolver(blogFormSchema),
defaultValues: blogDefaults(),
values: blog ? (blogDefaults(blog) as BlogFormData) : undefined,
@@ -88,6 +91,8 @@ export default function BlogFormPage() {
onError: (err: Error) => toast.error(err.message),
});
const saving = createMutation.isPending || updateMutation.isPending;
const onSubmit = (d: BlogFormData) => {
if (isEdit) updateMutation.mutate(d);
else createMutation.mutate(d);
@@ -119,6 +124,18 @@ export default function BlogFormPage() {
);
}
// فرم خالیِ قابل‌ثبت نمایش داده نشود: کاربر باید بفهمد مقاله بارگذاری نشده.
if (isEdit && (isError || !blog)) {
return (
<div className="cp-card p-6 text-center space-y-4">
<p className="text-[var(--danger)]">{(error as Error | null)?.message ?? 'مقاله یافت نشد'}</p>
<button type="button" className="cp-btn-secondary" onClick={() => navigate('/admin/blogs')}>
بازگشت به فهرست مقالات
</button>
</div>
);
}
return (
<div>
<PageHeader
@@ -140,18 +157,18 @@ export default function BlogFormPage() {
<div className="grid grid-cols-1 lg:grid-cols-3 gap-6">
<div className="lg:col-span-2 space-y-5">
<div>
<label>عنوان مقاله *</label>
<label className="cp-label">عنوان مقاله *</label>
<input {...register('title')} placeholder="عنوان جذاب بنویسید..." className="cp-input h-11" />
{errors.title && <p className="text-[var(--danger)] text-xs mt-1">{errors.title.message}</p>}
</div>
<div>
<label>خلاصه</label>
<textarea {...register('summary')} rows={2} placeholder="خلاصه کوتاه مقاله..." className="input resize-none" />
<label className="cp-label">خلاصه</label>
<textarea {...register('summary')} rows={2} placeholder="خلاصه کوتاه مقاله..." className="cp-textarea resize-none" />
</div>
<div>
<label>محتوا *</label>
<label className="cp-label">محتوا *</label>
<Controller
control={control}
name="body"
@@ -176,7 +193,7 @@ export default function BlogFormPage() {
<div className="space-y-5">
<div>
<label>تصویر شاخص</label>
<label className="cp-label">تصویر شاخص</label>
{imageUrl ? (
<div className="relative">
<img src={imageUrl} alt="cover" style={{ width: '100%', height: 160, objectFit: 'cover', borderRadius: 8 }} />
@@ -193,7 +210,7 @@ export default function BlogFormPage() {
</div>
<div>
<label>وضعیت انتشار</label>
<label className="cp-label">وضعیت انتشار</label>
<Controller
control={control}
name="status"
@@ -208,7 +225,7 @@ export default function BlogFormPage() {
</div>
<div>
<label>شهر</label>
<label className="cp-label">شهر</label>
<Controller
control={control}
name="city_id"
@@ -227,7 +244,7 @@ export default function BlogFormPage() {
</div>
<div>
<label>تگها (با ویرگول جدا کنید)</label>
<label className="cp-label">تگها (با ویرگول جدا کنید)</label>
<input {...register('tags')} dir="ltr" placeholder="tag1, tag2, tag3" className="cp-input h-11" />
</div>
</div>
@@ -239,8 +256,8 @@ export default function BlogFormPage() {
</div>
<div className="flex gap-3">
<button type="submit" disabled={isSubmitting} className="cp-btn-primary justify-center py-2.5" style={{ minWidth: 160 }}>
{isSubmitting ? 'در حال ذخیره...' : isEdit ? 'بروزرسانی' : 'ذخیره'}
<button type="submit" disabled={saving} className="cp-btn-primary justify-center py-2.5" style={{ minWidth: 160 }}>
{saving ? 'در حال ذخیره...' : isEdit ? 'بروزرسانی' : 'ذخیره'}
</button>
<button type="button" onClick={() => navigate('/admin/blogs')} className="cp-btn-secondary justify-center py-2.5" style={{ minWidth: 120 }}>
لغو