# word

**Repository Path**: obslight/word

## Basic Information

- **Project Name**: word
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-07-04
- **Last Updated**: 2026-07-05

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 客户收益型方案报价模板包

这个文件夹用于以后快速生成客户方案和报价。核心原则是：先讲客户能得到什么，再讲我们基于 SPARK 融合平台交付什么；先把收益、边界、验收说清楚，再写功能和金额。

本套模板默认要把 SPARK 融合平台写进方案和报价，但不能写成大而空的平台概念。每次出现 SPARK，都必须对应客户能看见的效果：更快出样、流程可跑、权限可控、数据可查、报表可导、问题可追溯、后续扩展少返工。

## 文件怎么用

### App 方式：上传资料、澄清事实、生成 Word

推荐使用 Java 可发布版：

```powershell
cd "E:\marketanalysis\outputs\客户收益型方案报价模板包"
.\start-java.ps1
```

打开：

```text
http://127.0.0.1:8765
```

如果要发布到内网服务器：

```powershell
.\start-java.ps1 -HostName 0.0.0.0 -Port 8765
```

然后用 `http://服务器IP:8765/` 访问。详细发布步骤见 `DEPLOY.md`。

App 固定三步：

1. 上传客户资料。
2. LLM 或规则引擎按资料缺口反问澄清事实；不限定固定问题数量，以澄清完成为目的，优先提供 3-6 个选项、推荐项，支持单选、多选和自填入口。
3. 根据确认后的事实生成正式 Word。

如需启用真实 LLM 澄清和 brief 生成，启动前设置：

```powershell
$env:OPENAI_API_KEY="你的 key"
$env:OPENAI_MODEL="gpt-4.1-mini"
```

未配置 `OPENAI_API_KEY` 时，App 会使用规则版澄清问题和规则版 brief 生成，仍可完成 Word 输出。

说明：Java 负责 Web/API/上传/状态和发布运行；Python worker 继续负责资料抽取和 Word 生成。这样既能发布成后端服务，也保留现有 Word 出稿质量。

### 推荐方式：上传资料后自动出 Word

1. 在 `inbox/` 下新建项目文件夹，把客户需求相关资料放进去。
2. 运行 `tools/01_collect_materials.py`，生成 `01_资料汇总.md`。
3. 使用 `prompts/10_上传资料到Word一键流程.md`，让 Codex 根据资料生成 `brief.json`。
4. 运行 `tools/02_build_word_from_brief.py`，输出正式 Word 到 `generated/`。
5. 发出前用 `source/05_出件检查清单.md` 审一遍，删除空话，压实 SPARK 效果、报价边界和服务流程与承诺。

详细步骤见 `workflow/一键出Word操作手册.md`。

### 手工方式：复制模板出稿

1. 先用 `source/03_需求采集表.md` 把客户信息补齐。
2. 用 `source/04_收益测算表.md` 把能量化的收益先算出来，不能量化的写成可核验收益。
3. 把客户资料、需求采集表和收益测算结果贴进 `prompts/00_一键生成方案和报价.md`。
4. 用 `source/01_客户收益型方案模板.md` 和 `source/02_报价模板.md` 整理正式客户材料。
5. 发出前用 `source/05_出件检查清单.md` 审一遍，删除空话，压实 SPARK 效果、报价边界和服务流程与承诺。

## 目录

- `source/01_客户收益型方案模板.md`：客户方案正文模板。
- `source/02_报价模板.md`：报价表、报价说明、分档方案模板。
- `source/03_需求采集表.md`：售前调研时要问清楚的信息。
- `source/04_收益测算表.md`：把客户收益写实、写具体的工作表。
- `source/05_出件检查清单.md`：发客户前的质检表。
- `prompts/`：以后直接复制使用的提示词。
- `inbox/`：客户资料投放区，每个项目一个子文件夹。
- `brief/brief_template.json`：结构化需求模板，Codex 根据客户资料填这个。
- `app-java/`：Java Spring Boot 后端，可本机启动或发布到内网服务器。
- `app/static/`：App 前端页面。
- `tools/01_collect_materials.py`：从 Word/PPT/Excel/PDF/Markdown/TXT/CSV 抽取资料。
- `tools/02_build_word_from_brief.py`：根据 `brief.json` 生成正式 Word。
- `start-java.ps1`：Java 版一键启动脚本。
- `build-java.ps1`：Java 后端打包脚本。
- `DEPLOY.md`：发布说明。
- `generated/`：自动生成的 Word 输出目录。
- `workflow/一键出Word操作手册.md`：上传资料后一键出 Word 的操作说明。
- `examples/示例_办公耗材模块_迷你版.md`：办公耗材小项目写法样例。
- `examples/示例_330千伏电网基建物资计划精准提报助手.md`：330千伏及以上电网基建工程物资计划精准提报助手源文案。
- `examples/示例_330千伏电网基建物资计划精准提报助手-服务流程与承诺版.docx`：330千伏及以上电网基建工程物资计划精准提报助手正式 Word 版，末尾为可直接对客户出具的服务流程与承诺。
- `客户收益型方案报价模板.docx`：Word 汇总模板，由 `build_docx.py` 生成。

