Initial baseline: LaraBlog core with plugin commerce surface.

Captures the current working tree after theme slots, ArticleAccess, and the payment / paid-content plugins so subsequent work has a reviewable git history.

docs/api/README.md

@@ -0,0 +1,21 @@
+# API 文档
+
+- **OpenAPI 3**：[`openapi.yaml`](./openapi.yaml)
+- **实现**：`routes/api.php` → `/api/v1/*`
+- **阶段**：一期以**只读内容接口**为主，供小程序/H5/其他端拉取文章、分类、标签与站点信息
+
+## 快速试
+
+```bash
+curl -s http://larablog.test/api/v1/meta | jq
+curl -s http://larablog.test/api/v1/articles | jq
+curl -s http://larablog.test/api/v1/articles/1 | jq
+```
+
+## Swagger UI
+仓库不强制绑定某一 UI 实现。可任选：
+1. 把 `openapi.yaml` 导入 [Swagger Editor](https://editor.swagger.io/)
+2. 自建静态页引用 swagger-ui（二期可加 `l5-swagger` / `scramble`）
+
+## 鉴权（规划）
+写接口（发评论、会员、支付回调）将走 Bearer Token / 小程序 session；一期未开放写操作。