使用手册
1. 登录
- 打开系统网址，输入用户名和密码（账号由管理员提供），点「登录」。
- 如需修改密码，登录后到「设置 → 账户」操作。
- 右上角能看到当前账号，点「退出」可登出。
2. 界面总览
顶部有四个标签页：
- 报价单：所有报价单列表，在这里新建、预览、编辑、删除。
- 价格库：产品/材料/人工的资料和价格，出单时从这里选。
- 设置：公司信息、改密码、添加同事账号。
- 帮助：本手册。
3. 开一张报价单（核心流程）
- 在「报价单」页点右上角 + 新建报价单。
- 基本信息面板：报价单号和日期自动生成，报价单号可手动修改（如与已有单号重复，保存时会提示换一个）；填写客户名称、地址、联系人；需要时调整有效期、报价范围、VAT/WHT 税率。
- 清单明细面板：点「搜索价格库添加明细」框，弹出列表顶部有分类筛选（全部 / 光伏 / 逆变器 / 储能 / 材料 / 人工…），点一个分类只看该类；也可直接输入关键词（明细 / 型号 / 品牌）筛选，点结果即加入清单。
- 填该行的 数量；如果售价或成本要临时调整，直接改「单价」「成本」。其余字段（明细/品牌/型号等）来自价格库，不可改，避免出错。
- 临时的、价格库里没有的项目，点 + 空白行 手动填写。
- 重复添加所有项目。下方会实时显示各项小计、税费、付款额。
- 需要时展开底部「交易条款 / 备注」修改付款方式、银行账号、质保等。
- 点右上角 保存。保存后即可「预览/导出PDF」。
删除某一行：点该行最右侧的「删除」。删除整张报价单：在「报价单」列表点对应行的「删除」。
3.1 整单折扣
折扣只在整单上打一次，不按行打。在明细下方合计区的「整单折扣 Discount」框里填即可：
- 填 50000 → 直接减 50,000 泰铢；填 8% → 按不含税小计的 8% 减。留空 = 无折扣。
- 折扣按不含税小计扣减，扣完再算 VAT，所以客户实际少付的比折扣金额还多一点（含税）。
- 报价单和 PDF 上会单独显示一行「折扣 Discount」，客户看得清清楚楚。
放价管控：折扣超过管理员设定的上限（默认 15%）、或折后亏本 / 毛利过低时，保存前会弹出提醒并记入操作日志。如果管理员开启了「折扣超上限时禁止保存」，超限就存不了，需要找管理员批。
3.2 报价单上的二维码
报价单抬头卖方信息下面可以放一个二维码（微信 / LINE），方便客户直接扫码联系你。
- 先传自己的码：「设置 → 账户 → 我的二维码」，点「选择图片」，可以直接传微信截图。选完会弹出裁剪框——拖动方框对准二维码、拖右下角小方块缩放，把头像和多余文字裁掉，二维码占满方框，客户才好扫。确定即保存。
- 没传个人码的，报价单上会自动用管理员设置的默认二维码。
- 出单时确认：编辑页「基本信息」里有「在本报价单上显示二维码」勾选项，旁边就是本单要用的二维码缩略图——鼠标移上去（手机点一下）会放大，出单前扫一眼确认是不是自己的码。
- 这一单不想放二维码，去掉勾选即可，随单保存，不影响别的单。
- 想换码：点缩略图旁的「换成我的」或「换成默认」，再点保存。（只有存在另一张可换的码时按钮才出现。）
换了微信，老报价单会跟着变吗？不会。报价单在保存时就把当时的二维码存进了这张单，以后你换微信、公司换默认码，老单再打开、预览、导出，显示的还是原来那张。确实需要更新的，打开那张单点「换成我的」再保存即可。
4. 看利润（内部信息，不会出现在客户PDF）
清单里黄色的成本、利润列，以及底部黄色的总成本 / 总利润 / 利润率卡片，只给你（填表人）看。
- 每行利润 =（单价 − 成本）× 数量，括号里是该行利润率。
- 成本来自价格库（采购价），可在该行临时调整。
这些成本和利润绝不会出现在导出给客户的 PDF 上，可放心使用。
5. 投资收益方案（可选，给业主看）
在编辑页展开「投资收益方案」面板，勾选"生成投资收益方案"，报价单 PDF 后会附一页给业主看的投资回报测算。
- 选收益模式：自用（按零售电价省电费，默认）或 上网卖电（按上网电价）。
- 点「按报价单自动填」：装机容量按光伏明细自动算、投资额取付款额（都可手动改）。
- 其余用默认即可：单位发电量 1400 度/kWp·年、零售 4.80 / 上网 2.20 泰铢/度、组件效率 首年98%/第10年90%/末年80%、25 年。
- 面板下方实时显示回本周期 / 总收益 / 首年收益 / 年均收益率；PDF 附页含收益曲线和逐年明细，支持中英/泰语。
这是给客户看的投资回报预估，PDF 会注明假设并附"实际以现场发电为准"的免责说明。组件效率按两段式质保曲线（首年→第10年→末年三个点线性插值）计算，默认 98%/90%/80% 与厂家质保一致，可按实际组件调整。
发电量算法说明（0.99 是怎么来的）
年发电量：第 1 年 = 装机 × 单位发电量；第 2 年起 = 第1年发电量 × 该年组件效率 ÷ 0.99。
这里的 0.99 是"归一化除数"，沿用业务预算表的算法。严格来说它应当等于首年组件效率（98% = 0.98）——因为第 1 年发电量对应 98% 效率，要换算到第 n 年效率，应除以 0.98（即 发电量(n) = 年1 × 效率(n) ÷ 效率(1)）。业务表用 0.99 是个近似（略偏保守，使后续各年发电量约低 1%）；系统沿用 0.99，以便与业务预算表口径一致。若想更严谨，可把它改回 0.98。
6. 预览 · 切换语言/配色 · 导出 PDF
- 在报价单列表点「预览」，或编辑页点「预览/导出PDF」。预览页左上角有「返回」可回到列表。
- 右下角 中英 / ไทย 切换语言：泰语版会把单据文字（含表头、合计、条款等）变泰语，明细用价格库里维护的泰语名。
- 右下角 配色 圆点切换 5 套颜色：蓝色/墨绿/深灰/酒红/橙金。
- 导出有两种方式：
- 下载PDF（推荐，手机首选）：直接生成 PDF 文件，自带配色，保存后可立即分享给客户。
- 打印：走浏览器打印，电脑上可得到可选中文字的 PDF（打印对话框里选「另存为 PDF」，并勾选「背景图形 / Background graphics」以保留底色）。
手机上导出并发给客户
- 打开报价单预览，按需切换语言和配色。
- 点 下载PDF，稍等生成。
- iPhone：在弹出的预览里点右上角「分享」，选微信/LINE/邮件发给客户，或「存储到文件」。
安卓：文件会下载到手机，到通知栏或文件管理里找到该 PDF 再分享。
如果系统是在微信 / LINE 内置浏览器里打开的，下载可能受限——请改用手机自带的 Safari / Chrome 打开本系统再导出。
7. 价格库
- 搜索：顶部输入框可按 明细/品牌/型号 搜。
- 新增/编辑：点「+ 新增条目」或某行「编辑」，填写：类目、类型(筛选分类)、明细(中英)、品牌、型号、参数、单位、销售单价、采购成本、泰语名称(泰语版明细用)、质保、采购渠道。
- 类型决定它在出单选择器里归到哪个分类筛选；留空则系统按名称自动判断。
- 采购目录里很多条目只有成本、没有售价，出单时按报价填「单价」即可。
维护好「泰语名称」，泰语版报价单的明细就会自动用泰语显示。缺泰语名时，可点价格库右上角「一键补全泰语名」，由阿里云翻译自动补齐（译一次永久复用，可再手动微调）。
泰语名维护状态（价格库上方「泰语」筛选，以及泰语名列的标记）：
- 缺失（标红「缺」）：还没填泰语名。泰语版报价单里这条会回退成中英显示。
- 通用占位（标黄「通用」）：泰语名只是这一类的统称、不区分具体型号——比如所有逆变器都填成 อินเวอร์เตอร์、储能都是 แบตเตอรี่เก็บพลังงาน、配件都是 อุปกรณ์เสริม。这是导入采购表时自动填的占位，能正常出单（泰语版旁边还有品牌/型号，本就是英文/拉丁），只是名字不够精确。
- 已填具体：泰语名是这条商品专属、区分了型号的译名。
泰语批量维护：点价格库右上角「泰语批量维护」，会把所有「缺失 / 通用占位」条目一次列出（中英 + 品牌型号对照），逐条改成更具体的泰语后一键保存，改完即变「已填具体」，以后出单自动复用。不改也不影响出单。
8. 设置
- 卖方设置（仅管理员可见可改）：公司名称、地址、联系方式、单号前缀、币种、银行账号（新建报价单时自动带出，单张单里还能单独改）、折扣上限 / 最低毛利 / 是否禁止超限保存、默认二维码。
- 账户（人人可用）：修改自己的登录密码（原密码 + 新密码，至少6位）；上传我的二维码——传了以后你出的报价单默认用这张，没传则用默认二维码。
- 用户管理（仅管理员）：添加同事账号、重置密码、禁用/启用、删除；每行还可「设为管理员 / 降为业务员」随时调整角色。
注意：不能改自己的角色（防止误把自己锁在管理页外），且系统始终保留至少一个启用中的管理员。内置的 admin 账号标有「内置」，不可禁用、删除或改角色（密码仍可重置），以免操作日志失去唯一的查看人。
- 操作日志（仅 admin 账号）：查看报价单的新建、修改、删除记录及具体改了哪些内容；用户角色变更也会留痕。
这一项只有系统内置的 admin 账号能看，其他管理员也看不到——日志是用来复核所有人（含管理员）操作的，看的人和被看的人应当分开。
9. 手机使用
- 「基本信息」「清单明细」是可折叠面板，点标题可展开/收起，减少滑动。
- 明细在手机上变成一行一张卡片，无需左右滑；同样只有数量/单价/成本可改。
- 预览会自动缩放适配手机屏幕宽度；点「下载PDF」即可生成标准 A4 文件直接分享给客户。
- 添加到手机桌面（像 App 一样用）：
iPhone：用 Safari 打开本系统 → 点底部「分享」→「添加到主屏幕」。
安卓：用 Chrome 打开 → 右上角菜单 →「安装应用 / 添加到主屏幕」。
之后从桌面图标打开即可全屏使用（需服务器启用 HTTPS）。
10. 常见问题
报价单号是怎么来的？
规则为 DS + 年月日 + 当日序号（当日从100起，如 DS260625100），自动生成，必要时可在编辑页手动覆盖。
税费怎么算的？
清单金额为不含税价。增值税 VAT = 不含税总额 × 7%；预扣税 WHT = 工时费小计 × 3%（由买方代扣代缴，仅作参考，不计入付款额）；付款额 = 不含税总额 + VAT。税率可在单据上修改。
报价单上的二维码扫不出来？
多半是上传时把头像、昵称一起截进去了，二维码本身太小。重新到「设置 → 账户 → 我的二维码」传一次，在裁剪框里把方框拖到只框住二维码（四周留一点白边即可），二维码占满方框就能正常扫。传完在编辑页把鼠标移到缩略图上放大看一眼，也可以直接用手机扫一下确认。
我换微信了，以前发出去的报价单会变吗？
不会。每张报价单在保存时就把当时的二维码存进了这张单，换码只影响之后新开的单。老单要更新，打开它点「换成我的」再保存。
忘记密码了？
请联系管理员协助重置。
数据安全吗？
所有数据都保存在公司服务器上，由管理员统一维护和备份。
