智能助手
澳大利亚贸易企业的人工智能行政助理。一个具有MCP（模型上下文协议）代理集成的单屏幕聊天界面，用于Gmail、日历和文档处理。
开发人员设置指南
此设置指南使任何开发人员都可以克隆仓库，并从当前的第一阶段状态恢复开发。
先决条件
- Node.js 18+
- Docker&Docker编写
- VS代码（推荐）
快速设置
- 克隆存储库：
git clone
cd intelligent-admin- 安装依赖项：
npm install
cd frontend && npm install
cd ../backend && npm install- 配置环境变量：
# Copy environment template
cp frontend/.env.example frontend/.env- 设置身份验证服务：
a） Kinde身份验证设置：
- 首选 Kinde.com 并创建帐户 - 创建新项目：“智能助理” - 增添 frontend/.env:
VITE_KINDE_CLIENT_ID=your-kinde-client-id
VITE_KINDE_DOMAIN=https://yourdomain.kinde.com
VITE_KINDE_REDIRECT_URI=http://localhost:5173
VITE_KINDE_LOGOUT_URI=http://localhost:5173b） Firebase+Gmail API设置：
- 首选 Firebase控制台 - 创建项目：“智能管理员” - 在Google云控制台中启用Gmail API - 为web应用程序创建OAuth 2.0凭据 - 添加授权来源： http://localhost:5173 - 增添 frontend/.env:
VITE_FIREBASE_API_KEY=your-firebase-api-key
VITE_FIREBASE_PROJECT_ID=your-project-id
VITE_FIREBASE_APP_ID=your-app-id
VITE_FIREBASE_MESSAGING_SENDER_ID=your-sender-id
VITE_GOOGLE_CLIENT_ID=your-google-oauth-client-id- 启动开发服务器：
# Terminal 1: Backend
cd backend && npm run dev
# Terminal 2: Frontend
cd frontend && npm run dev- 验证设置：
- 打开http://localhost:5173 - 转到“开发设置”选项卡 - 所有检查应显示绿色✅ - 测试聊天界面中的Gmail集成
接入点
- 前端: http://localhost:5173
- 后端API: http://localhost:3000
- 开发设置: http://localhost:5173（设置选项卡）
开发工作流程
VS代码扩展
工作区将提示您安装推荐的扩展，包括：
- GitHub Copilot&Copilot聊天
- TypeScript、ESLint、Prettier
- Prisma、Docker、GitLens
AI助手说明
- 副驾驶说明:
.github/COPILOT_INSTRUCTIONS.md - 发展背景:
.ai/development-context.md
关键命令
npm run dev # Start both frontend and backend
npm run test # Run all tests
npm run lint # Run linting
npm run type-check # Run TypeScript checks
npm run build # Build for production建筑
简化堆栈
- 前端：React+TypeScript+顺风CSS
- 后端：Express.js+Prisma ORM+PostgreSQL
- 人工智能：OpenAI API集成
- 实时：服务器发送的事件
- MCP代理：Gmail、日历、文档处理
项目结构
├── frontend/ # React single-page application
├── backend/ # Express.js API server
├── shared/ # Shared types and utilities
├── docs/ # Documentation
├── .vscode/ # VS Code configuration
└── scripts/ # Development scripts当前阶段：1B阶段-电子邮件智能（进行中）
已完成（1A期-基础）
- ✅ 使用monorepo设置项目结构
- ✅ VS代码配置和工作区
- ✅ Package.json和依赖项
- ✅ 基本React聊天界面
- ✅ 带路由的Express.js服务器
- ✅ 身份验证（Kinde+GoogleOAuth混合）
- ✅ Gmail API与现代谷歌身份服务的集成
- ✅ 基于人工智能分类的电子邮件分析引擎
- ✅ 利用商业洞察力生成晨报摘要
当前开发（1B期）
- ✅ Gmail OAuth集成端到端工作
- ✅ 已构建电子邮件提取和分析服务
- ✅ 清理UI以专注于核心功能
- 🔄 构建电子邮件智能UI组件
- 🔄 用于电子邮件设置的用户首选项存储
后续步骤
- 构建电子邮件智能仪表板UI
- 创建早报查看器组件
- 添加电子邮件分类界面
- 实现电子邮件分析的用户首选项
业务环境
目标市场：拥有1-50名员工的澳大利亚贸易企业（管道、电气、暖通空调） 问题：管理负担阻碍了扩展（每年在管理任务上浪费560亿澳元） 解决方案：AI聊天界面取代5-8个独立的业务应用程序
开发指南
代码的风格
- TypeScript严格模式
- ESLint+更精细的执法
- 带有钩子的React功能组件
- 使用自定义错误类进行正确的错误处理
MCP代理模式
interface MCPAgent {
name: string;
capabilities: string[];
execute(task: AgentTask): Promise;
healthCheck(): Promise;
}测试
- 所有服务的单元测试
- React组件的组件测试
- MCP代理的集成测试
- 临界流量的E2E测试
故障排除
常见问题
- 端口冲突：检查端口3000、5173是否可用
- 数据库问题：运行
npm run db:reset后端/ - Docker问题：运行
docker-compose down -v && docker-compose up -d
获取帮助
- 检查VS代码问题面板中的Types/ESLint问题
- 使用Copilot Chat获取编码帮助
- 审查
.ai/development-context.md用于项目背景
环境变量引用
发展所需
# Kinde Authentication
VITE_KINDE_CLIENT_ID=your-kinde-client-id
VITE_KINDE_DOMAIN=https://yourdomain.kinde.com
VITE_KINDE_REDIRECT_URI=http://localhost:5173
VITE_KINDE_LOGOUT_URI=http://localhost:5173
# Firebase Configuration
VITE_FIREBASE_API_KEY=your-firebase-api-key
VITE_FIREBASE_PROJECT_ID=your-project-id
VITE_FIREBASE_APP_ID=your-app-id
VITE_FIREBASE_MESSAGING_SENDER_ID=your-sender-id
VITE_FIREBASE_VAPID_KEY=your-vapid-key
# Google OAuth for Gmail API
VITE_GOOGLE_CLIENT_ID=your-google-oauth-client-id
# API Configuration
VITE_API_BASE_URL=http://localhost:3000
VITE_WEBSOCKET_URL=ws://localhost:3000可选配置
# Feature Flags
VITE_ENABLE_DEBUG=true
VITE_ENABLE_MOCK_API=false
# UI Configuration
VITE_DEFAULT_THEME=light
VITE_ENABLE_DARK_MODE=true______________________________________________________________________
内置于❤️ 澳大利亚贸易企业