英语学习软件项目架构

1
NebulaCore/
2
├── CMakeLists.txt          # 构建脚本 (跨平台关键)
3
├── 3rdparty/               # 第三方库 (SQLite, nlohmann/json, cpp-httplib)
4
├── include/                # 头文件 (对外暴露的接口)
5
│   ├── nebula_api.h        # 给 Flutter 调用的 C 接口 (FFI)
6
│   └── common_types.h      # 通用结构体定义的 JSON 序列化
7
├── src/
8
│   ├── main.cpp            # 本地调试入口 (不给 Flutter 用)
9
│   ├── core/               # 核心层 (Kernel)
10
│   │   ├── AppCore.h/cpp       # 【单例】总控制器
11
│   │   ├── DatabaseMgr.h/cpp   # 数据库管家 (封装 SQLite)
12
│   │   └── ModuleMgr.h/cpp     # 模块调度器 (负责分发消息)
13
│   │   └── ThreadPool.h # 【新增】线程池工具
14
│   ├── protocol/
15
│   ├── Packet.h # 【新增】协议头定义
16
│   └── PacketCodec.h # 【新增】组包/解包器
17
│   ├── modules/            # 业务模块层 (这里是扩展的关键！)
18
│   │   ├── IModule.h           # 【接口】所有模块的父类
19
│   │   ├── vocab/              # 模块1: 词汇管理
20
│   │   │   └── VocabModule.h/cpp
21
│   │   ├── ai/                 # 模块2: AI (未来预留)
22
│   │   └── social/             # 模块3: 社交 (未来预留)
23
│   └── utils/              # 工具类 (Log, StringUtils)
24
└── tests/                  # 单元测试