docs: 开发规范/教程/demo 全套 + 修复插件运行期自动加载缺口

- demo 插件 plugins/demo.hello-world:演示短代码过滤器、comment.created 钩子、路由+命名空间视图、迁移+模型、后台设置页、filament.post_form 表单注入
- demo 主题 themes/demo:最小可运行主题(覆盖 partials + 绿色系样式)
- 教程 docs/tutorial-plugin.md / docs/tutorial-theme.md(10 分钟上手);规范 docs/development.md(代码/插件/主题/队列/测试/提交)
- README 增加开发者文档导航与上手示例
- 修复关键缺口:插件类原来靠 composer.json 硬编码加载,第三方 ZIP 安装的插件无法加载;现改为启动时扫描 plugins/*/src 运行期注册 PSR-4(register 阶段,保证 Filament 面板解析插件页面前就绪),composer.json 移除硬编码
- 测试:demo 插件 3 个用例 + demo 主题渲染;全量 89 通过
This commit is contained in:
ak
2026-08-12 17:26:34 +08:00
parent 7364def979
commit 8fdf8dbb4b
21 changed files with 840 additions and 11 deletions
+21 -4
View File
@@ -120,9 +120,26 @@ php artisan workerman:serve stop
## 测试
```bash
php artisan test # 25 个用例:迁移/老路由 301/主题/插件/会员支付流/AI 审核
php artisan test # 84 个用例:迁移/老路由 301/主题/插件/会员支付流/AI 审核/商城购买
```
## 开发者文档
| 文档 | 内容 |
|------|------|
| [docs/development.md](docs/development.md) | 开发规范(代码/插件/主题/队列/测试/提交) |
| [docs/tutorial-plugin.md](docs/tutorial-plugin.md) | 插件开发教程(10 分钟上手,配套 demo) |
| [docs/tutorial-theme.md](docs/tutorial-theme.md) | 主题开发教程(10 分钟上手,配套 demo) |
| [docs/plugins.md](docs/plugins.md) | 插件 API 详解(钩子/依赖/商品化/市场契约) |
| [docs/themes.md](docs/themes.md) | 主题 API 详解(视图解析/注入点/变量) |
| [docs/architecture.md](docs/architecture.md) | 架构与设计决策 |
| [docs/api.md](docs/api.md) | 对外 API(小程序/第三方) |
| [docs/deploy.md](docs/deploy.md) | 部署(nginx/systemd/workerman/cron |
**上手示例**
- 插件:`plugins/demo.hello-world/`(短代码 / 钩子 / 路由 / 后台页 / 迁移 / 表单注入,全演示)
- 主题:`themes/demo/`(最小可运行主题,绿色系,覆盖 partials 即可换肤)
## 目录结构
```
@@ -130,9 +147,9 @@ app/
Blog/ # 前台域模块(Controllers/Jobs/Services/Support/View
Filament/ # 后台资源与页面
Console/Commands # sablog:import / attachments:sync-s3 / workerman:serve / content:convert
themes/ # 主题(sablog / modern
plugins/ # 内置插件(blog-seo / ai-moderation / payment / membership
docs/deploy.md # 部署指南
themes/ # 主题(sablog / modern / demo 示例
plugins/ # 内置插件(blog-seo / ai-moderation / payment / membership+ demo.hello-world 示例
docs/ # 全部文档(见上文表格)
```
## 许可