feat: 添加仪表板功能，整合统计数据并优化后台管理界面

internal/controller/v1/admin.go

@@ -2,12 +2,13 @@ package v1
 
 import (
 	"context"
+	"strconv"
+
 	"github.com/cloudwego/hertz/pkg/app"
 	"github.com/snowykami/neo-blog/internal/dto"
 	"github.com/snowykami/neo-blog/internal/service"
 	"github.com/snowykami/neo-blog/pkg/errs"
 	"github.com/snowykami/neo-blog/pkg/resps"
-	"strconv"
 )
 
 type AdminController struct {
@@ -20,6 +21,15 @@ func NewAdminController() *AdminController {
 	}
 }
 
+func (cc *AdminController) GetDashboard(ctx context.Context, c *app.RequestContext) {
+	dashboardData, err := cc.service.GetDashboard()
+	if err != nil {
+		serviceErr := errs.AsServiceError(err)
+		resps.Custom(c, serviceErr.Code, err.Error(), nil)
+	}
+	resps.Ok(c, resps.Success, dashboardData)
+}
+
 func (cc *AdminController) CreateOidc(ctx context.Context, c *app.RequestContext) {
 	var adminCreateOidcReq dto.AdminOidcConfigDto
 	if err := c.BindAndValidate(&adminCreateOidcReq); err != nil {

internal/model/post.go

@@ -6,19 +6,24 @@ import (
 	"gorm.io/gorm"
 )
 
+type PostBase struct {
+	Title      string   `gorm:"type:text;not null"`
+	Cover      string   `gorm:"type:text"`
+	Content    string   `gorm:"type:text;not null"`
+	Type       string   `gorm:"type:text;default:markdown"`
+	CategoryID uint     `gorm:"index"`
+	Category   Category `gorm:"foreignKey:CategoryID;references:ID"`
+	Labels     []Label  `gorm:"many2many:post_labels;constraint:OnUpdate:CASCADE,OnDelete:SET NULL;"`
+	IsOriginal bool     `gorm:"default:true"`
+	IsPrivate  bool     `gorm:"default:false"`
+}
 type Post struct {
 	gorm.Model
 	UserID uint `gorm:"index"`                           // 发布者的用户ID
 	User   User `gorm:"foreignKey:UserID;references:ID"` // 关联的用户
-	Title        string   `gorm:"type:text;not null"`                                                   // 帖子标题
-	Cover        string   `gorm:"type:text"`                                                            // 帖子封面图
-	Content      string   `gorm:"type:text;not null"`                                                   // 帖子内容
-	Type         string   `gorm:"type:text;default:markdown"`                                           // markdown类型，支持markdown或html或txt
-	CategoryID   uint     `gorm:"index"`                                                                // 帖子分类ID
-	Category     Category `gorm:"foreignKey:CategoryID;references:ID"`                                  // 关联的分类
-	Labels       []Label  `gorm:"many2many:post_labels;constraint:OnUpdate:CASCADE,OnDelete:SET NULL;"` // 关联的标签
-	IsOriginal   bool     `gorm:"default:true"`                                                         // 是否为原创帖子
-	IsPrivate    bool     `gorm:"default:false"`
+	// core fields
+	PostBase
+	//
 	LikeCount    uint64
 	CommentCount uint64
 	ViewCount    uint64
@@ -71,3 +76,11 @@ func (p *Post) ToDtoWithShortContent(contentLength int) *dto.PostDto {
 	}
 	return dtoPost
 }
+
+// Draft 草稿
+type Draft struct {
+	gorm.Model
+	PostID uint `gorm:"uniqueIndex"` // 关联的文章ID
+	Post   Post `gorm:"foreignKey:PostID;references:ID"`
+	PostBase
+}

internal/router/apiv1/admin.go

@@ -17,5 +17,6 @@ func registerAdminRoutes(group *route.RouterGroup) {
 		consoleGroup.GET("/oidc/o/:id", adminController.GetOidcByID)
 		consoleGroup.GET("/oidc/list", adminController.ListOidc)
 		consoleGroup.PUT("/oidc/o/:id", adminController.UpdateOidc)
+		consoleGroup.GET("/dashboard", adminController.GetDashboard)
 	}
 }

internal/service/admin.go

@@ -14,6 +14,39 @@ func NewAdminService() *AdminService {
   return &AdminService{}
 }
 
+func (c *AdminService) GetDashboard() (map[string]any, error) {
+  var (
+    postCount, commentCount, userCount, viewCount int64
+    err                                           error
+    mustCount                                     = func(q *gorm.DB, dest *int64) {
+      if err == nil {
+        err = q.Count(dest).Error
+      }
+    }
+    mustScan = func(q *gorm.DB, dest *int64) {
+      if err == nil {
+        err = q.Scan(dest).Error
+      }
+    }
+  )
+  db := repo.GetDB()
+
+  mustCount(db.Model(&model.Comment{}), &commentCount)
+  mustCount(db.Model(&model.Post{}), &postCount)
+  mustCount(db.Model(&model.User{}), &userCount)
+  mustScan(db.Model(&model.Post{}).Select("SUM(view_count)"), &viewCount)
+
+  if err != nil {
+    return nil, err
+  }
+  return map[string]any{
+    "total_comments": commentCount,
+    "total_posts":    postCount,
+    "total_users":    userCount,
+    "total_views":    viewCount,
+  }, nil
+}
+
 func (c *AdminService) CreateOidcConfig(req *dto.AdminOidcConfigDto) error {
   oidcConfig := &model.OidcConfig{
     Name:             req.Name,

internal/service/post.go

@@ -23,9 +23,10 @@ func (p *PostService) CreatePost(ctx context.Context, req *dto.CreateOrUpdatePos
 		return 0, errs.ErrUnauthorized
 	}
 	post := &model.Post{
+		UserID: currentUser.ID,
+		PostBase: model.PostBase{
 			Title:   req.Title,
 			Content: req.Content,
-    UserID:  currentUser.ID,
 			Labels: func() []model.Label {
 				labelModels := make([]model.Label, 0)
 				for _, labelID := range req.Labels {
@@ -37,6 +38,7 @@ func (p *PostService) CreatePost(ctx context.Context, req *dto.CreateOrUpdatePos
 				return labelModels
 			}(),
 			IsPrivate: req.IsPrivate,
+		},
 	}
 	if err := repo.Post.CreatePost(post); err != nil {
 		return 0, err

web/src/api/admin.ts

@@ -0,0 +1,14 @@
+import { BaseResponse } from "@/models/resp"
+import axiosClient from "./client"
+
+export interface DashboardResp {
+  totalUsers: number
+  totalPosts: number
+  totalComments: number
+  totalViews: number
+} 
+
+export async function getDashboard(): Promise<BaseResponse<DashboardResp>> {
+  const res = await axiosClient.get<BaseResponse<DashboardResp>>('/admin/dashboard')
+  return res.data
+}

web/src/app/console/page.tsx

@@ -1,3 +1,5 @@
+import { Dashboard } from "@/components/console/dashboard";
+
 export default function Page() {
-  return <div>Console</div>;
+  return <Dashboard />;
 }

web/src/app/console/post/page.tsx

@@ -1,3 +1,5 @@
+import { PostManage } from "@/components/console/post-manage";
+
 export default function Page() {
-  return <div>文章管理</div>;
+  return <PostManage />;
 }

web/src/components/auth/common/current-logged.tsx

@@ -18,6 +18,7 @@ export function CurrentLogged() {
   const { user, logout } = useAuth();
 
   const handleLoggedContinue = () => {
+    console.log("continue to", redirectBack);
     router.push(redirectBack);
   }
 
@@ -30,8 +31,8 @@ export function CurrentLogged() {
     <div className="mb-4">
       <SectionDivider className="mb-4">{t("currently_logged_in")}</SectionDivider>
       <div className="flex justify-evenly items-center border border-border rounded-md p-2">
-        <div className="flex gap-4 items-center cursor-pointer">
-          <div onClick={handleLoggedContinue} className="flex gap-2 justify-center items-center  ">
+        <div onClick={handleLoggedContinue} className="flex gap-4 items-center cursor-pointer">
+          <div className="flex gap-2 justify-center items-center  ">
             <Avatar className="h-10 w-10 rounded-full">
               <AvatarImage src={getGravatarFromUser({ user })} alt={user.username} />
               <AvatarFallback className="rounded-full">{getFallbackAvatarFromUsername(user.nickname || user.username)}</AvatarFallback>

web/src/components/console/dashboard/index.tsx

@@ -0,0 +1,73 @@
+"use client"
+import { getDashboard, DashboardResp } from "@/api/admin"
+import { Card, CardDescription, CardHeader, CardTitle } from "@/components/ui/card"
+import { Eye, MessageCircle, Newspaper, Users } from "lucide-react"
+import { useEffect, useState } from "react"
+import { toast } from "sonner"
+import { path } from "../data"
+import Link from "next/link"
+
+export function Dashboard() {
+  return (
+    <div className="">
+      <DataOverview />
+    </div>
+  )
+}
+
+function DataOverview() {
+  const data = [
+    {
+      "key": "totalPosts",
+      "label": "Total Posts",
+      "icon": Newspaper,
+      "url": path.post
+    },
+    {
+      "key": "totalUsers",
+      "label": "Total Users",
+      "icon": Users,
+      "url": path.user
+    },
+    {
+      "key": "totalComments",
+      "label": "Total Comments",
+      "icon": MessageCircle,
+      "url": path.comment
+    },
+    {
+      "key": "totalViews",
+      "label": "Total Views",
+      "icon": Eye,
+      "url": path.file
+    },
+  ]
+
+  const [fetchData, setFetchData] = useState<DashboardResp | null>(null);
+
+  useEffect(() => {
+    getDashboard().then(res => {
+      setFetchData(res.data);
+    }).catch(err => {
+      toast.error(err.message || "Failed to fetch dashboard data");
+    });
+  }, [])
+
+  if (!fetchData) return <div>Loading...</div>
+
+  return <div className="grid grid-cols-1 gap-4 md:grid-cols-2 lg:grid-cols-4">
+    {data.map(item => (
+      <Link key={item.key} href={item.url}>
+        <Card key={item.key} className="p-4">
+          <CardHeader className="pb-2 text-lg font-medium">
+            <CardDescription>{item.label}</CardDescription>
+            <CardTitle className="text-2xl font-semibold tabular-nums @[250px]/card:text-3xl text-primary">
+              <item.icon className="inline mr-2" />
+              {(fetchData as any)[item.key]}
+            </CardTitle>
+          </CardHeader>
+        </Card>
+      </Link>
+    ))}
+  </div>
+}

web/src/components/console/data.ts

@@ -11,41 +11,53 @@ export interface SidebarItem {
   permission: ({ user }: { user: User }) => boolean;
 }
 
+export const path = {
+  dashboard: "/console",
+  post: "/console/post",
+  comment: "/console/comment",
+  file: "/console/file",
+  user: "/console/user",
+  global: "/console/global",
+  userProfile: "/console/user-profile",
+  userSecurity: "/console/user-security",
+  userPreference: "/console/user-preference",
+}
+
 export const sidebarData: { navMain: SidebarItem[]; navUserCenter: SidebarItem[] } = {
   navMain: [
     {
       title: "dashboard.title",
-      url: "/console",
+      url: path.dashboard,
       icon: Gauge,
       permission: isAdmin
     },
     {
       title: "post.title",
-      url: "/console/post",
+      url: path.post,
       icon: Newspaper,
       permission: isEditor
     },
     {
       title: "comment.title",
-      url: "/console/comment",
+      url: path.comment,
       icon: MessageCircle,
       permission: isEditor
     },
     {
       title: "file.title",
-      url: "/console/file",
+      url: path.file,
       icon: Folder,
       permission: () => true
     },
     {
       title: "user.title",
-      url: "/console/user",
+      url: path.user,
       icon: Users,
       permission: isAdmin
     },
     {
       title: "global.title",
-      url: "/console/global",
+      url: path.global,
       icon: Settings,
       permission: isAdmin
     },
@@ -53,19 +65,19 @@ export const sidebarData: { navMain: SidebarItem[]; navUserCenter: SidebarItem[]
   navUserCenter: [
     {
       title: "user_profile.title",
-      url: "/console/user-profile",
+      url: path.userProfile,
       icon: UserPen,
       permission: () => true
     },
     {
       title: "user_security.title",
-      url: "/console/user-security",
+      url: path.userSecurity,
       icon: ShieldCheck,
       permission: () => true
     },
     {
       title: "user-preference.title",
-      url: "/console/user-preference",
+      url: path.userPreference,
       icon: Palette,
       permission: () => true
     }

web/src/components/console/post-manage/index.tsx

@@ -0,0 +1,47 @@
+"use client";
+import { listPosts } from "@/api/post";
+import { Separator } from "@/components/ui/separator";
+import config from "@/config";
+import { OrderBy } from "@/models/common";
+import { Post } from "@/models/post"
+import { useEffect, useState } from "react";
+
+export function PostManage() {
+  const [posts, setPosts] = useState<Post[]>([]);
+  const [orderBy, setOrderBy] = useState<OrderBy>(OrderBy.CreatedAt);
+  const [desc, setDesc] = useState<boolean>(true);
+  const [page, setPage] = useState(1);
+
+  useEffect(() => {
+    listPosts({ page, size: config.postsPerPage, orderBy, desc }).then(res => {
+      setPosts(res.data.posts);
+    });
+  }, [page, orderBy, desc]);
+
+  return <div>
+    {posts.map(post => <PostItem key={post.id} post={post} />)}
+  </div>;
+}
+
+function PostItem({ post }: { post: Post }) {
+  return (
+    <div>
+      <div className="flex w-full items-center gap-3 py-2">
+        {/* left */}
+        <div>
+          <div className="text-sm font-medium">
+            {post.title}
+          </div>
+          <div>
+            <span className="text-xs text-muted-foreground">ID: {post.id}</span>
+            <span className="mx-2 text-xs text-muted-foreground">|</span>
+            <span className="text-xs text-muted-foreground">Created At: {new Date(post.createdAt).toLocaleDateString()}</span>
+            <span className="mx-2 text-xs text-muted-foreground">|</span>
+            <span className="text-xs text-muted-foreground">Updated At: {new Date(post.updatedAt).toLocaleDateString()}</span>
+          </div>
+        </div>
+      </div>
+      <Separator className="flex-1" />
+    </div>
+  )
+}

web/src/models/common.ts

@@ -1,6 +1,6 @@
 export interface PaginationParams {
   orderBy: OrderBy
-  desc: boolean
+  desc: boolean // 是否降序
   page: number
   size: number
 }