Next.jsReact后台

nextjs-fsd-template — Next.js 后台模板

作者 devTugu

Next.js 16 后台模板,采用 FSD 分层架构,内置 RBAC 权限 UI 与 TanStack 表格,需搭配同作者 NestJS 后端使用。

看看你的网站会是什么样

浏览真实页面截图,比较内容排版与手机效果。点击下方缩略图切换,放大查看整页细节。

4 个预览视图
仓库预览 11 / 4
作者提供的预览

来自项目仓库的原始界面图片。

全部页面与视图 4

截图用于了解视觉与布局,交互效果请以实际项目为准。

采集于 2026-09-27查看来源

值得关注的模板亮点

从已有项目资料中,快速了解它的特点。

01

按 Feature-Sliced Design 划分 app、widgets、features、entities、shared、processes 六层,并规定严格导入方向

02

基于 permissionCodes 的 RBAC 界面控制,SUPER_ADMIN 与细粒度权限码并存

03

用户、角色、权限三套 CRUD,含 sheet 表单与分组权限选择器

04

TanStack Query v5 + TanStack Table v8 + react-hook-form/Zod + shadcn/ui 技术组合

05

Axios 封装 Nest 响应格式与 JWT 刷新,附带架构文档和 ADR

模板详细介绍

这是一个 Next.js 16 App Router 后台管理模板,最鲜明的特点是按 Feature-Sliced Design 组织 src 目录:app、widgets、features、entities、shared、processes 六层,并规定了严格的单向导入规则。页面路由只做薄壳,用户、角色、权限等业务能力放在 features,表格列和 API hooks 归 entities,侧边栏、数据表等组合块归 widgets。仓库内附有架构说明和三份 ADR,适合想在实际项目里落地 FSD 的团队参考。

功能层面覆盖登录、仪表盘统计,以及用户、角色、权限三块 CRUD。数据请求用 TanStack Query v5,表格用 TanStack Table v8,表单是 react-hook-form 加 Zod,UI 基于 shadcn/ui 和 Tailwind CSS 4,HTTP 层用 Axios 处理 Nest 风格响应封装和 JWT 刷新。权限控制依赖 GET /auth/me 返回的 permissionCodes:SUPER_ADMIN 拥有全部权限,其余按钮和路由按 USER_READ、ROLE_CREATE 这类编码判断。

需要留意的是,它并非独立可跑的前端,必须搭配同作者的 nestjs-fsd-template 后端(本地 3001 端口,MySQL 加可选 Redis),仓库也把它定位为配套前端。README 提到 production-ready 并给出上线检查清单,但 CI 中的 E2E 只是 stub,完整端到端测试要在本地同时启动两个仓库。许可证状态在资料中标记为 review,使用前建议自行核对 LICENSE 文件。

Next.jsReact后台

适合你的项目吗?

适用场景

  • 需要一套带权限管理界面的后台前端骨架,并愿意同时采用配套 NestJS 后端
  • 团队想在实际项目中实践 Feature-Sliced Design,需要可参考的目录与导入约束
  • 以用户、角色、权限为核心的中后台系统,希望复用现成的表格、表单和 sheet 交互

适合人群

  • 使用 Next.js 16 App Router 与 TypeScript 的前端团队
  • 已决定或愿意引入 nestjs-fsd-template 作为 API 的项目
  • 熟悉或愿意学习 FSD 分层、TanStack 生态与 shadcn/ui 的开发者

上手与定制指南

结合仓库当前版本的说明,按下面的资料检查内容、配置与运行要求。

  1. 1

    必须先启动 nestjs-fsd-template 后端(本地 3001 端口,需 MySQL,Redis 可选),前端单独无法完整运行

  2. 2

    前端配置 NEXT_PUBLIC_API_BASE_URL 指向 /api/v1,后端 CORS_ORIGIN 需与前端地址精确匹配

  3. 3

    种子管理员账号为 [email protected] / Admin123!,仅用于本地开发,上线前务必更换

  4. 4

    CI 中的 E2E 为 stub,完整 Playwright 测试需本地同时运行前后端

  5. 5

    仓库标注 production-ready 并附上线清单,但许可证状态为 review,正式使用前请核对 LICENSE 与安全文档

查看仓库使用说明

授权与来源资料

使用条件与限制

免费使用 · 保留许可声明

MIT许可,允许免费使用、修改、分发和商用,仅需保留版权与许可声明。

使用时需要遵守

  • 保留原作者版权声明和 MIT 许可证声明。
  • 保留版权声明和许可声明

额外费用与待核对事项

  • README未提供图片素材的许可信息
查看原文依据

Permission is hereby granted, free of charge, to any person obtaining a copy

许可证原文

[MIT](LICENSE)

README 原文

Permission is hereby granted, free of char

许可证原文
https://github.com/devTugu/nextjs-fsd-template/blob/main/LICENSEhttps://github.com/devTugu/nextjs-fsd-template/blob/HEAD/README.md

DeepSeek 根据仓库许可证和 README 整理 ·2026-09-24。结果仅覆盖已读取资料,依赖、图片、字体及后续条款变更以各自原文为准。

项目核对记录与介绍依据

模板资料

来源平台
GitHub
资料与维护参考分
资料较完整 · 82 / 100
技术栈
Next.js · React
网站类型
后台
这个分数如何计算

本站按许可资料(最高30分)、演示链接(12分)、预览图(10分)、Star数(15分)、记录的维护时间(15分)、描述完整度(8分)、功能记录(5分)和分类资料(5分)计算。它不是代码、安全或性能测试,也不是 Google 评分;有链接不代表已实测可用。

这个项目需要核对什么

记录的仓库更新时间
2026-06-11
截图检查日期
2026-09-07

已收录演示链接。请用你的内容与屏幕尺寸检查;有演示不代表表单、认证或支付已经可用。

目录记录的主要技术栈是 Next.js。请通过依赖清单和锁文件核对实际版本与托管要求。这些说明基于收录资料,不代表代码审计或部署实测。

查看具体选型方法 →

介绍的制作与核对状态

介绍由 AI 辅助整理目录与仓库资料。仓库作者不等于这篇介绍的审核者。

当前版本没有可核对的编辑审核记录;旧的应用时间不代表已完成事实审核。

这条历史介绍未保存固定版本的来源快照。请对照当前仓库,发现不一致可反馈。

反馈内容错误

看看同类模板

对比同技术栈与用途的模板,找到更适合的视觉与内容结构。