AIOA/docs/engineering/decisions.md

工程决策记录

ADR-001：先交付纵向闭环

首个里程碑围绕请假审批实现端到端能力，不按技术层横向建设全部平台组件。

ADR-002：模块化单体

核心后端以单部署单元运行；模块拥有自己的数据表，通过应用接口与领域事件协作。

ADR-003：本地环境最小化

首期本地依赖为 PostgreSQL、Keycloak、Redis 和 MinIO。Kafka、OpenSearch、APISIX、Vault 和 Kubernetes 在出现对应验收需求时接入。

ADR-004：契约优先

移动端和 AI 服务通过 OpenAPI 与 Kotlin 后端集成。AI 只返回结构化建议或工具调用请求，业务执行权始终属于 Kotlin 后端。

ADR-005：环境基线

项目使用 JDK 21、Python 3.11+ 和与主机架构一致的 Flutter stable。生产依赖和镜像禁止使用浮动 latest 标签；发布生产环境前由 CI 将已验证镜像解析并固定到真实摘要。