chore: import MING theme source

2026-09-23 09:29:09 +08:00
parent 63b5a4beba
commit d9946a3da4
53 changed files with 4476 additions and 0 deletions
@@ -0,0 +1,38 @@
+# MING 明命品牌电商站
+
+MING 明命陶瓷内胆杯品牌官网与商城的源码仓库。前台主题位于 `ming-theme/`，基于 WordPress 与 WooCommerce，不依赖页面构建器。
+
+## 仓库结构
+
+```text
+ming-theme/          可部署的 WordPress 主题源码
+assets/reference/    非运行时的品牌视觉参考素材
+docs/brief/          系统说明、业务策略等交付资料
+docs/private/        本地运维交接资料；已由 .gitignore 排除
+scripts/             可重复执行的打包脚本
+dist/                生成的主题 ZIP；不进入 Git
+```
+
+## 开发与打包
+
+运行环境应使用 PHP 7.4+、WordPress 6.0+ 和 WooCommerce。修改主题时，保持 `ming-theme/functions.php` 中的 `MING_VERSION` 与 `ming-theme/style.css` 的 `Version` 一致。
+
+执行以下命令生成可上传的主题包：
+
+```bash
+./scripts/package-theme.sh
+```
+
+产物为 `dist/ming-theme.zip`，其中包含顶层 `ming-theme/` 目录。
+
+## 重要约束
+
+- 不提交后台密码、Cookie、API 密钥、生产配置或本地运维交接材料。
+- 主题启用钩子包含历史数据初始化逻辑，可能创建内容、菜单、商品变体与媒体资源；生产环境切换主题前必须先备份并人工确认。
+- 投票、SKU 初始化、海报生成等业务功能目前仍在主题内。后续应逐步迁移至独立插件，避免主题切换影响业务数据。
+
+## 首次推送前
+
+1. 确认 `git status --ignored` 中没有敏感文件。
+2. 轮换曾出现在旧交接文档中的后台凭据。
+3. 在 Git 平台新建空仓库后，按团队身份配置 Git 用户信息、添加远程地址并推送。