AIPAN Resource Navigator

AIPAN Resource Navigator 是一个现代化的资源管理与分享平台，基于 Next.js 13+ 和 TypeScript 构建。它提供了一个直观的界面来管理、分类和分享各种资源，支持实时搜索、分类浏览和个性化收藏功能。

主要特性

• 🚀 现代技术栈：

  • Next.js 13+ App Router
  • TypeScript
  • Tailwind CSS
  • Prisma ORM
  • NextAuth.js

• 📱 响应式设计：

  • 完全响应式布局
  • 移动端优先设计
  • 支持下拉刷新
  • 无限滚动加载

• 🔍 智能搜索：

  • 实时搜索功能
  • 按分类筛选
  • 标签系统
  • 搜索结果高亮

• 👤 用户系统：

  • 用户认证与授权
  • 个人收藏功能
  • 管理员权限控制
  • 用户资源管理

• 🎯 核心功能：

  • 资源分类管理
  • 标签系统
  • 收藏功能
  • 资源详情展示
  • 资源链接管理

技术特点

1. 现代化前端架构

   • 使用 Next.js 13+ App Router 实现服务端渲染
   • TypeScript 确保类型安全
   • Tailwind CSS 实现响应式设计
   • Shadcn UI 组件库提供美观的界面

2. 性能优化

   • 图片懒加载
   • 无限滚动
   • 数据缓存
   • 优化的资源加载

3. 用户体验

   • 平滑的动画效果
   • 即时的用户反馈
   • 直观的操作界面
   • 友好的错误提示

4. 后端架构

   • Prisma ORM 数据库操作
   • NextAuth.js 认证系统
   • API 路由系统
   • 数据验证和安全处理

项目结构

resource-navigator/
├── app/                    # Next.js 13+ App Router 目录
│   ├── admin/             # 管理后台
│   ├── api/               # API 路由
│   ├── categories/        # 分类页面
│   └── ...
├── components/            # React 组件
├── hooks/                 # 自定义 Hooks
├── lib/                   # 工具函数和配置
├── prisma/               # Prisma 配置和模型
└── public/               # 静态资源

安装和使用

1. 克隆项目

git clone [repository-url]
cd resource-navigator

2. 安装依赖

npm install

3. 环境配置

• 复制 .env.example 到 .env
• 配置必要的环境变量

4. 数据库设置

npx prisma generate
npx prisma db push

5. 启动开发服务器

npm run dev

部署指南

准备工作

1. 数据库设置

   • 创建一个 PostgreSQL 数据库（推荐使用 Neon）
   • 获取数据库连接字符串

2. 环境变量
   确保设置以下环境变量：

   DATABASE_URL=your_database_url
   NEXTAUTH_URL=your_app_url
   ADMIN_EMAIL=your_admin_email
   ADMIN_PASSWORD=your_admin_password
   NEXTAUTH_SECRET=your_secret
   TELEGRAM_BOT_TOKEN=your_bot_token
   

部署平台

GitHub

1. 创建新仓库
2. 推送代码：

   git init
   git add .
   git commit -m "Initial commit"
   git branch -M main
   git remote add origin https://github.com/YOUR_USERNAME/YOUR_REPO_NAME.git
   git push -u origin main
   

Vercel 部署

1. 登录 Vercel
2. 点击 “New Project”
3. 导入 GitHub 仓库
4. 配置环境变量
5. 点击 “Deploy”

Cloudflare Pages 部署

1. 登录 Cloudflare Dashboard
2. 进入 Pages > Create a project
3. 连接 GitHub 仓库
4. 配置构建设置：
   • Framework preset: Next.js
   • Build command: npm run build
   • Build output directory: .next
5. 添加环境变量
6. 点击 “Deploy”

部署后配置

1. 更新 NEXTAUTH_URL 为实际部署的域名
2. 运行数据库迁移：

   npx prisma db push
   

3. 创建管理员账户：

   npm run create-admin
   

4. 导入初始数据（可选）：

   npm run seed
   

贡献指南

欢迎提交 Pull Request 和 Issue。在提交之前，请确保：

1. 代码符合项目的代码规范
2. 添加必要的测试
3. 更新相关文档
4. 提交信息清晰明了

许可证

MIT License