# 星衡财务管理系统 · 用户手册 > 本文档面向财务人员，介绍系统的日常操作流程。建议初次使用按「一、快速上手」的顺序操作。 ## 目录 1. 快速上手（首次使用） 2. 登录与界面 3. 基础资料维护 4. 凭证处理 5. 账簿查询 6. 财务报表 7. 税务管理（核心模块） 8. 出纳与固定资产 9. 进销存管理 10. 凭证附件（影像 / 发票原件） 11. 智能体工作台（🤖 统一对话与任务执行） 12. 电子申报对接（申报网关） 13. 期末处理 14. 系统管理 15. 效率与平台化功能（新） 16. 账号安全与平台能力（高级） 17. 常见问题 ## 1. 快速上手（首次使用） ```mermaid graph LR A[新建账套] --> B[维护基础资料] --> C[录期初余额] --> D[填制凭证] --> E[审核] --> F[记账] --> G[出报表/报税] --> H[结转损益+] --> I[结账] --> J[下月...] ``` 首次使用推荐顺序： 1. 使用管理员分配的账号登录。自部署按交付说明初始化；密码要求以页面显示的当前策略为准； 2. 「系统管理 → 账套管理」新建本单位账套（编码、名称、启用期间），系统自动生成标准科目表； > 按实际建账需要选择启用期间，支持历史年月。期初余额在启用期间录入；凭证还需符合期间状态与业务权限要求。 3. 「基础资料」维护部门、员工、客户、供应商、项目，检查/调整科目（启用辅助核算、新增明细科目）； 4. 「基础资料 → 期初余额」录入启用期间期初余额，点击「试算平衡」确认借贷平衡后保存； 5. 「凭证管理」填制本月凭证 → 勾选「审核」→「记账」； 6. 「财务报表」查看资产负债表/利润表/现金流量表；「税务管理」进行发票与申报管理； 7. 「期末处理」结转损益（生成凭证、审核、记账）→ 结账，进入下一期间。 > 演示账套取决于交付与初始化方式。请先核对当前账套；正式业务不要运行强制导入演示数据的脚本。 ## 2. 登录与界面 - 地址：云端使用管理员提供的地址；本地默认进入 `http://127.0.0.1:8080/app`。会话与验证要求以部署配置为准。 - 顶栏：**账套**切换、**期间**选择（页面所有报表/凭证默认取该期间）、修改密码、退出登录。 - **个人偏好**：可用选项以当前设置页为准，当前界面使用中文与浅色风格。凭证打印抬头与落款在凭证打印设置中维护。 - **每账套界面记忆**：各列表页（凭证、账簿、发票、往来、固定资产、工资、库存、订单……）的常用筛选条件（期间、状态、关键词等）会自动记忆；切换账套后自动加载该账套此前用过的筛选，登录后从服务端同步，重新打开页面或可在不同电脑间同步。记忆按「用户 × 账套」隔离，互不干扰；如需清空，切到别的筛选后再次使用即可覆盖。 - 左侧导航（按业务域分组）：财务核算（凭证管理/账簿查询/财务报表/期末处理）、税务管理、资金与往来（出纳/往来）、资产与人力（固定资产/工资）、业务与集团（进销存/集团）、平台与系统（AI 助手/基础资料/系统管理）——仅显示当前账号有权访问的模块。 - **首页工作台**：经营指标卡（本月收入/累计净利润/资产总额/现金余额及环比同比）、待办与预警（审批/结账/草稿/逾期/消息一键直达）、快捷入口、近 12 月收入利润趋势与收入费用构成、最新凭证。 - **报表穿透联查**：科目余额表点任意行 → 明细账直达 → 点凭证号 → 凭证管理精确定位该凭证；Ctrl+K 全局搜索可直接打开凭证/科目。 - 权限说明：不同角色看到的导航不同；未授权模块不显示，特殊操作（审核/记账/结账/备份/导出/系统参数）按角色授予。 ## 3. 基础资料维护 ### 3.1 会计科目 - 「基础资料 → 会计科目」：树形展示。操作按钮：**加子科**（新增明细）、**修改**、**删除**。 - 字段说明： - 编码/名称：末级科目才可直接记账；子科目编码必须长于上级。 - 类别：资产/负债/权益/成本/损益；方向：余额方向（资产成本费用=借，负债权益收入=贷）。 - 辅助核算：部门/人员/客户/供应商/项目。选中后，该科目凭证行必须填对应辅助项，并可查辅助核算余额表。 - 现金/银行：标记后计入日记账，凭证行可选现金流量项目。 - 已发生业务的科目不能删除、不能调整上级（可停用）。 ### 3.2 辅助与字典 部门、员工、客户、供应商、项目、币种、凭证类别（记/收/付/转）、现金流量项目、工资项目、资产类别——均为「编码+名称」的字典，在对应标签页可直接维护。 ### 3.3 期初余额 - 「基础资料 → 期初余额」选择期初期间（=账套启用期间）→「载入」。 - 「＋ 添加科目行」选择需要期初的末级科目，填借方/贷方余额（只填一方）；启用辅助核算的科目需选择辅助项。 - 录入完成后点击「试算平衡」，**借方合计 = 贷方合计** 才能保存。 - 期初保存后，若后续要修改期初，应先保证启用期间之后没有已记账凭证。 ## 4. 凭证处理 ### 4.1 填制凭证 「凭证管理 → ＋填制凭证」： 1. 选凭证类别（默认"记"）、日期（必须属于当前期间）、附单据数； 2. 填摘要（**每行必填**，留空不能保存，会指出是第几行并标红）；逐行选择科目（输入编码或关键字即时下拉），科目启用辅助核算时该行会出现必填的下拉； 3. 现金/银行科目行可选择现金流量项目； 4. 填写借方或贷方金额（每行只能填一方），底部实时显示借贷平衡校验；**凭证号已按本期该类别的下一可用号自动预填**（如 记-0001），可直接用也可手工改； 5. 若本期该类别已有**断号**（例如删过中间某张），保存前会提示缺号明细，可选择「继续保存」「用空号补上」，或先继续录入、稍后到「期末处理 → 结账检查」用「整理断号」统一重排。 > **凭证保存后的操作**：系统不再弹出打印询问窗口，底部操作栏显示保存结果及后续操作： > 「✓ 凭证 记-3 已保存，本页已切到这张凭证」+ **直接打印 / 打印设置 / 新增下一张** 三个按钮； > 保存后，当前页显示已保存的凭证，页签标题更新为「修改 记-3」。再次保存将修改当前凭证，不新建凭证。 > 点击「新增下一张」后，系统清空表单并开始录入下一张凭证；直接点击「＋ 新增凭证」时，系统复用当前页签。 > 关闭未保存的凭证页签时，系统暂存表单内容；再次新增凭证时可恢复。点击「清空暂存草稿」可删除暂存内容。 > 快捷键说明：**Enter** 在分录格间逐格流转（末行回车自动加行）；在借方/贷方金额格按 **=** 自动借贷平衡（自动填入差额）；**F2** 弹出科目下拉。多行凭证建议先填科目再填金额，删除行用行尾 ✕。 > 摘要联带：用 **Enter** 从摘要格往下一行流转时，新行摘要留空会自动继承上一行（鼠标操作不会触发联带）——因此每行仍需确认摘要非空，留空的行不能保存。 ### 4.2 审核 - 勾选要审核的凭证（或全选）→「审核」。已审核凭证不可修改。 - 取消审核：仅限未记账、未结账期间的凭证。 ### 4.3 记账（过账） - 勾选已审核凭证 →「记账」。**只有已记账凭证才计入账簿与报表**。 - 反记账：仅当后续期间没有已记账凭证时允许，已结账期间不可反记账。 ### 4.4 其他 - 复制：整张复制为新草稿；作废/还原：仅未审核凭证可作废；删除：仅未审核草稿。 - 打印：标准凭证格式（含金额大写）；导出 CSV：当前期间凭证明细，可用 Excel 打开。 - 查询：期间、类别、状态、摘要/号/制单人关键字；多条件查询可按科目、辅助项跨期检索。 ## 5. 账簿查询 | 账簿 | 说明 | |---|---| | 科目余额表 | 标准借贷双栏：期初余额/本期发生额/期末余额 各分借、贷两列，可按「仅末级」过滤，底部合计 + 按类别汇总 | | 总账 | 选科目+期间：期间行（期初、本期借/贷、期末）及本年累计 | | 明细账 | 选科目：逐笔凭证行+逐笔余额（可点查看凭证定位） | | 日记账 | 现金/银行科目逐笔+结存，可打印 | | 辅助核算 | 选科目+辅助项（如 1122 应收账款按客户）：期初/发生/期末 | ## 6. 财务报表 - **资产负债表**：年初余额+期末余额；常规资产负债表项目已按《企业会计准则》编排，**未分配利润只取本年利润+利润分配，不含未结转损益净额**——因此本期未做「结转损益」时报表会如实显示试算不平衡（差额即本期尚未结转的损益），做完结转损益并记账后才恢复平衡；底部显示资产总计/负债权益总计与差价校验。 - **利润表**：本期金额+本年累计金额（取方向发生额，不受期末结转影响）。 - **现金流量表**：直接法，按凭证中的现金流量项目归集，含期初/期末现金。 - 报表项目（改科目映射）：由有权限的管理员按报表模板维护流程处理；不要直接编辑正在使用的数据库。 - > 说明：报表模板公式支持科目编码列表（`1001,1002`）、负号表示减项（`1122,-1231`）、`P&L` 表示未结转损益、`OPENING:MONEY` 表示期初现金；合计行引用行编码。 ## 7. 税务管理（核心模块） ### 7.1 发票管理 登记销项/进项发票（日期、票种、号码、对方、税率、金额、税额），支持批量录入；按税率自动分组的「合计」按钮查看小计。登记后增值税附列资料按税率取数。 ### 7.2 增值税申报表 - 主表数据自动从账簿取数：销项税额（应交增值税-销项税额贷方发生）、进项税额（进项税额借方发生）、进项转出、上期留抵（自动取上次申报记录结转）、应纳税额、期末留抵、本期已缴。 - 附列资料一/二按发票台账税率分组列示；主表与发票数据差异会展示「未开票销售(推算)」提示。 - 操作按钮：**生成结转增值税凭证**（借销项/转出、贷进项、差额挂未交增值税，自动生成草稿，需审核记账）、**打印**、**登记已申报**。 ### 7.3 附加税费 按本期增值税 × (城建税 7% + 教育费附加 3% + 地方教育 2%) 自动计算（税率可在「税种参数」调整），一键**生成计提凭证**（借 6403 税金及附加，贷 2221004/2221005/2221006）。 ### 7.4 企业所得税 按季度预缴简化模型：本年累计营业收入/成本/费用/利润总额 → 应纳税所得额（≤300 万自动按小型微利 5% 实际税负，否则 25%）→ 累计应纳 − 已预缴（申报记录自动汇总）= 本期应补。**登记本季已申报**写入申报记录。 ### 7.5 个人所得税 从各期工资表按**累计预扣法**计算：累计收入 − 累计减除费（5000×月数）− 累计专项附加（工资项目"专项附加扣除"）→ 按年度预扣率表计算累计应纳税额、本期应缴。员工需在「基础资料 → 工资项目」启用"专项附加扣除"项并在工资表填写。 ### 7.6 印花税 「印花税」页：税目（购销合同 0.3‰ 等，可在税种参数维护）→ 填计税金额 → 自动算税 → 保存 → 登记申报。 ### 7.7 税负分析 按年度逐月展示：营业收入、增值税、附加税、所得税计提、实缴税金、增值税税负率、综合税负率。 ### 7.8 税种参数 城建税率、教育附加、所得税率、小微实际税负、个税减除标准、期初留抵、印花税税目（编辑后点保存）。 > ⚠️ 以上均为简化口径（见 README 第五节），正式申报请以税务机关要求为准。 ## 8. 出纳与固定资产 ### 出纳管理 出纳管理提供独立台账和报表，并通过凭证生成与会计核算衔接： - **账户档案**：在该页面建立账户（账户编码 / 类型（银行·现金·其他）/ 账户简称 / 账户名称 / 账号 / 开户行 / 期初余额），并**关联一个末级「现金 / 银行」会计科目** —— 该关联用于确定出纳流水生成凭证时的借贷科目。 - **出纳台账**：录「收 / 支 / 转」三类流水，可附收支项目、往来单位、对方账户名称/账号/开户行、备注。日期不在已结账期间即可录入；**收 / 支必须选收支项目**（生成凭证要靠它确定对方科目）。「转」是账户间划转，系统会写成两行（转出 + 转入）并自动配对，它不属于收支、不进现金流量表。 - **一键生成凭证**：在列表中点击「生成凭证」（全部）或行内「生成凭证」（单条）。收 = 借 账户科目 / 贷 收支项目的对方科目；支相反；转 = 借 转入账户科目 / 贷 转出账户科目。凭证类别按方向自动取「收 / 付 / 转」。**一条流水只生成一次**（重复点不会重复生成）；生成的凭证进「凭证管理」待审核记账。收支项目会写到凭证分录的**现金流量项目**上，现金流量表据此取数，无需重复录入。 - **账户余额表**：任意起止日期，按账户列示期初余额 / 本期收入 / 本期支出 / 期末余额（期初 = 开户金额 + 起始日之前的累计净额）。 - **资金日报 / 月报 / 年报表**：同一张表换粒度，日 / 月 / 年各自按上期余额 + 本期收入 − 本期支出 = 期末余额计算。 - **收支分析表**：按收支项目汇总金额，并给出经营 / 投资 / 筹资 × 流入 / 流出 / 净额矩阵；页面底部会自动把矩阵净额与台账净额对账（转账不计入现金流量），一致时显示「✓ 相符」。 - **资金盘点表**：按截止日期列示各账户的账存金额（按台账累计）与实盘金额，自动算盘盈盘亏，可填原因分析与盘点/监盘人后保存。 - **银行对账**：手动录入或**「导入银行流水」**（CSV：日期,摘要,收方金额,付方金额 或 日期,摘要,金额,方向(收/支)，可下载模板）→ 自动对账（金额相同+日期 5 天内匹配）→ 已匹配/未达；未达记录列示在余额调节表。 - **余额调节表**：企业账面余额、银行对账单余额各自加/减未达项后的调整余额对比，自动显示是否相符。 > 收支项目对应「基础资料 → 现金流量项目」，应核对其中的默认对方科目；未配置时，生成凭证操作将提示补充。直接在凭证管理录入现金或银行分录，不会自动生成出纳流水；相关差异应通过银行对账及余额调节表核查。 ### 多币种与汇率重估（外币业务） - 「基础资料 → 币种」维护汇率（如 USD 7.30）； - 在科目管理中将外币账户（如 银行存款-美元户）币种设为 USD；填制凭证时该行会自动出现**原币/汇率**输入（系统校验 原币×汇率=本币）； - 期末：维护好期末汇率后，「期末处理 → 执行汇率重估」自动计算**汇兑损益**，生成凭证（借/贷外币科目 & 财务费用-汇兑损益 6603003），审核记账即可；「外币科目余额」可查看原币净额与本币余额。 - 注意：月末先做汇率重估，再做结转损益与结账。 ### 固定资产 - 资产卡片：编码/名称/类别/部门/原值/残值/折旧方法/启用期间。 - 折旧计提：选期间 → 试算 → 执行计提 → 生成折旧凭证（借费用科目、贷累计折旧，自动分组）。 - 折旧方法：平均年限法、双倍余额递减法（后期转直线）、年数总和法。 - 处置：填写日期原因后状态变「已处置」，可恢复。 ## 9. 进销存管理 ### 9.0 销售/采购订单与审批流（进销存 → 订单审批） 1. 「＋ 新建订单」选择采购/销售订单、仓库、往来单位、商品行 → 保存为**草稿**； 2. **提交审批**（状态→待审批）→ 具备「订单审批」权限的用户**审批通过**（制单人不能审批自己；驳回退回草稿）； 3. 审批通过后「生成」一键转为**采购入库单/销售出库单**（草稿，关联原订单，不可重复转单）→ 到业务单据审核过账。 ### 9.1 建档 - 「基础资料 → 商品档案」维护商品（编码/名称/规格/单位/参考购售价/税率/存货科目/成本科目）； - 「基础资料 → 仓库」维护仓库（默认“主仓库”）。 ### 9.2 期初库存 「进销存管理 → 期初库存」按商品填数量与成本单价 → 保存（写入库存余额）。 ### 9.3 业务单据 | 单据 | 含义 | 库存 | |---|---|---| | 采购入库单 PO_IN | 采购收货（需选供应商） | 增加，按移动加权更新成本 | | 销售出库单 SO_OUT | 销售发货（需选客户） | 减少（不足拦截），按当前均价结转成本 | | 其他入库单 OTHER_IN | 盘盈/调拨入库等 | 增加 | | 其他出库单 OTHER_OUT | 领用/盘亏等 | 减少（不足拦截） | | 库存盘点单 ADJUST | 按实存差异（行数量=盘盈/盘亏） | 按行增减 | - 流程：**新建单据（草稿）→ 审核（过账，更新库存）→ 生成凭证 → 凭证审核记账**。 - 采购入库单：生成凭证（借存货+进项税/贷应付）； - 销售出库单：**生成成本凭证**（借主营业务成本/贷存货）与**生成收入凭证**（借应收/贷收入+销项税）两个按钮，分别生成、各自幂等；销售收入亦可通过「发票自动入账」处理； - 其他出入库：借/贷费用与存货。 - 反审核：回滚库存（已生成凭证的单据需先删除凭证）。 ### 9.4 查询 - 库存余额：商品×仓库的数量/平均成本/金额；收发存汇总：期间内购入/销售/其他入出数量金额。 - 计价：**移动加权平均**（采购入库自动重算均价，出库按当前均价结转）。 ## 10. 凭证附件与电子档案 > 附件管理位于凭证录入页。原设置中的「电子档案」页签已取消，附件存储与关联功能保留。 1. 在**凭证录入/查看页**点击表头「附件」：上传 PNG/JPG/PDF/WebP（单文件 ≤10MB），填关联单据号（如 记-0001、FP-2024-0001）后保存——新凭证可先传附件，保存时自动绑定到凭证号。 2. 文件以**原始字节**存储于账套数据库（BLOB 表 `attachments`），不散落磁盘文件——备份/迁移即完整归档。 3. 凭证列表每行的「附件」按钮可查看该凭证已归档的影像：在线预览（图片/PDF）、下载原件、删除（需确认）。 4. 应用场景：凭证影像归档（配合凭证号）、电子发票原件归档（配合发票台账号码）、合同/回单等业务附件。 ## 11. 智能体工作台（统一对话与任务执行） 入口为左侧「智能体工作台」。原AI问答、文字解析、体检、报告、预测、往来、库存、政策与协作功能统一在对话内使用。通过输入框底部选择能力，「参数与资料」填写具体条件，点击发送执行；旧链接预选原能力，不自动写入。 结果卡可展开完整报告、明细和依据；「历史报告与协作」查看原存档与任务；合规报告保留认证Excel导出，报告保留打印。凭证体检仅覆盖最新60张未审核草稿。财务报告经营成果使用原利润表累计口径；现金流预测沿用历史均值及原有假设。 原一句话记账在「文字解析凭证」：保留销售、采购、费用、工资、折旧、借款、投资规则。核对分录与实际日期后，检查并提交保存审批。另可使用「记账与复核」严格协作，补充事实、编辑分录、记录人工复核，再批准保存。保存后仍是未审核草稿。 任务支持表单补充、逐项审批、自动续跑、停止、恢复与持久历史。财务、高风险和删除始终由人批准；修改分录需重新复核，旧授权不能复用。未配置模型仍可使用原权限范围内的本地功能；模型辅助与自由规划要求相应档位、有效服务和已配置网关。 模型及其他外部接口仍在「终端管理」设置。点击工作台左下角「返回首页」，再从业务导航进入正式页面。完整操作见[智能体工作台](AI工作台说明.md)，授权与恢复边界见[审批与任务](审批与任务指南.md)。 ## 12. 电子申报对接（申报网关） - 「税务管理 → 电子申报对接」：填写纳税人识别号/名称/地区；选择渠道： - **本地归档**（默认）：提交后生成 XML+JSON 申报文件（`data/filings/`），可人工导入电子税务局申报端； - **HTTP 对接**：配置对接地址与密钥后，系统 POST 统一报文（SHA256 签名），回执自动留痕。 - 支持税种：增值税 / 企业所得税(预缴) / 个人所得税；每次提交生成流水号并记录在「提交日志」。 - 技术对接细节见 `docs/电子申报对接规范.md`。 ## 13. 期末处理 1. 确保本期全部凭证已**记账**（未审核/未记账的凭证会提示）； 2. 「结转损益」：查看试算分录 → 确认生成 → 到凭证管理**审核、记账**该凭证； 3. 「结账」本期间（此后该期间凭证锁定，只能反结账后修改）；反结账要求后续期间无凭证； 4. 年终：12 月结转损益后 →「年度结转」（本年利润 → 未分配利润）生成凭证并审核记账，再结账 12 月； 5. 下一期间直接切换期间日期即可。 ## 14. 设置：系统管理 与 终端管理 > **系统管理**供登录用户管理个人账户、授权账套及所属子用户。 > **终端管理**仅限内置 `admin` 运维账号访问，用于系统部署与运行维护。 > 客户账号不具备终端管理访问权限；授予「系统参数设置」权限或创建自定义管理员角色，不会开放该入口。 > 原来的「用户设置」模块已并入系统管理。 ### 14.1 系统管理（登录用户可访问） - **账户安全（我的）**：两步验证（TOTP 绑定/恢复码）、修改密码、绑定邮箱/手机、最近登录记录。 - **我的账套**：列出当前账号有权访问的账套（编码 / 名称 / 本位币 / 启用期间 / 状态）。切换账套用左上角的账套下拉。 角色获得「账套新建/删除」权限后，可在该页面新建、编辑或删除账套；管理员默认具备该权限。 删除的账套进**回收站**（30 天内可还原，30 天后数据文件才被彻底清除）。未具备该权限时，仅可查看账套信息，相关操作按钮不显示。 - **我的子用户**（仅主用户可见）：管理当前主用户所属的子用户，支持新增、编辑、停用、重置密码及删除， 并可指定角色及可见账套。子用户不占授权席位，其有效权限为所分配角色权限与所属主用户权限的交集。子用户不得获得所属主用户范围之外的权限；主用户权限变更后，子用户有效权限相应调整。账号层级仅支持主用户与子用户两级。 - **我的角色**：主用户可创建角色并分配给所属子用户。超出主用户权限范围的选项不可选，保存时亦会校验权限范围。 系统提供的「全局角色」（系统管理员/会计/出纳/查看员等，由服务方维护）可以分配、不能修改。 两个不同的主用户可以各有一个**同名**角色，互不影响。 - **审计日志**（只读）：本系统所有增删改、审核、记账、结账、备份等操作留痕，可按关键字查询； 有「导出/打印」权限的账号还能导出 CSV 与生成审计月报。**只读，不能修改或删除。** - **业务通知**（需系统配置权限）：企业微信 / 通用 Webhook 地址，审批流程事件（提交/待办/通过/驳回）自动推送；下方是通知日志。 ### 14.2 终端管理（内置 admin 运维账号） > 终端管理由服务方运维人员使用。开通占用授权席位的主用户时，应联系服务方办理。 > 主用户新增所属人员账号时，使用「我的子用户」，详见 14.1。 - **主用户管理**：客户购买的**正式用户**（占授权席位）。新增、指定角色、启用/停用、设置可见账套、 重置密码、强制下线、解锁。标题栏显示「已用 X / 授权 M 个席位」；停用的主用户仍占用授权席位， 超过授权数会**拒绝创建**。内置 `admin` 不占用授权席位、不可删除、不可改名。 - **角色权限**：**全局角色**（所有客户共用），勾选模块访问权与操作权（审核、记账、反记账、结账、作废、工资凭证、税务申报登记、导出、备份、系统参数、**账套新建/删除**）。内置角色：系统管理员/会计/出纳/查看员。 - **账套管理**：系统内所有账套；新建账套自动带标准科目与报表模板。本页还含**备份与恢复**（立即备份当前账套 / 备份系统库 / 备份列表 / 恢复到当前账套，恢复前会自动留一份快照）与**每日自动备份**的开关和保留份数，以及**回收站**（立即清空已过期 / 单个立即清除）。 - **功能开关**：见「18. 效率与平台化功能」一节。 - **安全设置**：密码策略、会话时长、登录锁定（连续失败锁定/解锁）、登录图形验证码、自助注册开关。（自动备份的开关与保留份数在「账套管理 → 备份与恢复」。） - **安全与通道**：**安全告警**（连续失败达阈值、账号锁定、**异地登录（IP 变化）**、**同 IP 多账号探测（自动封禁该 IP 30 分钟）**，推到企业微信机器人/Webhook）+ **消息通道**（SMTP 邮件 / 短信网关：HTTP + HMAC-SHA256 签名，Access Key/Secret 加密存储，是「忘记密码 / 注册验证码」的基础设施）。 - **发票取票服务商**：填写服务方提供的**对接地址**与**密钥**（密钥加密存储、界面只显示「已设置」，留空表示不修改），可点击「测试连接」检查连通性。**这是全局配置：一套地址与密钥，所有账套共用**（v1.3.13 起；各账套用哪个税号取票仍看「基础资料 → 账套税务信息」）。「税务管理 → 发票取票箱」页面上不会出现地址与密钥。 - **整账套导出/导入 JSON 档案**的能力仍保留在接口层（v1.3.12 起不再单设界面，由实施人员按需操作）。**数据库无损迁移**：`node scripts/migrate-db.js --to postgres|oracle --out migrated` 生成目标库 SQL 与行数校验报告（详见 README「数据与运维」）。 ### 官网入口 - 产品官方网站：`http://127.0.0.1:8080/site/index.html`（登录页与顶栏均有「官网」入口），简约布局并标注「上海深空之眼人工智能科技有限公司 出品」；软件本体为原创专有软件（商业授权）。 ## 15. 效率与平台化功能（新） - **消息中心**：右上角 🔔 铃铛显示红点（60 秒轮询）→ 统一待办（审批/结账/草稿/往来逾期）与站内消息；消息全部已读。 - **凭证模板 / 复制 / 红冲**：凭证列表「存为模板」「套用模板」「复制」「红字冲销」（仅限已记账，生成负数金额冲销草稿）。 - **全局搜索**：任意页面按 `Ctrl+K`，搜科目/凭证/客户/供应商/商品/单据/发票。 - **附件联动**：凭证「附件」按钮上传/查看影像（保存在账套库的 `attachments` 表中，按凭证号关联）。 - **打印设置**：凭证管理 → 打印 → 打印设置（抬头/落款，账套级、全账套共享）；凭证列表「模板打印」= A4 套打。v1.3.13 起不再单设「打印模板」页签，套打版式固定为标准 A4，发票清单打印入口已取消。 - **导出中心**（接口 `GET /api/sys/export-bundle`）：一键打包 9 类 CSV（UTF-8 BOM，Excel 不乱码）为 ZIP；v1.3.12 起不再单设界面，由实施人员按需操作。 - **发票取票箱**（税务管理 → 发票取票箱），两条通道取数电票：① **文件批量导入**——从电子税务局「全量发票查询」批量下载数电票文件后，将 **XML / OFD** 文件拖入页面，逐张预览（可改「进项/销项」与「入账科目」，红冲票自动识别）→ 批量入库，可选同时生成凭证草稿（幂等，重复的票自动跳过）；② **服务商取票**——由服务方开通后，管理员在「终端管理 → 发票取票服务商」填对接地址与密钥（普通用户看不到这一页），配置完成后，在取票箱选择期间并点击「立即取票」，获取该税号对应的进项及销项发票。取票与入库都按**「基础资料 → 账套税务信息」的纳税人识别号**区分本方的进销项，未填写时取票按钮不可用。 - **数据仓库 + BI 订阅**：API `POST /api/dw/build` 重建事实表 → 9 项指标库 + 经营者摘要；配置 webhook 后按月推送摘要。 - **RPA 月末机器人**：期末处理 → 月末机器人：12 项预检清单 + 一键执行（自动备份/集团合并补做/通知管理员）。 - **成本进阶**：进销存管理 → 成本核算：新建工单 →「成本核算」（标准=BOM 展平×采购价×数量；实际=5001 等已记账发生）→ 差异分析报告。 - **多准则**：报表切换 企业会计准则 / IFRS 简版 / **US GAAP 简版**。 - **集团外币折算**：集团设置币种（如 USD）→ 合并报表自动按成员汇率折算；成员信息显示币种与折算系数。 - **移动审批**：手机浏览器打开 `http://IP:8080/m/index.html` → 登录 → 选账套 → 通过/驳回。 ## 16. 账号安全与平台能力（高级） - **自助注册**（可选）：管理员在「安全设置」开启「开放自助注册」后，登录页出现注册入口（`/reg.html`）；注册需图形验证码 + 60 秒/IP 限流，默认**需管理员审核**后启用（「用户管理 → 编辑 → 启用」），注册即通知管理员。 - **消息通道（SMTP 邮件 / 短信网关）**：终端管理 → 安全与通道 →「📮 消息通道」配置 SMTP 参数（可发测试邮件）或短信网关（HTTP + HMAC-SHA256 签名，Access Key/Secret 加密存储）；配置后可在「系统管理 → 账户安全（我的）」绑定邮箱/手机号（需一次验证码确认，防冒绑）。 - **密码找回**：登录页「忘记密码」→ `/forgot.html`：图形验证码防滥用 → 发送 6 位验证码到绑定邮箱/手机（10 分钟有效、单次使用、按用途限流）→ 输入新密码重置（密码策略与历史密码防复用仍生效）。 - **安全告警（企业微信）**：终端管理 → 安全与通道 →「🚨 安全告警」：开启 + 连续失败阈值 + 企业微信机器人/Webhook；触发：连续失败达阈值、账号锁定、**异地登录（IP 变化）**、**同 IP 多账号探测（自动封禁该 IP 30 分钟）**、**连续异地登录自动锁定提醒**；全部写入通知日志（channel=alert）。 - **审计与月报**：终端管理 → 审计日志：条件查询、**导出 CSV**、**审计月报（12 个月 × 模块分布 + 操作/用户 Top10）**。 - **账户安全中心**：系统管理 →「账户安全（我的）」：两步验证（TOTP 绑定/恢复码）、修改密码、绑定邮箱/手机、最近登录；管理员可在「用户管理」里强制下线任何用户会话。 - **数据落盘加密**：密码哈希/API 密钥/TOTP 密钥/恢复码/历史密码均以 AES-256-GCM 加密存储于数据库（主密钥 `data/secret.key`，**请与数据库一并备份**，亦可用环境变量 `MZ_MASTER_KEY`）。 ## 17. 常见问题 | 问题 | 处理 | |---|---| | 忘记密码 | 联系有权限的管理员重置；自部署恢复由运维按维护手册处理，不要删除系统数据库 | | 凭证保存报「借贷不平衡」 | 检查各分行借/贷金额合计是否一致（系统按 0.01 精度校验） | | 保存凭证报辅助核算必填 | 该科目已启用某辅助核算，请选择对应对应枚举值 | | 报表数字为 0 | 应确认凭证已「记账」；报表实时取已记账凭证 | | 结账失败 | 该期间还有未记账/未审核凭证，回到凭证管理处理 | | 修改期初余额 | 需要先反结账、删除该期间之后已记账凭证（或使用新的账套） | | 数据备份文件在哪 | `data/backups/`；也可直接复制 `data/set_N.db` 文件归档 | | 换端口 | `set MZ_PORT=9000` 后启动，访问 `http://127.0.0.1:9000` | ## 客户服务与建账（v1.3.29） 客户在「系统管理 → 我的服务」查看套餐、期限、AI 请求额度、服务联系方式和完整建账清单；在「服务问题」提交问题并跟进回复。服务方在「终端管理 → 客户服务」开通、续期或暂停客户服务，在「账套与运维 → 备份验证」创建备份与检查恢复副本。到期后保留查询、导出及服务联系，业务写入暂停；管理员不受客户档位和额度限制。详见《客户服务运营指南》。