MING 明命品牌电商站

MING 明命陶瓷内胆杯品牌官网与商城的源码仓库。前台主题位于 ming-theme/，基于 WordPress 与 WooCommerce，不依赖页面构建器。

仓库结构

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 一致。

执行以下命令生成可上传的主题包：

./scripts/package-theme.sh

产物为 dist/ming-theme.zip，其中包含顶层 ming-theme/ 目录。

重要约束

• 不提交后台密码、Cookie、API 密钥、生产配置或本地运维交接材料。
• 主题启用钩子包含历史数据初始化逻辑，可能创建内容、菜单、商品变体与媒体资源；生产环境切换主题前必须先备份并人工确认。
• 投票、SKU 初始化、海报生成等业务功能目前仍在主题内。后续应逐步迁移至独立插件，避免主题切换影响业务数据。

首次推送前

1. 确认 git status --ignored 中没有敏感文件。
2. 轮换曾出现在旧交接文档中的后台凭据。
3. 在 Git 平台新建空仓库后，按团队身份配置 Git 用户信息、添加远程地址并推送。