feat: ship blog platform admin and deploy stack

backend/README.md

@@ -1,58 +1,37 @@
-# Welcome to Loco :train:
+# backend
 
-[Loco](https://loco.rs) is a web and API framework running on Rust.
+Loco.rs backend，当前仅保留 API 与后台鉴权相关逻辑，不再提供旧的 Tera HTML 后台页面。
 
-This is the **SaaS starter** which includes a `User` model and authentication based on JWT.
-It also include configuration sections that help you pick either a frontend or a server-side template set up for your fullstack server.
+## 本地启动
 
-
-## Quick Start
-
-```sh
+```powershell
 cargo loco start
 ```
 
-```sh
-$ cargo loco start
-Finished dev [unoptimized + debuginfo] target(s) in 21.63s
-    Running `target/debug/myapp start`
+默认本地监听：
 
-    :
-    :
-    :
+- `http://localhost:5150`
 
-controller/app_routes.rs:203: [Middleware] Adding log trace id
+## 当前职责
 
-                      ▄     ▀
-                                 ▀  ▄
-                  ▄       ▀     ▄  ▄ ▄▀
-                                    ▄ ▀▄▄
-                        ▄     ▀    ▀  ▀▄▀█▄
-                                          ▀█▄
-▄▄▄▄▄▄▄  ▄▄▄▄▄▄▄▄▄   ▄▄▄▄▄▄▄▄▄▄▄ ▄▄▄▄▄▄▄▄▄ ▀▀█
- ██████  █████   ███ █████   ███ █████   ███ ▀█
- ██████  █████   ███ █████   ▀▀▀ █████   ███ ▄█▄
- ██████  █████   ███ █████       █████   ███ ████▄
- ██████  █████   ███ █████   ▄▄▄ █████   ███ █████
- ██████  █████   ███  ████   ███ █████   ███ ████▀
-   ▀▀▀██▄ ▀▀▀▀▀▀▀▀▀▀  ▀▀▀▀▀▀▀▀▀▀  ▀▀▀▀▀▀▀▀▀▀ ██▀
-       ▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
-                https://loco.rs
+- 文章 / 分类 / 标签 / 评论 / 友链 / 评测 API
+- admin 登录态与后台接口
+- 站点设置与 AI 相关后端能力
+- Markdown frontmatter 与数据库双向同步
+- 内容生命周期：`draft / published / scheduled / offline / expired`
+- 可见性与 SEO：`public / unlisted / private`、`canonical`、`noindex`、`OG`、redirect
+- Webhook 通知：新评论 / 新友链申请
+- 内容消费统计：`page_view / read_progress / read_complete`
 
-environment: development
-   database: automigrate
-     logger: debug
-compilation: debug
-      modes: server
+## 生产部署
 
-listening on http://localhost:5150
-```
+生产环境推荐通过环境变量注入：
 
-## Full Stack Serving
+- `APP_BASE_URL`
+- `DATABASE_URL`
+- `REDIS_URL`
+- `JWT_SECRET`
 
-You can check your [configuration](config/development.yaml) to pick either frontend setup or server-side rendered template, and activate the relevant configuration sections.
+Docker / compose 相关示例见仓库根目录：
 
-
-## Getting help
-
-Check out [a quick tour](https://loco.rs/docs/getting-started/tour/) or [the complete guide](https://loco.rs/docs/getting-started/guide/).
+- `deploy/docker/compose.package.yml`