Files
Obsidian/Geomative/Fumamx项目阶段性文档.md
T
2026-07-21 14:53:24 +08:00

157 lines
4.3 KiB
Markdown

我已经仔细阅读了这两个项目。让我为你总结一下:
📁 fumamxCLI - 孚盟MX 贸易数据 CLI 工具
类型: Python 命令行工具
技术栈: Python 3.11+, Click, Rich, Requests, Playwright
核心功能
公司搜索 - 搜索全球贸易企业
进口数据分析 - 获取进口企业数据、统计
出口数据分析 - 获取出口企业数据、统计
产品分析 - HS 编码分析、产品聚合、对比分析
国家分析 - 贸易来源国家、出口国家分析
贸易记录 - 查询完整贸易详情
企业详情 - 公司信息、联系人、电话
项目结构
fumamxCLI/
├── fumamx # 可执行入口
├── src/
│ ├── cli.py # 命令行接口 (21+ 命令)
│ ├── client.py # API 客户端
│ ├── config.py # 认证配置
│ ├── auth.py # 自动登录/Token 刷新
│ └── dynamic_api.py # 动态 API 调用
├── scripts/
│ ├── capture_api.js # 浏览器抓取脚本
│ └── setup_apis.py # API 代码生成器
└── fumamx_apis.json # 抓取的 API 数据
认证方式
使用浏览器 Cookie + Token
支持 Playwright 自动登录刷新
---
Token
Token 缓存机制
📁 fumamxCRM - 客户关系管理系统
类型: Web 应用 (FastAPI + React)
技术栈:
后端: FastAPI, SQLAlchemy, SQLite
前端: React, Vite, Tailwind CSS
端口: 后端 10001, 前端 10000
核心功能
客户管理
本地客户存储
潜在客户导入(从 fumamxCLI 数据源)
联系人管理
数据发现
关键词搜索企业
分页导入潜在客户
后台异步导入任务
深度分析
AI 驱动的企业商业画布分析
生成 Markdown 分析报告
支持多种大模型
系统设置
Cookie/Token 管理
系统状态监控
数据库模型
表名 说明
users 管理员用户
customers 本地客户
countries 国家信息
import_tasks 导入任务
potential_customers 潜在客户
potential_contacts 潜在客户联系人
deep_analyses 深度分析记录
system_settings 系统设置
项目结构
```
fumamxCRM/
├── backend/
│ ├── app.py # FastAPI 主应用
│ ├── models.py # SQLAlchemy 模型
│ ├── schemas.py # Pydantic 模型
│ ├── database.py # 数据库配置
│ ├── auth.py # 认证逻辑
│ ├── import_service.py # 导入服务
│ ├── fumamx_cli.py # CLI 包装器
│ └── routers/
│ ├── auth.py
│ ├── customers.py
│ ├── discover.py
│ ├── import_tasks.py
│ ├── potential_customers.py
│ ├── deep_analysis.py
│ └── settings
.py
└── frontend/
├── src/
│ ├── App.jsx
│ ├── api.js
│ ├── components/
│ └── pages/
└── node_modules/
🔗 两个项目的关系
fumamxCLI (数据获取层)
↓
fumamxCRM/backend/fumamx_cli.py (包装器)
↓
fumamxCRM (数据管理层 + Web UI)
```
fumamxCLI 负责从孚盟MX平台抓取贸易数据
fumamxCRM 提供 Web 界面管理这些数据,支持批量导入、深度分析
蔡叔叔,我已经了解了这两个项目的全貌。需要我:
继续查看某个具体文件?
运行/测试某个功能?
开发新功能?
---
搞定了!现在 fumamxCRM 也做成了 systemd 服务,**随系统启动自动运行**。
---
**创建的两个服务**
| 服务 | 端口 | 状态 |
|------|------|------|
| `fumamx-crm-backend.service` | 10001 | active (running) |
| `fumamx-crm-frontend.service` | 10000 | active (running) |
---
**常用命令**
```
# 查看状态
sudo systemctl status fumamx-crm-backend
sudo systemctl status fumamx-crm-frontend
# 重启
sudo systemctl restart fumamx-crm-backend
sudo systemctl restart fumamx-crm-frontend
# 停止
sudo systemctl stop fumamx-crm-backend
sudo systemctl stop fumamx-crm-frontend
# 查看日志
sudo journalctl -u fumamx-crm-backend -f
sudo journalctl -u fumamx-crm-frontend -f
```
---
**验证**
- 前端 `http://129.211.173.87:10000` → HTTP 200 ✓
- 后端 `http://129.211.173.87:10001/health` → `{"status":"healthy"}` ✓
现在服务器重启后,fumamxCRM 会自动启动,不需要再手动跑 `start.sh`。