# 开发文档

本章面向**开发者**，介绍系统的分层架构、关键设计、工程结构与开发规范。

## 设计与实现

- [整体架构](/dev/architecture)：技术栈、后端分层、请求流程、认证与前端结构
- [数据模型](/dev/data-model)：21 张表的字段与关系、双数据库脚本差异
- [账单解析](/dev/bill-parsing)：解析器策略模式、两阶段导入、去重与 zip 解密
- [规则引擎](/dev/rule-engine)：规则模型与匹配逻辑
- [AI 集成](/dev/ai)：OpenAI SDK 客户端、11 类调用类型与用量记录
- [定时通知](/dev/notifications)：调度、渠道与发送日志
- [动态数据源](/dev/database)：SQLite / MySQL 运行时配置与切换
- [前端用户偏好](/dev/preferences)：偏好的存储介质、读写时机与完整清单

## 工程与规范

- [项目结构](/dev/project-structure)：目录组织与各包职责
- [构建与部署](/dev/build-deploy)：`bootJar`、Docker 编排、桌面 GUI 启动器与 jpackage
- [开发环境与规范](/dev/development)：AI 测试环境、前后端开发流程、代码规范、Git 提交规范
- [账单字段说明](/dev/bill-fields)：支付宝账单导入字段的读取与丢弃情况
- [API 文档](/dev/api)：Knife4j（OpenAPI 3）接口文档

> 使用说明请查看[使用文档](/guide/)。