Agency Platform

NAVAM-企业服务与代理平台

NAVAM是一个全面的全栈应用程序，旨在管理服务请求和代理项目。它具有强大的企业消息系统和用于项目分析的人工智能助手。

🚀 主要特点

1.🤖 人工智能助理（由Google Gemini提供技术支持）

• 项目健康检查：分析项目描述和状态，以生成全面的健康报告。
• 智能洞察：自动将分析分类为 状态, 风险，以及 后续步骤.
• 可视化仪表板：高级UI，带有glassmorphic卡，易于阅读。
• 客户端访问：为客户分析自己的项目提供安全访问。

2.📨 企业信息系统

• 专业沟通：带有主题行和优先级（低、正常、高）的电子邮件式消息。
• 线程收件箱：有组织的对话视图，便于高效管理。
• 基于角色：管理员和客户端之间的无缝通信。

3.📊 项目和请求管理

• 服务请求：客户可以提交新项目的详细请求。
• 项目跟踪：管理员可以管理项目、分配任务和跟踪进度。
• 客户端仪表板：客户对他们的项目、请求和消息有专门的视图。

4.🔐 安全和角色

• JWT认证：安全登录和会话管理。
• 基于角色的访问控制（RBAC）：的不同权限 ROLE_ADMIN 和 ROLE_CLIENT.
• 安全后端：用于API保护的Spring Security集成。

5.🔌 模型上下文协议（MCP）集成

NAVAM执行 模型上下文协议（MCP） 规范人工智能交互。这允许AI Assistant通过定义的工具安全地访问和操作应用程序数据。

• list_projects 工具：根据用户的角色获取项目数据（管理员看到所有，客户端看到他们的）。
• analyze_project 工具：将项目详细信息提供给Gemini AI进行实时健康分析。
• 可扩展架构：MCP实施(MCPController)旨在在未来轻松支持更多工具。

🛠️ 技术栈

前端

• React.js：基于组件的UI架构。
• 顺风CSS：实用性优先的造型，实现现代、灵敏的设计。
• 维特：快速构建工具和开发服务器。
• Lucide反应：漂亮、一致的图标。
• 阿西奥斯：用于API通信的HTTP客户端。

后端

• Java春季启动：强大、可扩展的后端框架。
• Spring Security：身份验证和授权。
• MongoDB：用于灵活数据存储的NoSQL数据库。
• Google Gemini API：用于项目分析和任务生成的生成式人工智能。
• 梅文：依赖性管理。

⚙️ 安装说明

先决条件

• Java 17+
• Node.js 18+
• MongoDB（本地运行或Atlas URI）
• Google Gemini API密钥

1.后端设置

1. 导航到后端目录：

   cd backend

1. 配置 src/main/resources/application.properties:

   spring.data.mongodb.uri=mongodb://localhost:27017/navam_db
   gemini.api.key=YOUR_GEMINI_API_KEY
   navam.app.jwtSecret=YOUR_SECURE_JWT_SECRET

1. 运行应用程序：

   mvn spring-boot:run

2.前端设置

1. 导航到前端目录：

   cd frontend

1. 安装依赖项：

   npm install

1. 配置 .env:

   VITE_API_URL=http://localhost:8080/api

1. 启动开发服务器：

   npm run dev

📖 用法

管理员

• 登录以访问管理员仪表板。
• 管理服务请求、创建项目，并使用AI助手分析所有项目。
• 通过“消息”选项卡与客户端通信。

客户端

• 登录查看“我的项目”和“我的请求”。
• 提交新的服务请求。
• 使用AI助手分析您的特定项目。
• 向管理团队发送消息。

🤝 贡献

1. 分叉存储库。
2. 创建要素分支(git checkout -b feature/AmazingFeature).
3. 提交您的更改(git commit -m 'Add some AmazingFeature').
4. 推到分支(git push origin feature/AmazingFeature).
5. 打开拉取请求。

📄 许可证

根据MIT许可证分发。看 LICENSE 了解更多信息。