# AI Operations Platform

**Repository Path**: Mindev/ai-operations-platform

## Basic Information

- **Project Name**: AI Operations Platform
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-08-12
- **Last Updated**: 2026-08-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 🚀 社交裂变增长工具

Next.js 15 全栈应用 — AI 驱动的裂变活动配置 + H5 海报分享 + 埋点分析。

**技术栈：** Next.js 15 App Router + TypeScript + Prisma/SQLite + Sharp 海报合成 + OpenAI 兼容 AI + Tailwind CSS

---

## 快速开始

### 1. 环境要求

- Node.js ≥ 20 LTS
- npm

### 2. 配置环境变量

```bash
cp .env.example .env
# 编辑 .env，至少填入:
#   ADMIN_USERNAME / ADMIN_PASSWORD  (运营登录)
#   SESSION_SECRET                  (32位随机串)
#   AI_BASE_URL / AI_API_KEY / AI_MODEL  (可选，不填则AI功能不可用)
```

### 3. 安装依赖 + 初始化数据库

```bash
npm install
npx prisma db push          # 创建 SQLite 表结构
npx tsx prisma/seed.ts       # 写入种子数据
```

### 4. 启动开发服务器

```bash
npm run dev
# 打开 http://localhost:3000
```

---

## 路由一览

| 路由 | 角色 | 说明 |
|------|------|------|
| `/admin/login` | 运营 | 登录 |
| `/admin/campaigns` | 运营 | 活动列表 |
| `/admin/campaigns/new` | 运营 | 新建活动（含AI参考） |
| `/admin/campaigns/[id]/edit` | 运营 | 编辑活动 |
| `/admin/campaigns/[id]` | 运营 | 详情 + 三指标看板 |
| `/h5/c/[id]` | 用户 | H5 落地分享页 |
| `/r/[shareCode]` | 用户 | 短链跳转 |

---

## API 接口

### Auth
| Method | Path | 说明 |
|--------|------|------|
| POST | `/api/auth/login` | 登录 |
| POST | `/api/auth/logout` | 退出 |
| GET | `/api/auth/me` | 当前用户 |

### Campaigns
| Method | Path | 说明 |
|--------|------|------|
| GET | `/api/campaigns` | 列表（`?status=`） |
| POST | `/api/campaigns` | 创建草稿 |
| GET | `/api/campaigns/:id` | 详情+统计 |
| PATCH | `/api/campaigns/:id` | 更新字段 |
| POST | `/api/campaigns/:id/publish` | 发布 |
| POST | `/api/campaigns/:id/archive` | 下架 |
| GET | `/api/public/campaigns/:id` | H5公开只读 |

### Share / Events / AI
| Method | Path | 说明 |
|--------|------|------|
| POST | `/api/share` | 生成分享海报 |
| POST | `/api/events` | 记录埋点 |
| POST | `/api/ai/analyze-campaigns` | AI分析+填表 |
| POST | `/api/ai/share-copy` | AI优化分享文案 |
| POST | `/api/uploads` | 图片上传 |

---

## 部署到生产

```bash
npm run build
npm start         # 或 pm2 start npm -- start
```

上传文件备份：`uploads/` 目录 + `prisma/dev.db`。

---

## 宿主 App 嵌入

```text
WebView URL =
  {BASE}/h5/c/{campaignId}
  ?uid={可选_宿主用户ID}
  &s={可选_从短链带入的shareCode}
```

---

## 项目结构

```
src/
├── app/
│   ├── admin/            # 运营后台页面
│   ├── h5/               # H5 分享页
│   ├── r/                # 短链跳转
│   └── api/              # API 路由
├── lib/
│   ├── auth.ts           # Session 鉴权
│   ├── prisma.ts         # DB 单例
│   ├── poster.ts         # Sharp 海报合成
│   ├── ai.ts             # OpenAI 客户端 + Zod
│   ├── tracking.ts       # 埋点写入 + 去重统计
│   └── storage.ts        # 图片上传
prisma/
├── schema.prisma         # 数据模型
└── seed.ts               # 种子数据
uploads/                  # 本地上传 & 海报输出
```