AI Marketing Platform

🚀 人工智能营销平台——智能广告

基于人工智能的营销活动管理，支持多平台、智能内容生成和实时分析。

 

______________________________________________________________________

概述

SmartAds 是一个全面的数字营销平台，利用人工智能在Meta、谷歌、TikTok、领英和YouTube上创建、管理和优化付费广告活动。功能包括人工智能驱动的活动构建器向导、具有交互式图表的实时分析、智能内容生成、活动模板和完整的报告系统。

生产URL: marketing.agentprovision.com

______________________________________________________________________

✨ 主要特点

🎯 AI活动生成器

• 用于创建活动的对话式AI向导
• 从自然语言中智能提取数据
• 平台特定优化建议
• 预算分配建议
• 实时活动预览

📊 分析仪表板

• 与Recharts互动的图表
• ROI跟踪和转换指标
• A/B测试结果可视化
• 平台性能比较
• 可导出报告（JSON、CSV、PDF）

✍️ AI内容生成器

• 多格式生成（复制、图像、视频概念）
• 平台优化的提示和定位
• 基于模板的内容创建
• 高级受众和音调选项
• 发电历史跟踪

📋 活动模板

• 常见用例（电子商务、B2B、品牌知名度、本地业务、移动）的预构建模板
• 行业特定配置
• 预期绩效指标
• 难度级别和受欢迎程度评级

📈 报告API

• 性能概述、平台比较、A/B测试结果
• 创意表现和转化漏斗分析
• 多种导出格式

🔐 认证系统

• 基于JWT的身份验证，包括注册和登录
• 使用公司简介进行用户管理
• 基于角色的访问控制

______________________________________________________________________

🏗️ 建筑

┌──────────────────────────────────────────────────┐
│       Frontend (React + TypeScript + Vite)        │
│       Recharts · CSS Variables · Glassmorphism    │
├──────────────────────────────────────────────────┤
│  Landing │ Dashboard │ Campaigns │ Analytics      │
│  Content Generator │ Campaign Builder │ Templates │
│  Login │ Register                                 │
└──────────────────┬───────────────────────────────┘
                   │ Nginx reverse proxy (/api → backend)
┌──────────────────┴───────────────────────────────┐
│       Backend (Node.js + Express + TypeScript)     │
│       JWT Auth · PostgreSQL · REST API             │
├──────────────────────────────────────────────────┤
│  Auth │ Campaigns │ Analytics │ Content │ Reports  │
│  AI Campaign Builder                               │
└──────────┬───────────────────┬───────────────────┘
           │                   │
      ┌────┴─────┐       ┌───┴──────┐
      │PostgreSQL │       │  OpenAI  │
      │          │       │   API    │
      └──────────┘       └──────────┘

┌──────────────────────────────────────────────────┐
│       MCP Server (Model Context Protocol)         │
│       AI content services · Campaign tools        │
└──────────────────────────────────────────────────┘

Docker设置

• 前端Nginx提供内置的React应用程序，反向代理 /api → backend:3000
• 后端：Node.js/Express在端口3000上
• PostgreSQL：从初始化 database/init.sql 种子数据
• Helm图表：从Symlinked进入该空间的可重用微服务图表

______________________________________________________________________

🛠️ 技术栈

后端

前端

基础设施

______________________________________________________________________

🚀 快速开始

先决条件

• Node.js 18+
• Docker和Docker Compose（推荐）

Docker Compose（推荐）

git clone 
cd ai-marketing-platform

# Start all services (PostgreSQL auto-initializes with schema + seed data)
docker-compose up -d

# Services:
#   Frontend:  http://localhost:8080
#   Backend:   http://localhost:3000
#   PostgreSQL: localhost:5432

本地开发

# Backend
cd backend && npm install
cp .env.example .env    # Configure DATABASE_URL, JWT_SECRET, OPENAI_API_KEY
npm run dev             # → http://localhost:3000

# Frontend
cd frontend && npm install
cp .env.example .env    # Set VITE_API_URL=http://localhost:3000
npm run dev             # → http://localhost:5173

# MCP Server (optional)
cd mcp-server && npm install
npm run dev             # → http://localhost:3001

环境变量

后端（.env）

PORT=3000
NODE_ENV=development
DATABASE_URL=postgresql://user:pass@localhost:5432/marketing
JWT_SECRET=your-secret-key
OPENAI_API_KEY=your-openai-key

前端（.env）

VITE_API_URL=http://localhost:3000

______________________________________________________________________

📁 项目结构

