WePush Next 架构决策索引
本目录保存 WePush Next 已接受的跨组件架构决策。架构与详细设计描述当前整体状态;ADR 记录选择原因、边界和后果。发生冲突时,应先确认 ADR 是否已被后续决策替代,再同步更新设计文档。
产品定位、长期非目标和迭代优先级以《产品目标、边界与路线图》为准;ADR 不得以技术扩展名义改变该产品边界。
| ADR | 状态 | 决策摘要 |
|---|---|---|
| ADR-0001 | 已接受 | Classic 与 Next 双轨独立发展,允许按需重复代码 |
| ADR-0002 | 已接受 | Java 21、Spring Boot 4.1.x、TypeScript/Vite/React、Electron 技术基线 |
| ADR-0003 | 已接受 | 默认并正式使用本地 AES-256-GCM 信封加密 Secret Store,不规划云密钥适配 |
| ADR-0004 | 已接受 | Agent 使用 gRPC 双向流,UI/SDK 事件使用 SSE |
| ADR-0005 | 已接受 | PF4J、签名插件、ClassLoader 隔离和滚动重启更新 |
| ADR-0006 | 已接受 | PostgreSQL 18、无状态 Service、Advisory Lock 和 Fencing |
| ADR-0007 | 已接受 | Standalone 本地制品、用户自建 Server S3-compatible 制品及保留策略 |
| ADR-0008 | 已接受 | Workspace 只作为同一自建实例信任域内的逻辑隔离 |
新增或替代决策时使用下一个连续编号,并在状态中明确“提议、已接受、已替代或已拒绝”。替代已有 ADR 时,旧 ADR 保留历史并链接到新 ADR。