用途：围绕 NextAuth.js 处理身份认证相关开发，包括会话管理、JWT 令牌、基于角色的访问控制（RBAC）与路由保护。
主要能力：获取当前会话、校验用户角色、保护 API 路由与页面路由、登录与登出、定义用户角色与会话结构。
使用方式：从 @/lib/auth 导入 auth() 获取当前会话；在管理操作前先校验角色；用 middleware.ts 保护路由；在 API 路由中验证 JWT；通过 @/lib/auth 的 signIn/signOut 完成登录登出。资料给出的角色包括 admin（完全访问）、customer（普通用户）、moderator（有限管理权限）；会话包含 user.id、email、name、role、image 与 expires 字段。
关键文件：auth.ts（NextAuth.js 配置）、src/lib/auth/（认证工具）、middleware.ts（路由保护）、src/app/api/auth/（认证 API 路由）。
限制与注意：不要在 localStorage 中存储令牌，应使用 httpOnly cookie；未提供具体依赖版本、环境变量配置、第三方提供商完整清单及部署要求，这些需另行确认。