ai-marketing-platform/
├── backend/
│   ├── src/
│   │   ├── routes/
│   │   │   ├── auth.ts              # JWT authentication
│   │   │   ├── campaigns.ts         # Campaign CRUD & management
│   │   │   ├── analytics.ts         # Metrics & performance data
│   │   │   ├── content.ts           # Content generation
│   │   │   ├── reports.ts           # Report generation & export
│   │   │   └── ai-campaign-builder.ts # AI wizard endpoint
│   │   ├── utils/                   # Storage, helpers
│   │   └── index.ts                 # Express server entry
│   ├── public/generated/            # AI-generated content storage
│   ├── Dockerfile
│   └── package.json
│
├── frontend/
│   ├── src/
│   │   ├── pages/
│   │   │   ├── LandingPage.tsx      # Marketing homepage
│   │   │   ├── Dashboard.tsx        # Main dashboard
│   │   │   ├── Campaigns.tsx        # Campaign management (list/grid)
│   │   │   ├── Analytics.tsx        # Interactive charts & metrics
│   │   │   ├── Content.tsx          # Content management
│   │   │   ├── Login.tsx            # Authentication
│   │   │   └── Register.tsx         # User registration
│   │   ├── components/
│   │   │   ├── AICampaignBuilder.tsx    # Conversational campaign wizard
│   │   │   ├── ContentGenerator.tsx     # Multi-format content creation
│   │   │   ├── CampaignTemplates.tsx    # Template selector
│   │   │   └── CampaignCreator.tsx      # Campaign creation form
│   │   ├── context/                 # React context providers
│   │   └── App.tsx
│   ├── Dockerfile
│   └── package.json
│
├── mcp-server/                      # Model Context Protocol server
│   ├── src/
│   │   ├── services/                # AI content, analytics, campaigns
│   │   └── index.ts                 # MCP entry point
│   └── package.json
│
├── database/
│   └── init.sql                     # Schema + seed data (users, campaigns, metrics)
│
├── helm/
│   ├── charts/microservice/         # Reusable Helm chart (symlink from intothespace)
│   └── values/
│       ├── marketing-backend.yaml
│       └── marketing-frontend.yaml
│
├── docker-compose.yml
├── deploy.sh
└── Makefile

______________________________________________________________________

🔌 API终点

认证

POST /api/auth/register          # Create account
POST /api/auth/login             # Get JWT tokens
GET  /api/auth/me                # Current user

活动

GET    /api/campaigns            # List campaigns (filterable by platform, status)
POST   /api/campaigns            # Create campaign
PUT    /api/campaigns/:id        # Update campaign
DELETE /api/campaigns/:id        # Delete campaign

分析

GET  /api/analytics/overview     # Aggregate metrics (spend, revenue, ROI, ROAS)
GET  /api/analytics/campaigns    # Per-campaign performance

内容与人工智能

POST /api/content/generate       # Generate copy, images, or video concepts
POST /api/ai-campaign-builder    # AI-powered campaign wizard

报告

POST /api/reports/performance    # Performance overview
POST /api/reports/platform       # Platform comparison
POST /api/reports/ab-test        # A/B test results
POST /api/reports/creative       # Creative performance
POST /api/reports/funnel         # Conversion funnel

______________________________________________________________________

🎨 设计系统

基于Glassmorphism的黑暗主题：

--primary: #6366f1;
--bg-primary: #0a0e27;
--bg-secondary: #111525;
--text-primary: #ffffff;
--text-secondary: #94a3b8;

玻璃效果卡片 backdrop-filter: blur(10px) 以及微妙的边界。

______________________________________________________________________

🗄️ 数据库模式

PostgreSQL具有以下核心表：

• 用户 --带有电子邮件、密码哈希、公司、角色的帐户
• 活动 --活动定义，包括平台、目标、预算、目标（JSONB）
• ad_创意 --与活动链接的生成内容（图像、视频、副本）
• campaign_metrics --每日绩效数据（印象、点击、转化、支出）
• 内容生成 --人工智能生成历史和元数据

架构从以下位置自动初始化 database/init.sql 在Docker Compose首次启动时。

______________________________________________________________________

🌐 部署

生产（GKE自动驾驶仪）

住在 marketing.agentprovision.com

# Build and push images
docker buildx build --platform linux/amd64 \
  -t gcr.io/PROJECT/marketing-frontend:latest --push frontend/

docker buildx build --platform linux/amd64 \
  -t gcr.io/PROJECT/marketing-backend:latest --push backend/

# Deploy with Helm
helm upgrade --install marketing-frontend ./helm/charts/microservice \
  -f ./helm/values/marketing-frontend.yaml -n prod

helm upgrade --install marketing-backend ./helm/charts/microservice \
  -f ./helm/values/marketing-backend.yaml -n prod

Docker生产

docker-compose up -d --build
# Nginx frontend on :8080, API on :3000, PostgreSQL on :5432

______________________________________________________________________

📋 近期亮点

• PostgreSQL迁移 --使用适当的模式、种子数据和迁移从基于文件的JSON存储迁移到PostgreSQL
• JWT认证系统 --具有受保护路由的完整注册/登录流程
• 活动生成器向导 --人工智能驱动的对话界面，用于创建活动
• 分析仪表板 --基于交互式Recharts的图表，具有ROI、ROAS、A/B测试
• 内容生成器增强 --平台优化提示、受众定位、语气选择
• 活动模板 --电子商务、B2B、品牌知名度、本地业务、移动端的预构建模板
• 报告API --具有5种报告类型的多格式导出（JSON、CSV、PDF）
• GKE部署 --使用Helm charts和PostgreSQL进行完整的Kubernetes部署

______________________________________________________________________

🤝 贡献

1. 创建特征分支(git checkout -b feature/new-feature)
2. 用常规承诺进行承诺(feat:, fix:, docs:)
3. 推送并打开拉取请求

______________________________________________________________________

📄 许可证

MIT许可证——见 许可证

______________________________________________________________________

采用人工智能构建，实现更智能的营销 🎯