graph TD A[FastAPI Web服务] --> B[Celery任务调度] B --> C[Redis消息队列] B --> D[高德地图MCP] B --> E[钉钉MCP] F[Docker容器编排] --> A F --> B F --> C

# 1. 进入dumb模式目录 cd dumb_mode # 2. 安装最小依赖 pip install -r requirements.txt # 3. 编辑配置文件 # 打开 commute_assistant.py，填写你的API Key和坐标 # 4. 运行程序 python commute_assistant.py

# 1. 克隆项目 git clone <repository-url> cd mcp4coder # 2. 创建虚拟环境 python -m venv venv source venv/bin/activate # Linux/Mac # 或 venv\Scripts\activate # Windows # 3. 安装依赖 pip install -r requirements.txt # 4. 配置环境变量 cp .env.example .env # 编辑.env文件，填入必要的API密钥和配置 # 5. 启动服务 docker-compose up -d # 6. 验证服务状态 curl http://localhost:8000/health

# 启动开发服务器 python -m app.main # 运行测试 pytest tests/ -v # 代码质量检查 flake8 app/ black app/ mypy app/

mcp4coder/ ├── app/ # 核心应用代码（专业版） │ ├── __init__.py # 包初始化 │ ├── main.py # FastAPI应用入口 │ ├── config/ # 配置管理 │ │ ├── __init__.py │ │ ├── settings.py # 应用配置 │ │ └── validators.py # 配置验证器 │ ├── services/ # 业务服务层 │ │ ├── __init__.py │ │ └── commute_service.py # 通勤服务 │ ├── mcp/ # MCP协议实现 │ │ ├── __init__.py │ │ ├── amap_client.py # 高德地图客户端 │ │ └── dingtalk_client.py # 钉钉客户端 │ ├── workers/ # Celery工作进程 │ │ ├── __init__.py │ │ ├── celery_app.py # Celery配置 │ │ └── tasks.py # 任务定义 │ └── utils/ # 工具函数 │ ├── __init__.py │ ├── exceptions.py # 自定义异常 │ ├── logger.py # 日志系统 │ ├── logging_context.py # 日志上下文 │ ├── error_handler.py # 错误处理 │ └── helpers.py # 通用工具 ├── dumb_mode/ # 🎯 小白模式（推荐新手） │ ├── commute_assistant.py # 一体化主程序 │ ├── simple_amap.py # 简化高德API │ ├── simple_dingtalk.py # 简化钉钉通知 │ ├── requirements.txt # 最小依赖 │ ├── README_DUMB.md # 小白模式说明 │ └── config_example.txt # 配置示例 ├── tests/ # 测试代码 │ ├── test_config.py # 配置测试 │ ├── test_utils.py # 工具函数测试 │ └── test_integration.py # 集成测试 ├── docker/ # Docker配置 │ └── Dockerfile # 应用镜像 ├── docs/ # 项目文档 ├── logs/ # 日志目录 ├── requirements.txt # Python依赖 ├── docker-compose.yml # Docker编排 ├── pytest.ini # 测试配置 ├── .env.example # 环境变量示例 └── README.md # 项目说明

# ===== 应用配置 ===== APP_ENV=production DEBUG=False LOG_LEVEL=INFO # ===== 高德地图API配置 ===== AMAP_API_KEY=your_amap_api_key_here # 高德开放平台申请的Key AMAP_ORIGIN=116.481485,39.990464 # 出发地坐标(经度,纬度) AMAP_DESTINATION=116.481485,39.990464 # 目的地坐标(经度,纬度) AMAP_STRATEGY=0 # 0-速度优先,1-费用优先,2-距离优先 # ===== 钉钉机器人配置 ===== DINGTALK_WEBHOOK_URL=https://oapi.dingtalk.com/robot/send?access_token=xxx DINGTALK_SECRET=your_dingtalk_secret_here # 机器人加签密钥 DINGTALK_KEYWORD=通勤提醒 # 消息关键词 # ===== Redis配置 ===== REDIS_HOST=redis REDIS_PORT=6379 REDIS_DB=0 REDIS_PASSWORD= # ===== Celery配置 ===== CELERY_BROKER_URL=redis://redis:6379/1 CELERY_RESULT_BACKEND=redis://redis:6379/2 CELERY_TIMEZONE=Asia/Shanghai # ===== 定时任务配置 ===== COMMUTE_CHECK_CRON=0 30 8 * * * # 每天8:30执行

# 启动开发模式验证配置 python -c "from app.config.settings import settings; print('配置加载成功')"

# 运行所有测试 pytest tests/ -v # 运行特定测试 pytest tests/test_config.py -v # 生成覆盖率报告 pytest --cov=app --cov-report=html tests/ # 运行集成测试 pytest -m integration tests/

# 代码格式化 black app/ tests/ # 代码检查 flake8 app/ tests/ # 类型检查 mypy app/

# 启用详细日志 LOG_LEVEL=DEBUG # 开发模式启动 DEBUG=True # 查看Celery任务 celery -A app.workers.celery_app inspect active

# 构建生产镜像 docker-compose -f docker-compose.yml build # 启动生产服务 docker-compose up -d # 查看服务状态 docker-compose ps # 查看日志 docker-compose logs -f

# 查看应用日志 tail -f logs/mcp_commute_$(date +%Y-%m-%d).log # 查看错误日志 tail -f logs/error_$(date +%Y-%m-%d).log # 重启服务 docker-compose restart # 停止服务 docker-compose down