# FULL HOUSE 酒馆运营项目协作规范

本仓库管理门店运营规则、培训与服务流程、价格与薪资草案、活动安排，以及由这些信息制作的广告物料。`index.html` 是项目主入口；开始工作前先看首页、相关模块的说明和已有来源，不把历史参考稿当成现行制度。

## 目录与信息来源

| 目录 | 用途 | 编辑原则 |
|---|---|---|
| `operations/` | 定价、薪资、人员、活动、吧台、计分牌银行、收款和储值等制度 | 中文 Markdown 是正文源文件 |
| `advertising/` | 海报、导视的 HTML/CSS、文案数据与视觉素材 | 文案改数据，样式改 CSS；保持关键文字可编辑 |
| `assets/brand/` | 已提供的标准标志 | 保留原始文件；按下文规则使用 |
| `assets/qr/` | 对外二维码 | 发布前核对目标和有效性 |
| `app/` | 首页样式、弹窗预览及生成的预览数据 | 修改源文件后重建预览 |
| `scripts/`、`dist/` | 检查、导出脚本与导出件 | `dist/` 为生成结果，不作为编辑源 |

项目说明见 `README.md`；广告设计细则见 `skills/full-house-ad-design/SKILL.md`。新增模块时，在对应目录放置源文件，并同步加入 `index.html`。

## 制度与数据

- 所有制度、SOP 及其他运营 Markdown 的变更记录写入同目录同名 `.history.md`，例如 `drinks-sop.md` 对应 `drinks-sop.history.md`；正文只保留制度内容与操作要求；来源说明、历史差异、历史原文和变更记录统一放在对应 `.history.md`，不出现在制度或 SOP 正文中。
- 每份运营制度与 SOP 的状态（草案、待审核、已批准）、负责人、版本、修订日期、适用范围、生效日期及批准记录统一放在文档末尾的“文档管理信息”中。只有已批准且生效的规则可用于员工执行或对外承诺。
- 价格、薪资、储值权益、折扣、奖励、库存阈值和资金权限必须有来源与批准记录；资料不足时保留“待确认”，不得补造数字。
- 原项目聊天、历史版本 Markdown 与转写稿出现冲突时，先核对最新原件和用户明确决定，再更新 Markdown；保留来源，不静默覆盖历史。
- 顾客和员工的身份信息、工资明细、账户、密码及交易明细不进入仓库。这里只存匿名模板、规则与字段说明。
- 文件名按项目约定使用中文；文件内容按字段和物料的实际语言用途编写。中文标题、地址与说明保留中文，英文口号等英文位置使用英文，不因文件名要求翻译内容。
- 纯文字、表格类资料以 `.md` 编辑；需要 PDF 时由 Markdown 导出。需要保留的历史原件内容内聚到对应运营 `.history.md`，标明来源和未批准状态；历史 PDF、Word 不入库。

## 品牌标志

- 可使用 `assets/brand/logo.svg`（标准版）和 `assets/brand/logo-horizontal.svg`（横版）。根据版面选择；不要凭空绘制第三种标志。
- 允许为适配深浅背景调整标志颜色，或制作仅改颜色的衍生版本。不得改字、改变图形路径、裁切关键部分，或分别拉伸宽高使比例变形。常规排版使用等比缩放和完整显示。
- 当标志作为衣服印花、招牌等实物的一部分出现在生成图片或场景合成中，可顺着透视、布料褶皱和曲面做真实变形。这是场景效果，不是新的标准标志；单独展示标志时仍使用未变形的源文件。
- 使用哪个标志，导出时就必须能加载该源文件；缺失时终止导出，不使用临时替代图。保留清晰可辨的净空与对比度。

## 对外表达与视觉

- 对外使用“活动”“场次”“发牌员”“酒水套餐”“计分牌”等口径；不使用“赛事、比赛、参赛、NPC、入场券、酒水券、筹码”，不引入积分兑换或旧积分奖励。
- 广告画面整体风格以深色基底、暖白或暖金局部强调，突出社交、酒饮与桌游体验。
- 后续广告物料优先呈现真实、自然的朋友互动与酒馆暖光；可出现扑克牌等桌游元素，作为克制的场景点缀，让人物交流和现场氛围成为视觉重点。具体画面按物料用途与尺寸取舍，保持关键信息清晰可读。
- 背景图可按物料的实际打印尺寸和画面比例，使用生图工具生成朋友互动、人物交流及少量扑克牌等桌游道具点缀的场景；制作时预留文字与二维码区域，并核对导出后的清晰度。
- 所有为广告印刷内容生成的图片（包括背景图和其他配图）必须达到对应物料的打印精度要求。按最终印刷尺寸、裁切比例和印厂要求核对有效分辨率；不足时重新生成或取得合格源图，不以单纯放大文件尺寸代替清晰度。
- 广告标题、价格、岗位、地址等关键信息保持为 HTML/SVG 文本，不烘焙到生成背景中。背景图只承担氛围。
- 广告标题可使用具有表现力的艺术字体或字形排版，呼应酒馆氛围；优先使用可合法印刷且导出时可稳定加载的字体。艺术处理不得牺牲远距离辨识度，金额、权益说明和使用规则须清晰易读，关键文字仍保持可编辑。
- 现有主海报保持 80 × 180 厘米竖版比例；其他物料按各自已确认尺寸制作。印刷优先导出 PDF，只有厂家明确需要位图时才导出 PNG。

## 首页与交付检查

- 所有首页预览在弹窗中完成；新增文件类型时更新 `app/preview.js` 和相应构建脚本。修改 Markdown 或 JSON 后运行 `npm run build:previews`；首页只预览 Markdown、JSON 与广告页面，历史来源内容由对应变更记录 Markdown 预览。
- 每次修改至少运行 `npm run check`。修改主海报后运行 `npm run export:pdf`；修改大堂海报或导视时运行对应导出命令；修改文字制度并需要 PDF 时运行 `npm run export:docs`。
- 导出前核对文案来源、标志比例、可读性、二维码、链接和页面尺寸。新增源文件须能从 `index.html` 找到；生成物不得代替源文件。

## Git 提交与推送

- 每次完成一项项目改动，运行所需检查、重建预览及相关导出后，自动提交 Git 并推送到当前分支对应的远程分支；此操作已获用户持续授权，无需逐次确认。
- 提交信息简要说明实际改动；提交前核对差异，不纳入敏感信息、临时文件或与本次任务无关的改动。
- 检查失败时先修复再提交。推送失败时保留本地提交并明确报告原因，不强制推送或覆盖远程历史；完成后报告提交编号与推送结果。