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.

assets/admin/pages/RepresentationBlogFormPage.tsx

@@ -29,14 +29,15 @@ export default function RepresentationBlogFormPage() {
   });
   const cityOptions = (meQuery.data?.data?.cities ?? []).map((c) => ({ value: c.id, label: c.name }));
 
-  const { data, isLoading } = useQuery({
+  const { data, isLoading, isError, error } = useQuery({
     queryKey: ['rep-blog', uuid],
     queryFn: () => api.get<ApiResponse<{ data: Blog }>>(`/api/v1/representation/blog/${uuid}`),
     enabled: isEdit,
+    retry: false,
   });
   const blog = data?.data?.data;
 
-  const { register, handleSubmit, control, formState: { errors, isSubmitting } } = useForm<BlogFormData>({
+  const { register, handleSubmit, control, formState: { errors } } = useForm<BlogFormData>({
     resolver: zodResolver(blogFormSchema),
     defaultValues: blogDefaults(),
     values: blog ? (blogDefaults(blog) as BlogFormData) : undefined,
@@ -63,6 +64,8 @@ export default function RepresentationBlogFormPage() {
     onError: (err: Error) => toast.error(err.message),
   });
 
+  const saving = createMutation.isPending || updateMutation.isPending;
+
   const onSubmit = (d: BlogFormData) => {
     if (!d.city_id) {
       toast.error('انتخاب شهر الزامی است');
@@ -76,6 +79,17 @@ export default function RepresentationBlogFormPage() {
     return <div className="cp-card p-6 space-y-3">{Array.from({ length: 5 }).map((_, i) => <div key={i} className="h-10 rounded-lg skeleton" />)}</div>;
   }
 
+  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/representation-blogs')}>
+          بازگشت به فهرست مقالات
+        </button>
+      </div>
+    );
+  }
+
   return (
     <div>
       <PageHeader
@@ -88,16 +102,16 @@ export default function RepresentationBlogFormPage() {
           <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')} className="cp-input h-11" placeholder="عنوان جذاب بنویسید..." />
                 {errors.title && <p className="text-[var(--danger)] text-xs mt-1">{errors.title.message}</p>}
               </div>
               <div>
-                <label>خلاصه</label>
-                <textarea {...register('summary')} rows={2} className="input resize-none" />
+                <label className="cp-label">خلاصه</label>
+                <textarea {...register('summary')} rows={2} className="cp-textarea resize-none" />
               </div>
               <div>
-                <label>محتوا *</label>
+                <label className="cp-label">محتوا *</label>
                 <Controller
                   control={control}
                   name="body"
@@ -118,7 +132,7 @@ export default function RepresentationBlogFormPage() {
 
             <div className="space-y-5">
               <div>
-                <label>شهر *</label>
+                <label className="cp-label">شهر *</label>
                 <Controller
                   control={control}
                   name="city_id"
@@ -135,7 +149,7 @@ export default function RepresentationBlogFormPage() {
                 <p className="text-[12px] text-[var(--text-3)] mt-1">فقط شهرهای حوزهٔ نمایندگی شما.</p>
               </div>
               <div>
-                <label>وضعیت انتشار</label>
+                <label className="cp-label">وضعیت انتشار</label>
                 <Controller
                   control={control}
                   name="status"
@@ -149,11 +163,11 @@ export default function RepresentationBlogFormPage() {
                 />
               </div>
               <div>
-                <label>آدرس تصویر شاخص (URL)</label>
+                <label className="cp-label">آدرس تصویر شاخص (URL)</label>
                 <input {...register('image_url')} dir="ltr" className="cp-input h-11" placeholder="https://..." />
               </div>
               <div>
-                <label>تگ‌ها (با ویرگول)</label>
+                <label className="cp-label">تگ‌ها (با ویرگول)</label>
                 <input {...register('tags')} dir="ltr" className="cp-input h-11" placeholder="tag1, tag2" />
               </div>
             </div>
@@ -164,8 +178,8 @@ export default function RepresentationBlogFormPage() {
           </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/representation-blogs')} className="cp-btn-secondary justify-center py-2.5" style={{ minWidth: 120 }}>لغو</button>
           </div>