Fincept Storage System (SQLite + Repository Pattern)

Overview

Fincept Terminal 使用 SQLite 作为本地持久化存储，采用 Repository 模式 + Migration 系统 + Cache 层 + SecureStorage 的四层架构。~75 个源文件覆盖完整的数据访问层。

Architecture Layers

┌─────────────────────────────────────────┐
│         StorageManager                   │  ← 统一入口，初始化所有子系统
├─────────────────────────────────────────┤
│  Repositories (17+ 实体仓库)             │  ← CRUD 操作，业务数据
│  BaseRepository.h (模板基类)            │
├─────────────────────────────────────────┤
│  CacheManager + TabSessionStore         │  ← 内存缓存 + 会话状态
├─────────────────────────────────────────┤
│  Database + CacheDatabase (SQLite)      │  ← 原生 SQLite 封装
│  MigrationRunner + v001~v018           │  ← 数据库迁移
├─────────────────────────────────────────┤
│  SecureStorage                          │  ← 敏感数据加密存储
└─────────────────────────────────────────┘

Database Layer

Database (主数据库)

• Database::instance() — 单例模式
• 自动创建数据库目录
• 支持 WAL 模式 (Write-Ahead Logging)
• 事务管理 (beginTransaction(), commit(), rollback())

CacheDatabase (缓存数据库)

• 独立于主数据库
• 用于 DataHub 的持久化缓存
• 支持 TTL 过期自动清理

Migration System

18 个迁移版本 (v001_initial.cpp 到 v018_widget_config):

Repository Pattern

BaseRepository (模板基类)

template<typename T>
class BaseRepository {
    virtual Result<T> by_id(int id);
    virtual Result<QList<T>> all();
    virtual Result<void> insert(const T& item);
    virtual Result<void> update(const T& item);
    virtual Result<void> remove(int id);
};

17+ Repositories

SecureStorage

• 加密存储敏感数据 (API keys, credentials)
• 平台原生加密:
  • Windows: DPAPI (CryptProtectData)
  • macOS: Keychain
  • Linux: libsecret / fallback

CacheManager + TabSessionStore

• CacheManager: 内存缓存，支持 TTL
• TabSessionStore: 保存标签页状态 (滚动位置、选中项等)

Design Decisions

1. SQLite over embedded DB: 零依赖，跨平台，支持完整 SQL
2. Repository pattern: 统一接口，易于测试和替换后端
3. Migration system: 安全的 schema 演进
4. Separate cache DB: 缓存数据可安全删除，不影响核心数据
5. Platform-native encryption: 不自行实现加密算法
6. WAL mode: 更好的并发性能

Related

• fincept-terminal-architecture
• datahub-architecture
• broker-interface