# 外网服务器推送打卡提醒和汇报 **Repository Path**: dangcafe/computer-2 ## Basic Information - **Project Name**: 外网服务器推送打卡提醒和汇报 - **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-09-16 - **Last Updated**: 2026-09-16 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # 企业微信邮件提醒与汇报服务 面向 Windows 服务器的邮件自动转发服务:定时读取业务邮箱,将未打卡名单转换为企业微信 `@` 提醒,将每日汇报文字及原始 XLSX 附件发送至配置的群机器人。 本仓库保存 **2026-09-16 从服务器提取的现行源码、脱敏配置示例、维护工具和离线验证材料**。快照含 **11 个独立服务:6 个提醒、5 个汇报**,包含业支数据库最新的标题适配、人员排除和部分名单提醒修改。 > 这是公开的源码恢复备份。真实邮箱授权码、机器人 key、人员名单、排除人员姓名及运行去重状态不进入仓库;完整恢复还需要管理员私下保存的配置与状态。不要将仓库直接覆盖到正在运行的服务器目录。 ## 功能一览 | 能力 | 实际行为 | | --- | --- | | 邮件筛选 | 根据发件人、标题规则与分钟级收件时间窗口筛选;读取 INBOX | | 未打卡提醒 | 从正文或受支持的 XLSX 姓名列提取名单,使用本项目映射生成 `@` | | 内外人员分流 | 根据本项目内部人员名单与群配置分流;不是按邮件标题自动决定群 | | 每日汇报 | 发送文字及原始 XLSX;支持多邮箱汇报专用实例 | | 防重复处理 | 每个项目保留独立 UID;汇报另记录文字、文件投递阶段 | | 单项目维护 | 人工修改配置后,双击该目录“修改配置后重启.bat” | | 新项目接入 | 菜单生成干净项目、增量登记计划任务并启动 | | 运行守护 | 中央 Watchdog 定期检查精确进程与状态文件,按恢复预算重启异常服务 | 服务进程正常、接口接收成功、群内实际收到,是三个不同层次的证据。状态显示 `Running` 并不能证明每封邮件都匹配或已送达。 ## 工作过程 ```text 业务邮箱 INBOX ↓ 定时轮询、时间窗口、发件人和标题筛选 ├─ 提醒实例 → 提取姓名 → 本项目人员映射/排除 → 企业微信 @ 提醒 └─ 汇报实例 → 正文及 XLSX → 企业微信文字/文件消息 ↓ 本项目 UID / 投递状态持久化 Windows 计划任务 → 独立 Python 进程 中央 Watchdog → 检查进程、心跳 → 有界自动恢复 ``` ## 仓库结构 ```text server/ # 对应服务器业务根目录的源码快照 ├─ 项目维护.bat # 日常维护入口 ├─ Project-Maintenance.ps1 ├─ Reload-Config-And-Restart.ps1 ├─ 检测服务/ # 调度、启停、Watchdog、11 项服务清单 ├─ 维护工具/ # 项目创建逻辑与干净模板 ├─ 提醒打卡推送/ # 六个提醒实例及各自 .env.example └─ 每日打卡汇报/ # 五个汇报实例,含多邮箱专用代码 docs/ ├─ 恢复与配置.md # 新服务器恢复、私密资料与配置说明 └─ 排查与维护.md # 日常操作及邮件未发送排查 tests/ # 只使用合成邮件/模拟接口的离线测试 tools/ # 源码、配置、哈希和 PowerShell 语法检查 backup/source-manifest.json # 来源、抓取时间及逐文件 SHA-256 backup/verification.json # 本次本地验证结果与范围 ``` ## 服务范围 | 项目 | 提醒 | 汇报 | 特点 | | --- | --- | --- | --- | | NGBOSS | ✓ | ✓ | 独立配置与状态 | | 多域 | ✓ | ✓ | 提醒支持内部/异地人员分流 | | 服务台 | ✓ | ✓ | 汇报使用 `multi_report_forwarder.py` 与 `mailboxes.json` | | 上云支撑 | ✓ | ✓ | 提醒保留 XLSX 解析和邮件读取兼容模块 | | IT 云支撑 | ✓ | ✓ | 独立服务,纳入中央守护 | | 业支数据库 | ✓ | — | 支持部分匹配先提醒及配置排除姓名 | 准确服务名、计划任务名和相对路径见 [services.json](server/检测服务/services.json)。旧 `yezhi项目组` 已退出登记,不纳入本次备份。 ## 日常使用 ### 修改已有项目 1. 在服务器目标项目目录编辑 `.env`;人员配置按需编辑 `member_mapping.json` 和 `内部人员名单.json`。 2. 保存为 UTF-8,双击同目录 **修改配置后重启.bat**。 3. 确认重启成功、新进程与持续心跳,再核对下一封自然邮件的处理日志。 该入口只操作当前项目。不要删除 UID 文件来测试,也不要通过全量安装脚本完成日常重启。 ### 新增项目 1. 打开服务器根目录 **项目维护.bat**,选择生成项目。 2. 填写生成目录的邮箱、机器人与人员配置。 3. 双击新目录 **修改配置后重启.bat**,首次自动增量登记并启动;也可使用菜单中的登记启动选项。 标准提醒模板与业支、上云的 XLSX 专用实现存在差异;需要 XLSX 名单时,按 [恢复与配置](docs/恢复与配置.md) 保留配套模块,不能只复制主脚本。 ## 业支数据库当前规则 | 配置/策略 | 值或行为 | | --- | --- | | `SUBJECT_KEYWORDS` | `未打卡,打卡未处理人员名单,外部人员打卡未处理名单` | | `LOOKBACK_MINUTES` | `10` | | `POLL_INTERVAL_SECONDS` | `30` | | `REMINDER_NAME_SOURCE` | `xlsx` | | `REMINDER_EXCLUDED_NAMES` | 英文逗号分隔;真实名单由管理员私下恢复,公开示例为空 | | 缺少 userid | 先提醒已匹配人员;未匹配人员暂不提醒 | | 全部未匹配 | 不发送,不冒充成功 | | 已处理邮件 | 后续补齐映射也不会自动重发 | 关键词按“包含任一片段”匹配,发件人白名单仍同时生效。不同项目沿用各自业务策略,业支的部分匹配策略没有批量应用到其他服务。 ## 恢复与验证 部署基线为 **Windows、Windows PowerShell 5.1、Python 3.11**。现有 Python 程序使用标准库,XLSX 名单通过 ZIP/XML 解析,不需要为了运行这些脚本安装 pandas 或 Office。 恢复前先读 [恢复与配置](docs/恢复与配置.md)。仓库中的 Python 路径统一替换为 `C:\Python311\python.exe`,需改为目标机器的真实位置;现有安装脚本要求业务根目录为 `E:\合作社打卡企业微信推送`。 本地只读检查(不登录邮箱、不发送企微、不登记计划任务): ```powershell python -B tools/verify_backup.py python -B -m unittest discover -s tests -v powershell -NoProfile -File tools/Test-PowerShellSyntax.ps1 ``` 本次备份的检查结果见 [验证记录](backup/verification.json)。测试范围是离线解析、筛选、业支名单处理及静态完整性;不等同于整套生产系统的新服务器恢复演练或真实群送达验收。 ## 备份边界 - **已保存**:正式业务脚本、维护与守护脚本、项目结构、脱敏示例、服务登记快照、文件哈希。 - **须私密另存**:实际 `.env`、人员映射/排除名单、多邮箱凭据、`processed_uids.json`、`delivery_state.json`、实际任务导出及需要的历史日志。 - **不在本仓库范围**:企业微信自动拨打电话系统、其他服务器业务、旧交接文档和历史修复压缩包。 源码文件保持抓取时的原始字节;脱敏配置以清单的 `kind` 字段明确标识。不要把配置示例当作可直接连接生产系统的真实配置。