- 增加 Salesforce CLI 和 Legacy Credential 登录支持 - 将错误码映射从数据库表改为枚举类(SalesforceErrorCode) - 增加会话管理表(datai_sf_login_session)和功能 - 增加登录历史导出 Excel 和分页查询功能 - 优化系统配置字段(login_url、grant_type、org_alias) - 更新业务场景、功能需求、数据模型、业务规则等章节 - 确保总需求文档与所有子需求保持一致
13 KiB
13 KiB
项目单一真源
元数据
- 项目名称:datai
- 创建时间:2026-01-21
- 版本:1.0.0
- 状态:初始化
项目概述
datai 是一个基于 Spring Boot 的项目,采用文档驱动开发(Documentation-Driven Development)模式,通过"单一真源"(Single Source of Truth)原则管理项目的所有信息。
技术栈
- 后端框架:Spring Boot
- Java 版本:Java 8+
- 数据库:MySQL (Druid连接池)
- ORM框架:MyBatis
- 缓存:Redis/Ehcache
- 工作流:Flowable
- 认证授权:OAuth2/JustAuth
- 其他技术:Netty、WebSocket、RabbitMQ等
目录索引
核心文档
- Authentication.canvas - 项目组件可视化
文档目录
- API 文档 - API 相关文档
- 变更日志 - 变更日志
- 决策记录 - 决策记录(ADR)
- 设计文档 - 设计稿或架构设计
- 实施方案 - 实施方案
- 业务逻辑 - 业务逻辑或算法逻辑
- AI 提示词 - AI 提示词库
- 参考代码 - 参考代码
- 需求文档 - 需求文档
- 复盘文档 - 复盘与回顾
- 会话记录 - 会议或对话记录
- 技能资料 - 技能相关资料
- 数据库脚本 - 数据库脚本
Prompt 目录
- 元提示词 - 终极提示词架构师
- 创建 Trae 项目规则 - Trae 项目规则生成
- 需求澄清提示词 - 需求澄清专家
- 单一真源文档驱动架构师 - 文档驱动架构师
- 项目单一真源初始化专家 - 项目初始化专家
- API文档提示词 - API文档生成提示词
- 变更日志提示词 - 变更日志生成提示词
- 决策记录提示词 - 决策记录生成提示词
- 设计文档提示词 - 设计文档生成提示词
模块索引
- datai-admin - 管理后台模块
- datai-common - 通用工具模块
- datai-framework - 核心框架模块
- datai-models - 模型模块集合
- datai-flowable - 工作流模块
- datai-form - 表单模块
- datai-generator - 代码生成器模块
- datai-message - 消息模块
- datai-online - 在线开发模块
- datai-quartz - 定时任务模块
- datai-plugins - 插件模块集合
- datai-atomikos - Atomikos事务管理
- datai-cache-ehcache - Ehcache缓存实现
- datai-cache-redis - Redis缓存实现
- datai-mybatis-interceptor - MyBatis拦截器
- datai-mybatis-jpa - MyBatis JPA支持
- datai-mybatis-plus - MyBatis Plus支持
- datai-netty - Netty通信框架
- datai-rabbitmq - RabbitMQ消息队列
- datai-websocket - WebSocket支持
- datai-scenes - 场景模块集合
- datai-scene-auth - 认证场景模块
- datai-scene-file - 文件场景模块
- datai-scene-pay - 支付场景模块
- datai-system - 系统核心模块
需求追踪
- 2026-01-21-001-动态数据源延迟加载 - 实现动态数据源的延迟加载机制,支持应用启动时只加载主库,从库按需动态加载和切换 - 已完成
- 2026-01-21-002-项目国际化需求 - 实现项目的全面国际化功能,支持前端、后端、数据库三层国际化,支持中文和英文两种语言 - 进行中
- 2026-01-21-002-01-前端国际化需求 - 实现前端界面的国际化功能,支持界面元素、表单验证、动态内容的国际化
- 2026-01-21-002-02-后端国际化需求 - 实现后端的国际化功能,支持错误消息、日志消息、验证消息、通知消息的国际化
- 2026-01-21-002-03-数据库国际化需求 - 实现数据库数据的国际化功能,支持字典数据、系统配置、菜单数据的国际化
- 2026-01-21-002-04-时区国际化需求 - 实现时区国际化功能,支持用户设置时区偏好,根据用户时区显示时间
- 2026-01-21-002-05-货币格式化需求 - 实现货币格式化功能,支持根据用户地区显示货币
- 2026-01-21-002-06-日期格式化需求 - 实现日期格式化功能,支持根据用户地区显示日期
- 2026-01-21-002-07-数字格式化需求 - 实现数字格式化功能,支持根据用户地区显示数字
- 2026-01-21-002-08-语言管理需求 - 提供语言管理功能,支持添加、编辑、删除语言,支持设置系统默认语言
- 2026-01-21-002-09-国际化资源管理需求 - 提供国际化资源管理功能,支持添加、编辑、删除国际化资源,支持批量导入导出
- 2026-01-21-003-salesforce-multi-system-auth - 实现 Salesforce 多系统认证功能,支持配置多个不同类型的 Salesforce 系统,使用策略模式实现登录,区分源 org 和目标 org,支持缓存过期时间戳校验、结构化缓存键设计、登录状态查询、错误码映射 - 进行中
- 2026-01-21-003-01-salesforce-multi-system-config - Salesforce 多系统配置,支持配置多个不同类型的 Salesforce 系统,支持用户自定义系统类型,支持区分源 org 和目标 org,支持敏感信息加密存储 - 代码生成已完成
- 2026-01-21-003-01-salesforce-multi-system-config-design - Salesforce 多系统配置技术方案设计,包含架构设计、数据库设计、接口设计、核心逻辑设计等
- 2026-01-21-003-01-ADR-salesforce-multi-system-config - ADR-003-01: Salesforce 多系统配置架构决策
- 2026-01-21-003-01-datai_sf_system_config - Salesforce 系统配置表 SQL 文档
- 2026-01-21-003-01-salesforce-multi-system-config代码生成提示词 - Salesforce 多系统配置代码生成提示词
- 2026-01-21-003-01-session - Salesforce 多系统配置开发会话记录
- 2026-01-21-003-01-changelog - Salesforce 多系统配置变更记录
- 2026-01-21-003-01-retro - Salesforce 多系统配置复盘文档
- 2026-01-21-003-01-api - Salesforce 多系统配置 API 文档
- 2026-01-21-003-02-salesforce-strategy-login - Salesforce 策略模式登录,使用策略模式实现不同类型的 Salesforce 系统登录,支持 OAuth2 和 Session ID 登录,登录策略工厂使用工厂方法模式
- 2026-01-21-003-02-salesforce-strategy-login-design - Salesforce 策略模式登录技术方案设计,包含策略模式设计、工厂方法设计、接口设计、核心逻辑设计等
- 2026-01-21-003-02-ADR-salesforce-strategy-login - ADR-003-02: Salesforce 策略模式登录架构决策
- 2026-01-21-003-02-salesforce-strategy-login-database - Salesforce 策略模式登录数据库结构说明,说明不需要创建新的数据库表,登录信息会回写到已有的 datai_sf_system_config 表中
- 2026-01-21-003-02-salesforce-strategy-login代码生成提示词 - Salesforce 策略模式登录代码生成提示词
- 2026-01-21-003-02-session - Salesforce 策略模式登录开发会话记录
- 2026-01-21-003-02-changelog - Salesforce 策略模式登录变更记录
- 2026-01-21-003-02-retro - Salesforce 策略模式登录复盘文档
- 2026-01-21-003-02-api - Salesforce 策略模式登录 API 文档
- 2026-01-21-003-03-salesforce-login-history - Salesforce 登录历史,记录所有登录历史信息,包含审计信息,支持选择历史登录成功信息快速登录
- 2026-01-21-003-04-salesforce-cache-optimization - Salesforce 缓存优化,登录成功后将 SF 登录信息保存到 Redis 缓存,使用时校验有效性,结构化缓存键设计,缓存刷新和清理
- 2026-01-21-003-05-salesforce-session-management - Salesforce 会话管理,支持会话管理,会话失效时自动重新登录,获取当前 Session ID 和 Instance URL
- 2026-01-21-003-06-salesforce-login-status-query - Salesforce 登录状态查询,提供登录状态查询接口,显示每个系统的登录状态,Session ID 脱敏处理
- 2026-01-21-003-07-salesforce-error-code-mapping - Salesforce 错误码映射,建立完整的错误码映射表,提供友好的错误提示,支持错误重试机制
更新日志
- 2026-01-21: 初始化项目单一真源结构
- 2026-01-21: 新增需求 - 动态数据源延迟加载
- 2026-01-21: 新增设计文档 - 动态数据源延迟加载技术方案
- 2026-01-21: 新增架构决策 - ADR-001: 动态数据源延迟加载
- 2026-01-21: 新增数据库脚本 - sys_datasource_config 表
- 2026-01-21: 新增代码生成提示词 - 动态数据源延迟加载
- 2026-01-21: 新增变更日志 - 动态数据源延迟加载变更记录
- 2026-01-21: 新增复盘文档 - 动态数据源延迟加载复盘
- 2026-01-21: 新增 API 文档 - 动态数据源延迟加载 API
- 2026-01-21: 新增架构决策 - ADR-003-01: Salesforce 多系统配置
- 2026-01-21: 新增数据库脚本 - datai_sf_system_config 表
- 2026-01-21: 新增代码生成提示词 - Salesforce 多系统配置
- 2026-01-22: 新增设计文档 - Salesforce 策略模式登录技术方案
使用说明
- 本文档是项目的单一真源,包含项目的所有信息
- 每个模块都有对应的 index.md 作为模块的单一真源
- 所有文档都通过索引关系相互链接
- 文档命名格式:YYYY-MM-DD-00X-功能名.md
- 遵循阶段化执行流程,每个阶段生成对应的文档
维护规则
- 创建新文档时,必须更新相关索引
- 删除文档时,必须清理索引链接
- 修改文档时,必须同步更新索引
- Authentication.canvas 在 index 更新时同步更新