Smart Email

智能电子邮件

使用Next.js构建的现代电子邮件管理应用程序，利用人工智能功能帮助您更有效地组织、总结和管理电子邮件。

🚀 概述

Smart Email是一个与Gmail集成的智能电子邮件管理系统，提供基于AI的分类、摘要和智能回复建议。采用现代网络技术构建，专为提高生产力而设计。

🛠️ 技术栈

• 框架： Next.js 16（应用路由器）与服务器操作
• 数据库： PostgreSQL与Prisma ORM
• 语言： TypeScript
• 身份验证： Google OAuth2（Gmail API）
• 数据获取： TanStack查询（React查询）
• 造型： Tailwind CSS

✨ 特性

版本1（当前）

1. 谷歌登录 -使用Google OAuth2进行安全身份验证
2. 异步电子邮件 -高效的电子邮件获取和管理
3. 电子邮件分类 -使用MCP的人工智能电子邮件分类
4. 电子邮件摘要 -使用MCP的自动电子邮件摘要
5. 单选项卡回放（AI建议） -使用MCP的智能回复建议

版本2（计划中）

1. 实时收件箱更新 -使用Pub/Sub实时更新电子邮件
2. 自动会议检测 -自动检测会议并添加到日历（MCP）
3. 自动回复铃声 -可定制的回复音调（友好、专业、简短、自定义预设）

📋 先决条件

在开始之前，请确保已安装以下内容：

• Node.js 20+和npm/yarn/pnpm
• PostgreSQL数据库
• 启用Gmail API的谷歌云项目
• Google OAuth2凭据

🚀 入门指南

1.克隆存储库

git clone 
cd smart-email

2.安装依赖项

npm install
# or
yarn install
# or
pnpm install

3.设置环境变量

创建 .env.local 根目录中的文件：

# Database
DATABASE_URL="postgresql://user:password@localhost:5432/smart_email"

# Google OAuth2
GOOGLE_CLIENT_ID="your-google-client-id"
GOOGLE_CLIENT_SECRET="your-google-client-secret"
GOOGLE_REDIRECT_URI="http://localhost:3000/api/auth/callback/google"

# Next.js
NEXTAUTH_URL="http://localhost:3000"
NEXTAUTH_SECRET="your-nextauth-secret"

# MCP Configuration (if applicable)
MCP_API_KEY="your-mcp-api-key"

4.建立数据库

# Generate Prisma client
npx prisma generate

# Run migrations
npx prisma migrate dev

# (Optional) Seed the database
npx prisma db seed

5.运行开发服务器

npm run dev
# or
yarn dev
# or
pnpm dev

打开 http://localhost:3000 在浏览器中查看应用程序。

📁 项目结构

smart-email/
├── app/                    # Next.js App Router
│   ├── layout.tsx         # Root layout
│   ├── page.tsx           # Home page
│   └── globals.css        # Global styles
├── prisma/               # Prisma schema and migrations
├── public/                # Static assets
├── .env.local            # Environment variables (not committed)
└── package.json          # Dependencies

🔧 可用脚本

• npm run dev -启动开发服务器
• npm run build -为生产而建
• npm run start -启动生产服务器
• npm run lint -运行ESLint

🔐 Google OAuth设置

1. 首选 谷歌云控制台
2. 创建新项目或选择现有项目
3. 启用Gmail API
4. 创建OAuth 2.0凭据
5. 添加授权重定向URI
6. 将客户端ID和客户端密码复制到您的 .env.local 文件

📝 数据库模式

该项目使用Prisma进行数据库管理。架构在中定义 prisma/schema.prisma。运行迁移以设置数据库结构。

🤝 贡献

欢迎投稿！请随时提交拉取请求。

📄 许可证

这个项目是私有的。

🗺️ 路线图

• \[x\] 版本1：核心功能（谷歌登录、电子邮件获取、分类、摘要、人工智能建议）
• \[\]版本2：实时更新、会议检测、自动回复铃声

______________________________________________________________________