主题
01 项目概览
这是什么？
可得财务（KeDe Finance） 是一套纯 PHP 自研的 IDC/云主机/虚拟商品财务系统，功能对齐行业常见产品（如 WHMCS、魔方财务），包括：
- 商品与订单、账单与支付、客户与服务实例
- 后台 SPA + 前台 SPA（Vue 3 + Arco Design）
- RBAC 权限、安装向导、数据迁移
- 插件体系（功能/支付/短信/邮件/实名等）
- 插件市场（官方目录；生产用压缩包安装，开发环境可一键安装）
- 开通模块（人工/演示/上游/cPanel 等）
- 主题系统（CSS 注入 + 魔方
.tplSSR）
当前活跃项目目录：kede-finance/（纯 PHP）。kede-finance-废弃版/ 为早期 Go 迁移实验，已不再维护。
技术栈
| 层级 | 技术 |
|---|---|
| 后端 | PHP 8.1+、ThinkPHP 8 多应用 |
| 数据库 | MySQL 5.7+ / MariaDB |
| 后台前端 | Vue 3 + Vite + Arco Design |
| 前台前端 | Vue 3 + Vite + Arco Design |
| 邮件 | PHPMailer（SMTP） |
| 支付 | 自研 Gateway 接口 + 多驱动 |
多应用结构
ThinkPHP 按 URL 前缀划分应用：
| URL 前缀 | 应用 | 用途 |
|---|---|---|
/admin/* | admin | 管理后台 API |
/home/* | home | 会员/前台 API |
/api/* | api | 支付回调等 |
/setup/* | setup | 安装向导 |
开发时：
核心服务一览
| 服务类 | 作用 |
|---|---|
PluginService | 插件扫描、安装、配置、钩子加载 |
MarketplaceService | 插件市场目录、下载、安装 |
PaymentService | 支付网关驱动与回调 |
NotifyService | 邮件/短信发送 |
RealnameProviderService | 实名认证驱动 |
ModuleService | 开通/管理模块调度 |
ThemeService | 主题切换、.tpl SSR |
HookService | 全局钩子 |
UpgradeService | 系统热更新 |
插件生态现状
| 类型 | 内置/官方数量 | 目录 |
|---|---|---|
| addon 功能插件 | 6 | public/plugins/addon/ |
| gateway 支付 | 3 | public/plugins/gateway/ |
| sms 短信 | 2 | public/plugins/sms/ |
| mail 邮件 | 2 | public/plugins/mail/ |
| certification 实名 | 4 | public/plugins/certification/ |
| 开通模块 extend | 3 | extend/modules/ |
| 支付内置驱动 | 4 | app/common/gateway/driver/ |
后台入口：系统 → 插件管理（本地插件 用于压缩包安装；插件市场 用于开发环境远程安装）。