🎉 加盟商状态自动同步系统 - 部署完成

✅ 已完成的工作

1. 智能表格创建成功

表格名称: 加盟商项目管理智能表格
访问URL: https://doc.weixin.qq.com/smartsheet/s3_AA0A_3gpAJMCNd1OF6YsjSTi3l7zF_a?scode=AM4AkQcwAA4s9kfoyqAA0A_3gpAJM
文档ID: dcyeOLceOJqbuQpvY_EyivG5xx0cCPcT2x4kZ3UtkVJBhGqrD7wdc_iKB3za3vqq0foQifL-Y2npwGb1bl6Hb9EQ
2. 表格结构已配置

#### 加盟商状态表 (sheet_id: q979lj)

加盟商名称 (文本)
状态 (单选: 正常/签约后终止/再次签约)
签约日期 (日期时间)
联系人 (文本)
联系电话 (手机号)
备注 (文本)
#### 加盟商工期进度表 (sheet_id: MAqXdi)
加盟商名称 (文本)
项目阶段 (单选)
计划开始时间 (日期时间)
计划完成时间 (日期时间)
实际开始时间 (日期时间)
实际完成时间 (日期时间)
当前进度 (进度条)
负责人 (文本)
3. 系统Cron Job已配置

加盟商状态自动同步 - 每分钟执行一次
/1    * /usr/bin/python3 /root/.openclaw/agents/101/workspace/franchisee_cron.py >> /var/log/franchisee_sync.log 2>&1

4. 监控系统已就绪

日志文件: /var/log/franchisee_sync.log
状态跟踪: /tmp/franchisee_last_status.json
监控脚本: check_franchisee_status.sh
🔄 自动化规则
监控频率: 每分钟检查一次
触发条件1: 状态变为"签约后终止" → 自动删除工期进度表中的对应行
触发条件2: 状态变为"再次签约" → 自动重新添加工期进度表中的对应行
🚀 立即开始使用
步骤1: 访问智能表格

打开企业微信，访问: https://doc.weixin.qq.com/smartsheet/s3_AA0A_3gpAJMCNd1OF6YsjSTi3l7zF_a

步骤2: 添加测试数据

在"加盟商状态表"中添加:

加盟商名称: 测试加盟商A
状态: 正常
其他信息按需填写
步骤3: 测试自动化

1. 将状态改为"签约后终止" - ✅ 系统将自动从工期进度表中删除该加盟商的行 2. 将状态改为"再次签约" - ✅ 系统将自动在工期进度表中重新添加该加盟商的行

📊 系统监控

查看系统状态

运行监控脚本
bash /root/.openclaw/agents/101/workspace/check_franchisee_status.sh
查看实时日志
tail -f /var/log/franchisee_sync.log
查看Cron配置
crontab -l

手动测试

模拟状态变化测试
bash /root/.openclaw/agents/101/workspace/test_status_change.sh
手动执行同步
python3 /root/.openclaw/agents/101/workspace/franchisee_cron.py

⚙️ 配置文件

主要配置参数

CONFIG = {
    "docid": "dcyeOLceOJqbuQpvY_EyivG5xx0cCPcT2x4kZ3UtkVJBhGqrD7wdc_iKB3za3vqq0foQifL-Y2npwGb1bl6Hb9EQ",
    "status_sheet_id": "q979lj",
    "progress_sheet_id": "MAqXdi",
    "status_field": "状态",
    "franchisee_field": "加盟商名称",
    "terminated_status": "签约后终止",
    "renewed_status": "再次签约",
}

如需调整

1. 修改状态值: 编辑franchisee_cron.py中的terminated_status和renewed_status 2. 修改字段名: 如果表格字段名称不同，调整status_field和franchisee_field 3. 修改检查频率: 编辑crontab配置

🔧 维护指南

日常维护

1. 检查系统状态
bash check_franchisee_status.sh
2. 查看日志
tail -100 /var/log/franchisee_sync.log
3. 清理旧日志（保留7天）
find /var/log -name "franchisee_sync.log*" -mtime +7 -delete

故障排查

1. 检查Cron是否运行
systemctl status cron
2. 检查Python环境
python3 --version
3. 检查脚本权限
ls -la franchisee_cron.py
4. 手动测试
python3 franchisee_cron.py

📁 文件清单

工作区文件

/root/.openclaw/agents/101/workspace/
├── franchisee_cron.py              # Cron专用同步脚本（主脚本）
├── franchisee_sync.py              # 完整版同步脚本
├── franchisee_sync_simple.py       # 简化版测试脚本
├── franchisee_cron_task.sh         # Shell版本定时任务
├── check_franchisee_status.sh      # 系统监控脚本
├── test_status_change.sh           # 状态变化测试脚本
├── test_franchisee.py              # 配置信息显示脚本
├── 加盟商状态自动同步方案.md       # 完整方案文档
└── 部署完成总结.md                 # 本文件

系统文件

/var/log/franchisee_sync.log        # 系统日志文件
/tmp/franchisee_last_status.json    # 状态跟踪文件
/etc/cron.d/                        # Cron配置（通过crontab管理）

🆘 技术支持

常见问题

1. Cron未执行: 检查systemctl status cron服务状态 2. 权限问题: 确保脚本有执行权限 chmod +x *.py 3. 日志不更新: 检查磁盘空间 df -h 4. API调用失败: 检查网络连接和企业微信权限

联系支持

系统管理员: 检查服务器状态
开发人员: 修改脚本逻辑
企业微信管理员: 调整表格权限
🎯 下一步建议
短期优化

1. 添加邮件通知功能 2. 实现微信消息通知 3. 添加数据备份机制

长期规划

1. 扩展到其他业务表格 2. 实现可视化监控面板 3. 添加审计日志功能

部署时间: 2026-03-30 10:30 部署人员: OpenClaw Agent 101 系统状态: ✅ 正常运行中

📄 部署完成总结.md

🎉 加盟商状态自动同步系统 - 部署完成

✅ 已完成的工作

1. 智能表格创建成功

2. 表格结构已配置

3. 系统Cron Job已配置

加盟商状态自动同步 - 每分钟执行一次

4. 监控系统已就绪

🔄 自动化规则

🚀 立即开始使用

步骤1: 访问智能表格

步骤2: 添加测试数据

步骤3: 测试自动化

📊 系统监控

查看系统状态

运行监控脚本

查看实时日志

查看Cron配置

手动测试

模拟状态变化测试

手动执行同步

⚙️ 配置文件

主要配置参数

如需调整

🔧 维护指南

日常维护

1. 检查系统状态

2. 查看日志

3. 清理旧日志（保留7天）

故障排查

1. 检查Cron是否运行

2. 检查Python环境

3. 检查脚本权限

4. 手动测试