opsx-vpn/AGENTS.md

opsx-vpn 协作说明

本项目是 Go（Gin）后端、Vue 3 前端与 SQLite 组成的 VPN 专线管理平台。先理解现有行为和需求边界，再按变更影响决定设计与验证的深度。

变更分级与设计

级别	场景	要求
S0	文案、格式等无行为变化	简要说明即可
S1	缺陷修复、现有契约内重构	说明问题、依据、需保留的行为和验收方式
S2	新功能、接口/配置/数据模型变化、跨模块行为变化	实施前按 docs/sdd-template.md 写完整 SDD；每项需求对应可验证的验收标准
S3	权限、安全、数据迁移/删除、生产部署变化	满足 S2 要求，并写清风险、发布顺序、验证与恢复方式

• 按实际影响分级；调查中发现契约或风险扩大时，更新分级和设计。
• 设计可以先在任务中形成；需要长期维护或用户要求入库时，存入 docs/specs/。不要为了套模板阻断已经明确授权的实现工作。
• 先引用已有代码、接口、数据库结构和配置作为当前行为的依据；不编造业务规则、指标、批准记录或测试结果。未知或需决策的事项明确标记。
• SDD 是设计与验收依据，不代表已经批准、实现或验证；只有实际执行过的检查才能标为通过。

实施与验证

• 用户要求设计时交付设计；用户要求修改或开发时，完成获授权的实现并按风险验证。需要用户决定的阻塞事项单独提出，独立工作继续推进。
• 修改接口、数据或协议行为时，核对前后端调用、兼容性及相关测试；安全和部署变更还应检查失败场景与恢复路径。
• 保留用户未提交的文件和改动；不要用生成文件覆盖现有工作。