电商分析API

基于NestJS构建的综合性电商分析API,提供模拟数据生成、客户行为分析、AI驱动的数据分析和预测功能。

  • by MietoProgramming
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 MietoProgramming/mcp-with-api

使用说明

A progressive Node.js framework for building efficient and scalable server-side applications.

描述

MCP with API - 一个基于NestJS构建的全面电子商务分析API,其特点包括:

  • 模拟数据生成500种产品,100名消费者,10,000份订单
  • 分析与预测RFM分析、客户行为评分、再订购预测
  • 基于人工智能的分析使用AI生成用于数据分析的Python Jupyter笔记本
  • MCP 服务器人工智能助手的模型上下文协议集成
  • **RESTful API(Representational State Transfer(表述性状态转移)应用程序编程接口)**完整的CRUD操作和高级过滤功能

✨ 新功能:AI驱动的数据分析

生成带有AI驱动数据分析代码的Python Jupyter笔记本!

快速入门:

# 1. Install dependencies
yarn install

# 2. Setup environment variables
copy .env.example .env
# Edit .env and add your OpenRouter API key

# 3. Start the server
yarn start:dev

# 4. Generate analysis
curl -X POST http://localhost:3000/api/ai-analysis/generate -H "Content-Type: application/json" -d "{\"analysisType\": \"consumers\", \"description\": \"Analyze consumer spending patterns\"}"

📚 书籍 完整文档见 AI_ANALYSIS_QUICKSTART.md 并且 AI_ANALYSIS_DOCUMENTATION.md

项目设置

# 1. Install dependencies
$ yarn install

# 2. Setup environment (copy and edit .env file)
$ copy .env.example .env
# Add your OPENROUTER_API_KEY to the .env file

📖 书籍 环境设置指南见 ENVIRONMENT_SETUP.md 用于详细配置

编译并运行项目

# development
$ yarn run start

# watch mode
$ yarn run start:dev

# production mode
$ yarn run start:prod

运行测试

# unit tests
$ yarn run test

# e2e tests
$ yarn run test:e2e

# test coverage
$ yarn run test:cov

部署

当你准备将你的NestJS应用程序部署到生产环境时,有一些关键步骤可以确保它尽可能高效地运行。请查看以下内容: 部署文档 如需更多信息。

如果您正在寻找一个基于云的平台来部署您的NestJS应用程序,请查看 毛(Mau,人名或特定名称,根据上下文可能有所不同)我们的官方平台,用于在AWS上部署NestJS应用程序。Mau让部署变得简单快捷,只需几个简单步骤:

$ yarn install -g @nestjs/mau
$ mau deploy

使用Mau,您只需点击几下即可部署您的应用程序,从而让您能够专注于构建功能,而不是管理基础设施。

📡 API 端点

AI分析(新增!)

  • POST /ai-analysis/generate - 生成AI驱动的分析笔记本
  • GET /ai-analysis/files - 列出生成的文件
  • GET /ai-analysis/examples - 获取示例请求

分析与预测

  • GET /analytics/consumer-behavior/:id - 获取消费者行为分析
  • GET /analytics/predictions/all - 获取所有重订货预测
  • GET /analytics/predictions/summary - 获取预测摘要
  • GET /analytics/high-value-reorder-candidates - 获取高价值客户
  • GET /analytics/churn-risk-consumers - 获取处于风险中的客户

消费者

  • GET /consumers - 获取所有消费者
  • GET /consumers/:id - 通过ID获取消费者
  • GET /consumers/top/:limit - 获取消费最高的顾客
  • GET /consumers/:id/statistics - 获取消费者统计数据
  • GET /consumers/:id/orders - 获取消费者的订单

订单

  • GET /orders - 获取所有订单
  • GET /orders/:id - 按ID获取订单
  • GET /orders/status/:status - 按状态筛选
  • GET /orders/statistics - 获取订单统计信息

产品

  • GET /products - 获取所有产品
  • GET /products/:id - 通过ID获取产品
  • GET /products/category/:category - 按类别筛选

📚 文档

资源

以下是一些在使用 NestJS 时可能会派上用场的资源:

支持

Nest是一个采用麻省理工学院(MIT)许可证的开源项目。它在赞助商和杰出支持者的帮助下不断发展壮大。如果您也想加入他们,请 在此阅读更多内容。

比分咬的很紧

许可证

Nest 是 麻省理工学院授权。