01 项目概览
这是什么？
可得财务（KeDe Finance） 是一套纯 PHP 自研的 IDC/云主机/虚拟商品财务系统，功能对齐行业常见产品（如 WHMCS、魔方财务），包括：
- 商品与订单、账单与支付、客户与服务实例
- 后台 SPA + 前台 SPA（Vue 3 + Arco Design）
- RBAC 权限、安装向导、数据迁移
- 插件体系（功能/支付/短信/邮件/实名等）
- 插件市场（官方目录；生产用压缩包安装，开发环境可一键安装）
- 开通模块（人工/演示/上游/cPanel 等）
- 主题系统（CSS 注入 + 魔方
.tplSSR） - 在线授权（安装时填入 20 位授权码；后台可查看状态与重新激活）
- 自定义后台路径（安装或「系统设置」中配置，如
/admin666/）
当前版本：正式版 1.0.4（BUILD 见 app/common/Version.php，文档同步至 Build 191）。
当前活跃项目目录：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 / SPA（ADMIN_PATH 可改） |
/home/* | home | 会员/前台 API |
/api/* | api | 支付回调等 |
/setup/* | setup | 安装向导 |
/license/* | license | 公开授权状态等 |
开发时：
核心服务一览
| 服务类 | 作用 |
|---|---|
PluginService | 插件扫描、安装、配置、钩子加载 |
MarketplaceService | 插件市场目录、下载、安装 |
PaymentService | 支付网关驱动与回调 |
NotifyService | 邮件/短信发送 |
RealnameProviderService | 实名认证驱动 |
ModuleService | 开通/管理模块调度 |
ThemeService | 主题切换、.tpl SSR |
HookService | 全局钩子 |
UpgradeService | 系统热更新 |
LicenseService | 在线授权激活 / 心跳 / 状态 |
InstallService | 安装向导、自定义后台路径 |
插件生态现状
| 类型 | 内置/官方数量 | 目录 |
|---|---|---|
| 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/ |
后台入口：插件管理（本地插件 用于压缩包安装；插件市场 用于开发环境远程安装）。
欢迎加入插件/主题制作团队：QQ 群入口。
下一步
- 本地跑起来 → 02-quick-start
- 理解目录 → 03-structure
- 写插件 → 04-plugins
- 热更新发布 → 26-upgrade-dev
- 授权接入（客户侧）→ 28-授权与安装接入
- 写插件 → 04a-plugin-tutorial
- 写主题 → 10a-theme-tutorial