## 默认交付节奏

在客户需求范围确认、关键资料齐备、客户按约定配合反馈的前提下，默认写入以下交付节奏：

- 需求确认后 1 周内见到可演示效果，让客户先看到核心流程、关键页面或样例报表。
- 需求确认后 4 周内进入上线测试，形成可试用版本并安排关键用户试跑。
- 需求确认后 8 周内完成本期范围全量交付，包含部署、培训、验收材料和交付确认。

如果涉及复杂接口、历史数据迁移、现场环境不确定、安全测评、跨多部门反复确认等情况，必须在方案和报价中写明这些事项会影响 4 周测试和 8 周交付节奏。

## 服务流程与承诺

在客户需求范围确认、关键资料齐备、客户安排关键人员及时反馈的前提下，可以按以下 6 步写入承诺：

- 启动条件：需求范围、样例数据、清册模板和验收口径确认后，先开展 1 周售前验证。
- 1 周验证：基于 SPARK 融合平台交付可演示效果，让客户看到核心流程、关键页面、样例数据、报表导出或平台复用能力的实际运行效果。
- 成效确认：客户看到并认可成效后，再签署正式合同。
- 正式交付：正式合同签署并完成需求确认后，4 周内形成可上线测试版本，8 周内完成本期范围交付。
- 费用边界：如 1 周内未形成双方认可的可见成效，则本次售前验证不进入正式合同签署环节，我方不收取本次售前验证服务费用；我们会加倍努力复盘改进，也期待下次继续合作。
- 特殊事项：费用免收范围仅限于本次售前验证服务费用；涉及第三方接口、云资源、服务器、短信、电子签章、硬件、现场环境整改等外部成本的，由双方另行确认。

成效不要写虚，要提前定义为可演示、可截图、可导出、可复核的内容，例如：

- 核心流程能从发起、审核、退回、完成跑通。
- 关键角色能看到不同菜单、数据和操作权限。
- 样例台账、报表或导出文件能生成。
- 附件、日志、处理人、处理时间能追溯。
- AI 辅助场景能用样例数据演示，并可人工复核。

注意：如涉及 ERP/ECP 正式接口、等保测评、内网环境、历史数据大规模清洗、跨电压等级扩库或甲方专项审计，双方另行确认费用、周期和验收边界。

## SPARK 融合平台怎么写

不要把 SPARK 写成“平台底座、能力中台、数字化赋能”这类客户感知不到的话。写 SPARK 时要形成一条证据链：

客户现在卡在哪里 -> 复用 SPARK 哪类能力 -> 本期交付什么 -> 客户少做什么事 -> 最后用什么验收。

### 1. SPARK 可复用能力清单

| SPARK 能力层 | 解决的实际问题 | 本期可交付内容 | 验收证据 |
|---|---|---|---|
| 组织账号与角色权限 | 不同部门、岗位、项目人员能看什么、能改什么不清楚。 | 组织架构、账号、角色、菜单权限、数据范围、操作按钮配置。 | 管理员、经办人、审批人、领导账号分别演示。 |
| 表单字段与规则校验 | 线下表格字段不统一，必填、格式、枚举和口径靠人工记。 | 业务表单、字段字典、必填校验、格式校验、枚举选项、模板下载。 | 提交样例数据，演示错误提示、必填控制和模板导入。 |
| 流程状态与待办处理 | 申请、审核、退回、完成、归档状态不清，催办靠人工问。 | 流程节点、处理人、状态流转、退回补正、待办已办、处理意见。 | 跑通一条完整业务单据，查看处理时间和节点记录。 |
| 业务台账与标准库 | 资料散在 Excel、群文件和个人经验里，查找和维护困难。 | 主数据台账、标准库、目录库、规则库、版本状态、启停用管理。 | 按关键词筛选，新增、编辑、停用一条标准数据。 |
| 导入导出与清册校验 | 批量数据靠人工复制粘贴，错漏发现晚，返工多。 | Excel 导入、字段映射、重复校验、问题清单、结果导出、报告生成。 | 导入样例清册，生成问题清单并导出报告。 |
| 报表看板与统计口径 | 领导临时要数时重新汇总，统计口径反复解释。 | 固定指标、筛选条件、统计图表、明细穿透、导出字段。 | 按部门、项目、时间、状态筛选并导出。 |
| 附件归档与操作日志 | 材料、审批意见、处理过程分散，后续审计和追责困难。 | 附件上传、审批意见、操作日志、归档记录、变更记录。 | 查看单据详情中的附件、意见、处理人和时间。 |
| PC、移动端和小程序同源 | 现场提交、后台管理、领导查看分散在不同工具里。 | 移动端填报、PC 管理、领导查看、同一单据多端状态一致。 | 同一业务在移动端提交，PC 端审核和统计。 |
| 消息提醒与异常提示 | 靠人工催办，异常发现晚，关键节点容易漏。 | 待办提醒、超时提示、异常标识、风险提示、处理闭环。 | 制造一条超时或异常样例，查看提醒和处理状态。 |
| 接口与主数据对齐 | 人员、项目、物资、合同等基础数据多处维护，口径不一致。 | 统一身份、组织人员、项目主数据、ERP/ECP/OA 等接口对接范围。 | 用测试账号或样例接口验证同步、查询或回写。 |
| AI 辅助与知识库 | 材料校验、报告撰写、规则问答耗时，且结果需要人工复核。 | 知识库问答、材料校验、报告初稿、风险提示、相似案例参考。 | 用样例资料生成结果，保留引用依据和人工复核记录。 |
| 反馈闭环与版本迭代 | 上线后问题停在聊天记录里，无法沉淀为规则和版本。 | 用户反馈、处理状态、规则修正、版本发布、问题类型统计。 | 提交一条反馈，流转到处理完成并关联版本记录。 |

