15 lines
1.5 KiB
Markdown
15 lines
1.5 KiB
Markdown
# Agent Notes
|
|
|
|
- 后续修改必须新建分支并提交 PR；未经维护者明确指示，不直接推 main、不自行合并。
|
|
- 默认中文维护项目文档、commit、issue 和 PR；代码与上游 API 名称保留英文。
|
|
- 项目使用 Java 与 Spring；Native 是交付约束，不是可选优化，不引入 Kotlin。
|
|
- 日常变更先通过适用的 JVM 测试，不要求每轮执行耗时的 Native 编译与测试；Native 仍为交付目标，在阶段性验收或兼容性风险变化时集中验证。未执行的验证明确报告。
|
|
- 按 DDD 组织 authentication 上下文：领域拥有 User/UserRepository 与认证事务规则，应用层编排，基础设施实现 AD 仓储，Web 仅处理传输与会话；领域和应用层不依赖 Spring/Servlet/LDAP。
|
|
- 用户仓储复用本次用户 bind 的连接，不新增只读服务账号；连接限于当前用例，不保留密码或连接在 HTTP session 中。
|
|
- 选型演示在真实接入后删除，不将演示入口、状态机、验证码或开关保留为应用功能。
|
|
- 只实现当前任务范围。Hydra 负责签发，首轮 AD 负责身份和组，本服务独立于 Ayatori。
|
|
- 不把 LDAP 密码成功当成完整 MFA 成功；所有因素绑定同一主体与认证事务。
|
|
- 不提交凭据、MFA secret、生产配置秘密或包含上述内容的测试输出。
|
|
- 生产部署配置属于 homelab-infra；本仓库初始化不授权切换现役登录入口。
|
|
- 文档区分计划、实现、Native 实测和人类验收，禁止将代码存在当成部署证据。
|