fmode-app-mirror · 项目宪法

时尚魔镜（Fashion Magic Mirror）虚拟试衣独立仓。Angular 18 + Ionic 8 + Capacitor 6。

身份

提取自 git.fmode.cn/2205106/FashionMagicMirror（源仓致谢，业务代码保留）
归档仓：https://git.fmode.cn/fmode-18691770343/fmode-app-mirror（公开）
线上：https://fmode.cn/aipm-lesson/fmode-app-mirror/index.html

构建纪律

Node 20.x；依赖安装优先 npm ci（package-lock 已入库），peer deps 冲突才用 --legacy-peer-deps。
产物目录 www/（angular.json outputPath），不入库（.gitignore 已忽略）。
每次修复启动/构建阻塞问题，单独一个 fix: commit，说明根因。
Capacitor 只用 Web 层；不安装原生平台、不跑 npx cap add。

部署纪律

ng build --configuration production → cp www/index.html www/404.html（SPA fallback）。
OBS 上传逐文件指定目标键，禁目录递归 cp；html/css/js/图片带正确 content-type；-acl=public-read。
CDN 刷新只用 fmode.cn 域名组脚本：node /opt/data/git-repos/fmode-app/scripts/refresh-fmode-cn.js <urls...>；禁用旧 refresh-cdn.js（硬编码刷 app.fmode.cn）。
发布后逐 URL curl 验收 200 + 内容正确，才算上线成功。
Git 归档与前端上线是两个独立状态门禁，分别报告，禁止互相冒充。

凭据零暴露

sessionToken 只从 ~/.fmode/config/user.json（0600）读取，用完即弃，不落盘。
Gogs 个人 token 仅进程内存使用，不进 remote URL / 文件 / 日志 / 报告。
OBS AK/SK 只通过 OBSUTIL_CONFIG 指向的配置文件间接使用，绝不写入本仓。
任何密钥不得出现在 commit、截图、终端输出、最终交付报告。

Git 纪律

Conventional Commits（feat/fix/docs/chore/refactor/style）。
不强推 main；不修改他人历史；git add <文件> 不用 git add .。
push 后必须 git ls-remote 验证远端 SHA。
平台接口 401/209 时走「对话式验证码登录」自愈流程（07-git.md 标准节），不向用户索要密码。

已上线 vs 规划中（04-API设计.md 对齐）

✅ 已接入：Git 幂等开户/建仓/push；OBS 静态发布 + CDN；Parse 主端点（server.fmode.cn/parse, appId ncloudmaster）。
❌ 跳过：storage/credentials、计费 API（status:规划中，勿照抄端点）；deploy STS 对本 session 返回 403，未接入。