### 2. 按项目类型选择重点

| 项目类型 | 优先写的 SPARK 能力 | 1 周验证怎么做 | 客户可见收益 |
|---|---|---|---|
| 资料清册类 | 表单字段、标准库、导入导出、规则校验、报告导出。 | 用样例清册跑出问题清单和校验报告。 | 提报前发现错漏，减少后期返工。 |
| 审批流程类 | 组织权限、流程状态、待办已办、退回补正、日志归档。 | 跑通发起、审核、退回、完成全流程。 | 减少催办，责任和节点清楚。 |
| 台账库存类 | 业务台账、出入库记录、库存变化、盘点调整、统计导出。 | 录入一笔入库、出库或调整，查看库存变化。 | 账实更容易核对，月底汇总更快。 |
| 报表管理类 | 指标口径、筛选条件、看板、明细穿透、导出字段。 | 按样例数据生成一张管理报表。 | 减少临时报数和口径争议。 |
| 移动现场类 | 移动端入口、定位/拍照/附件、离线补录、PC 同步。 | 现场角色提交样例，后台同步查看。 | 现场信息少转抄，处理更及时。 |
| AI 助手类 | 知识库、材料校验、报告初稿、风险提示、人工复核。 | 用 3-5 份样例资料生成可复核结果。 | 先减轻整理和校验工作，不承诺自动决策。 |
| 接口集成类 | 身份组织、主数据同步、接口查询、结果回写、异常日志。 | 用测试接口或模拟数据跑一条同步链路。 | 减少重复录入，接口风险提前暴露。 |

### 3. 固定句式

- 方案句式：基于 SPARK 复用【能力】，让【角色】完成【动作】，留下【状态/日志/附件/版本】，生成【台账/报表/问题清单】，最终用【账号演示/样例数据/导出文件】验收。
- 报价句式：SPARK 相关费用不是单独卖平台名称，而是覆盖组织权限、表单流程、台账报表、附件日志、多端入口、AI 可复核场景等可复用能力的配置、装配和验收工作。
- 边界句式：接口、历史数据清洗、正式系统回写、安全测评、现场环境整改、第三方资源费用不默认包含，需按接口条件、数据量和验收边界另行确认。
- 禁用写法：平台底座、能力中台、全面赋能、统一数字化平台、智能中枢、生态闭环。遇到这些词，改成具体页面、流程、数据、导出和日志。

## 写作硬规则

- 每个功能都必须回答三句话：解决什么问题；客户少做什么事或少承担什么风险；怎么验收。
- 不写“提升数字化水平”“打造统一平台”“赋能业务发展”这类空话。要改成“基于 SPARK 把审批状态留痕”“基于 SPARK 自动汇总库存台账”“领导每周可看到 Y 类统计”。
- 没有客户数据时，不编百分比。写“待客户提供历史单量后测算”或“上线后按以下指标复核”。
- 报价不要只按页面数解释。要按 SPARK 复用能力、业务装配工作量、接口数据条件、验收责任解释。
- 未确认的接口、历史数据、现场部署、安全测评、复杂报表、智能分析，一律列为待确认或可选项。

## 快速输出结构

客户材料建议保持下面的顺序：

1. 一页摘要：客户现状、本期交付、可见收益、报价总览。
2. 现状问题：用客户自己的业务语言描述。
3. 建设内容：按业务场景写，并说明哪些由 SPARK 复用，哪些是本期定制。
4. 客户收益：每项对应验收证据。
5. 交付范围：包含什么、不包含什么、哪些待确认。
6. 实施计划：调研、原型、开发、测试、上线、培训、验收。
7. 报价明细：标准建设项、可选项、假设条件、有效期。
8. 验收标准：让客户知道怎样算交付完成。