# 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 用户信息、添加远程地址并推送。