[feat] 拓展 database-ptc-object 增加快捷操作工具

[FxRayHughes]

概述

为 database-ptc-object 模块新增快捷操作工具，简化数据库 CRUD 操作流程。

主要改动

新增功能

• @ColumnType 注解 — 显式指定数据库列类型（LONGTEXT、TEXT 等）
• mapper<T>() 属性委托 — 一行代码懒加载创建容器 + 表 + 操作器
• DataMapper<T> 接口 — 类型安全的 CRUD 入口（insert/find/update/delete/count/exists/sort 等）
• DataCache 接口 — 可扩展的查询缓存，支持自定义实现（Redis、Caffeine 等），内置 ConcurrentHashMap 实现
• 精确缓存失效策略 — 单条写入仅失效受影响 ID 的缓存，保留其他 ID 的定向缓存
• 批量操作优化 — findByIds、deleteByIds、updateBatch（IN 子句 + batch PreparedStatement）
• 自定义 SQL — query、rawQuery、rawUpdate、rawDelete、rawExecute
• 多表联查 — join {} + selectAs() 解决同名列冲突
• 事务支持 — transaction {} 块内共享连接
• 自增 ID 获取 — insertAndGetKey / insertBatchAndGetKeys
• @key 相关操作 — findByKey、deleteByKey、existsByKey
• 自增行 ID 操作 — findByRowId、deleteByRowId（用于无 @id 的数据类）

补充 ContainerOperator

• 新增 count()、deleteWhere()、insertAndGetKeys()、findByIds()、deleteByIds()、updateBatch()、findByKey()、deleteByKey() 等方法

修改的文件

• Annotations.kt — 新增 @ColumnType，补充注解文档
• AnalyzedClassMember.kt — 解析 @ColumnType
• ContainerSQL.kt / ContainerSQLite.kt — 支持 @ColumnType 建表
• ContainerOperator.kt / ContainerOperatorImpl.kt — 新增基础方法
• JoinQuery.kt — 新增 selectAs()
• PersistentContainer.kt — 新增 mapper()
• TransactionContext.kt — 新增快捷方法

新建的文件

• DataMapper.kt — CRUD 接口定义
• DataMapperImpl.kt — 标准实现（含精确缓存失效）
• TransactionalDataMapper.kt — 事务实现
• QueryCache.kt — DataCache 接口 + 内置 ConcurrentHashMap 缓存
• MapperDelegate.kt — mapper<T>() 属性委托工厂

用法示例

val homeTable by mapper<PlayerHome>(dbFile("data.db")) {
    cache { maximumSize = 1000; expireAfterWrite = 300 }
}

homeTable.insert(home)
homeTable.findById(uuid)
homeTable.findAll { "world" eq "world_nether" }
homeTable.update(home)
homeTable.deleteById(uuid)
homeTable.count { "active" eq true }

Closes #656