tom/fuc-new
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Record production announcement connection and server-side acceptance

Browse Source
This commit is contained in:
hellcat 2026-10-26 13:08:11 +08:00
parent 5ab97694d4
commit 4687242232
1 changed files with 4 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
docs/maintenance/ATOM_ANNOUNCEMENTS.md
View File

@ -1,6 +1,6 @@
# ATOM 公告接收适配器 # ATOM 公告接收适配器
2026-10-26本地实现与隔离联调完成，未部署/启用生产。ATOM界面、通用协议、双端操作与回滚唯一正文见[Ship公告专题](/Users/hellcat/Documents/GemCodes/atom/codex/output/docs/ship-announcements.md)。此处只维护FUC接收端配置与业务影响。 2026-10-26用户批准后已Git上线并启用production/fuc/default，完成服务器侧只读验收。ATOM界面、通用协议、双端操作与回滚唯一正文见[Ship公告专题](/Users/hellcat/Documents/GemCodes/atom/codex/output/docs/ship-announcements.md)。此处只维护FUC接收端配置与业务影响。
`app/routes.php` 注册 POST `/api/atom/v1/announcements` → `Controllers/Api/Atom/AnnouncementController` → `Services/Atom/AnnouncementBridge`。使用独立HMAC、nonce、精确project/environment/instance，不沿用旧Nasa API或管理员会话；默认关闭。公告保留在原`announcement`表，支持list/get/create/update，status=0撤下，不物理删除；普通编辑保留date和post，显式refresh_date才刷新日期。标题去标签、正文AntiXSS清理；不调用支付、邮件、Telegram或Cron。原日报仍依已有计划可包含可见公告。 `app/routes.php` 注册 POST `/api/atom/v1/announcements` → `Controllers/Api/Atom/AnnouncementController` → `Services/Atom/AnnouncementBridge`。使用独立HMAC、nonce、精确project/environment/instance，不沿用旧Nasa API或管理员会话；默认关闭。公告保留在原`announcement`表，支持list/get/create/update，status=0撤下，不物理删除；普通编辑保留date和post，显式refresh_date才刷新日期。标题去标签、正文AntiXSS清理；不调用支付、邮件、Telegram或Cron。原日报仍依已有计划可包含可见公告。
@ -18,4 +18,6 @@
本次另修复Ann::visible及UserController首页/列表/未读、Services/Cron日报仅取status=1；隐藏后不在用户入口出现，全部隐藏时未读不报错。保留原后台/Telegram入口，不迁移旧Nasa权限。 本次另修复Ann::visible及UserController首页/列表/未读、Services/Cron日报仅取status=1；隐藏后不在用户入口出现，全部隐藏时未读不报错。保留原后台/Telegram入口，不迁移旧Nasa权限。
验证：`php vendor/bin/phpunit tests/App/Services/Atom/AnnouncementBridgeTest.php --do-not-cache-result`，6 tests / 47 assertions，内存SQLite，无真实配置/通知。双ship真实HTTP隔离11项通过；ATOM本地桌面页面新增隐藏公告确认回执通过；尚未做移动视口或生产验收。MariaDB真实FUC表引擎、生产HTTPS链路尚待获批发布时核实，不能称已接通线上。 验证：`php vendor/bin/phpunit tests/App/Services/Atom/AnnouncementBridgeTest.php --do-not-cache-result`，6 tests / 47 assertions，内存SQLite，无真实配置/通知。双ship真实HTTP隔离11项通过；ATOM本地桌面页面新增隐藏公告确认回执通过；尚未做移动视口或生产验收。生产已核实InnoDB及真实HTTPS签名链路，原15条公告摘要在部署前、ATOM读取、最终原库核对三次一致。未做线上页面验收，未写真实公告或发送通知。
生产FUC运行Git `5ab97694d4bb69aecb9afaf9ec30e671fa4b68d9`；ATOM运行版本、唯一生产证据、公共反代服务器403边界与两端回滚入口统一见[公告专题生产状态](/Users/hellcat/Documents/GemCodes/atom/codex/output/docs/ship-announcements.md#2026-10-26-生产接通与实际状态)。FUC受限恢复点 `/var/lib/ship-announcements-20261026/` 保存原配置、公告表备份、原Git和client文件哈希；rollback.py已保存未执行。原有客户端安装包改动保留，其他本地并行修改及暂存未提交/发布。