🚀 Agent Front Backend 项目技术文档
📋 文档版本： v1.0.0
👨💻 维护者： Fromsko
📖 项目概述
Agent Front Backend 是一个现代化的全栈应用，采用
Next.js 14 和
TypeScript
构建，提供智能代理管理和企业级功能。
🎯 核心特性
- 智能代理管理 - 创建、配置和监控 AI 代理
- 企业级仪表板 - 实时数据可视化和分析
- 工具集成 - 丰富的第三方工具支持
- 用户权限管理 - 细粒度的访问控制
- API 密钥管理 - 安全的密钥生成和管理
🏗️ 技术架构
前端技术栈
| 技术 |
版本 |
用途 |
| Next.js |
14.2.16 |
React 全栈框架 |
| TypeScript |
^5 |
类型安全 |
| Tailwind CSS |
^3.4.1 |
样式框架 |
| Framer Motion |
^11.11.17 |
动画库 |
| Radix UI |
最新 |
无障碍组件 |
开发工具
代码质量：
• ESLint - 代码检查
• Prettier - 代码格式化
• Husky - Git 钩子
• lint-staged - 暂存文件检查
测试框架：
• Jest - 单元测试
• React Testing Library - 组件测试
• Playwright - E2E 测试
📁 项目结构
agent-front-backend/ ├── app/ # Next.js App Router 页面 │ ├── api/ # API
路由 │ ├── dashboard/ # 仪表板页面 │ ├── auth/ # 认证页面 │ └──
globals.css # 全局样式 ├── components/ # 可复用组件 │ ├── ui/ # 基础 UI
组件 │ └── common/ # 通用组件 ├── hooks/ # 自定义 React Hooks ├── lib/ #
工具函数和配置 ├── public/ # 静态资源 ├── tests/ # 测试文件 └──
配置文件...
🚀 快速开始
环境要求
- Node.js 18.0 或更高版本
- npm 或 yarn 包管理器
- Git 版本控制
安装步骤
# 1. 克隆项目 git clone <repository-url> cd agent-front-backend # 2.
安装依赖 npm install # 3. 配置环境变量 cp .env.example .env.local # 4.
启动开发服务器 npm run dev
🔧 开发指南
可用脚本
| 命令 |
描述 |
npm run dev |
启动开发服务器 |
npm run build |
构建生产版本 |
npm run test |
运行单元测试 |
npm run lint |
代码检查 |
npm run format |
代码格式化 |
代码规范
🎨 提交信息规范：
• feat: 新功能
• fix: 修复 bug
• docs: 文档更新
• style: 代码格式化
• refactor: 重构
• test: 测试相关
🌐 部署说明
项目支持多种部署方式：
- Vercel - 推荐，零配置部署
- Netlify - 静态站点部署
- Docker - 容器化部署
- 传统服务器 - PM2 进程管理
📞 支持与联系
🐛 问题反馈： 请在 GitHub Issues 中提交
📧 技术支持： support@example.com
📚 文档更新： 定期更新，请关注版本变化