P2-3: 横切服务桩换 framework 真实现(文件/日志/消息)

保真层原样移植三块横切服务,删除对应桩,bean 名/包名/签名不动:

- 文件 com.dsasp.server.file.*:FileServiceImpl(bean fileService)真实现,
  存储后端经替换类 FTPClientTemplate(保包名/类名/签名,FTP→本地盘,
  根目录 eip4.file.root 配置化默认 ./data/files,resolveSafe 防 ../ 逃逸);
  BASE64Decoder→java.util.Base64、ant zip→java.util.zip、commons-codec→MessageDigest。
- 日志 com.dsasp.server.log.*:SystemLogManagerImpl/DataOperatorLogger/
  DataLogRecorderImpl + 异步调度(DataLogManager/ProcessLogThread/ProcessSysLogThread)
  原样移植,落 SYS_LOG/SYS_DATA_LOG/SYS_DATA_LOGITEM(后者 insert-only 无审计列,§5.1)。
- 消息 com.dsasp.server.mail.*:SystemEmailServiceImpl + SystemEmail/SystemEmailService
  移植;SMTP 配置缺省时降级 no-op + WARN,不阻塞启动(§5.38)。

装配/配置/自举/验证:
- LegacyXmlWiring 等价补齐三处 jdbcTemplate setter + MainApp.destPath 注入(§4.1);
- application.yml 加 eip4.file.root;bootstrap-xservice.sql 自举四张横切表 + LOGLEVEL;
- 删除 StubFileService/StubSystemLogManager/StubDataOperatorLog(StubProjectSwitchService
  属 viewframework 域非本任务范畴,保留);
- 单测 12 + 本地 DB 集成 4,全模块 mvn clean test 绿(含 ArchUnit);8087 启动验证毕已 kill。

报告:platform-auth/P2横切服务实测报告.md;坑入 docs/迁移手册.md §3.1/§3.2/§5.36-5.38。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
This commit is contained in:
2026-06-11 14:06:31 +08:00
parent b6de637905
commit 6cc7b3fb61
31 changed files with 2400 additions and 153 deletions

View File

@@ -0,0 +1,103 @@
-- ============================================================================
-- eip4-platform P2 横切服务(文件/日志)自举 schema —— bootstrap-xservice.sql
-- ----------------------------------------------------------------------------
-- 用途:在本地 eip4m0 上建立 FileServiceImpl / SystemLogManagerImpl /
-- DataLogRecorderImpl 三块真实现落库所需的物理表:
-- * SYS_DOC —— 附件元数据(文件名/扩展名/大小/相对路径/MD5/软删 ISACTIVE)
-- * SYS_LOG —— 系统操作日志(TYPE/CONTENT/操作人/时间)
-- * SYS_DATA_LOG —— 数据操作日志主表(表名/记录id/类型/操作人/时间)
-- * SYS_DATA_LOGITEM —— 数据操作日志明细(列名/旧值/新值)
--
-- 列口径权威来源(逐一核对保真层 SQL):
-- * SYS_LOG = SystemLogManagerImpl.log(List) 的 INSERT 列序
-- (SYS_LOG_ID,TYPE,CONTENT,createtime,createby,updatetime,updateby,isactive,version)
-- * SYS_DATA_LOG = DataLogRecorderImpl.recorderLogs 主表 INSERT 列序
-- (sys_data_log_id,tablename,recordid,mainrecordid,type,updatetime,updateby)
-- * SYS_DATA_LOGITEM = DataLogRecorderImpl 明细 INSERT 列序
-- (sys_data_logitem_id,sys_datalogid,oldvalue,newvalue,columnname)
-- * SYS_DOC = SYSDoc 常量 + FileServiceImpl save/delete/getPicPath 用到的列。
--
-- ⚠️ 迁移手册 §5.1 坑:SYS_DATA_LOGITEM 为 insert-only,物理表「无 UPDATETIME/UPDATEBY 列」。
-- 引擎 updatePO 会无条件追加这两列,故该表绝不可走 update 路径——本 DDL 故意不建审计列,
-- 保真层 DataLogRecorderImpl 也只走纯 INSERT,与老系统一致。
--
-- 纪律:可重复执行(DROP ... IF EXISTS 开头);表名/列名一律小写(PG 不区分大小写,
-- 引擎/保真层 SQL 大小写混用,小写建库两侧均命中)。时间列 = bigint(epoch 毫秒)。
-- ============================================================================
DROP TABLE IF EXISTS sys_data_logitem CASCADE;
DROP TABLE IF EXISTS sys_data_log CASCADE;
DROP TABLE IF EXISTS sys_log CASCADE;
DROP TABLE IF EXISTS sys_doc CASCADE;
-- ---------------------------------------------------------------------------
-- 1. SYS_DOC —— 附件元数据
-- ---------------------------------------------------------------------------
CREATE TABLE sys_doc (
sys_doc_id character(36) NOT NULL,
filename character varying(255),
fileext character varying(50),
filesize integer,
filepath character varying(500),
tablename character varying(100),
businesskey character(36),
md5hash character varying(64),
isactive integer DEFAULT 1 NOT NULL,
createtime bigint,
updatetime bigint,
createby character(36),
updateby character(36),
version integer DEFAULT 0 NOT NULL,
CONSTRAINT pk_sys_doc PRIMARY KEY (sys_doc_id)
);
-- ---------------------------------------------------------------------------
-- 2. SYS_LOG —— 系统操作日志(SystemLogManagerImpl.log)
-- ---------------------------------------------------------------------------
CREATE TABLE sys_log (
sys_log_id character(36) NOT NULL,
type character varying(50),
content text,
createtime bigint,
createby character(36),
updatetime bigint,
updateby character(36),
isactive integer DEFAULT 1 NOT NULL,
version integer DEFAULT 0 NOT NULL,
CONSTRAINT pk_sys_log PRIMARY KEY (sys_log_id)
);
-- ---------------------------------------------------------------------------
-- 3. SYS_DATA_LOG —— 数据操作日志主表(DataLogRecorderImpl.recorderLogs 主表)
-- ---------------------------------------------------------------------------
CREATE TABLE sys_data_log (
sys_data_log_id character(36) NOT NULL,
tablename character varying(100),
recordid character(36),
mainrecordid character(36),
type integer,
updatetime bigint,
updateby character(36),
CONSTRAINT pk_sys_data_log PRIMARY KEY (sys_data_log_id)
);
-- ---------------------------------------------------------------------------
-- 4. SYS_DATA_LOGITEM —— 数据操作日志明细(insert-only,无 UPDATETIME 列,见 §5.1)
-- ---------------------------------------------------------------------------
CREATE TABLE sys_data_logitem (
sys_data_logitem_id character(36) NOT NULL,
sys_datalogid character(36),
oldvalue text,
newvalue text,
columnname character varying(100),
CONSTRAINT pk_sys_data_logitem PRIMARY KEY (sys_data_logitem_id)
);
-- ---------------------------------------------------------------------------
-- 5. 日志级别配置(SystemLogManagerImpl.hasLogType 读 LOGLEVEL;逗号分隔 LogType.value)
-- 取值口径 = LogType 枚举的 value:Errors / Info / Debug / Warnings(见 SystemLogManager.LogType)。
-- 缺省给全开;无此键则系统日志整链静默(原版语义:未配置=不记)。
-- ---------------------------------------------------------------------------
INSERT INTO sys_application_config (sys_application_config_id, value)
VALUES ('com.dsasp.server.log.LOGLEVEL', 'Errors,Info,Debug,Warnings')
ON CONFLICT (sys_application_config_id) DO UPDATE SET value = EXCLUDED.value;