本地后台 · 支付不联网测试 · 未部署线上
CartridgeABC.com后台管理

CartridgeABC 本地后台操作说明

更新日期：2026-10-31 · 适用本机网站 /admin

本说明不包含管理员密码。所有操作仅作用于本地；支付、发货及邮件均未接入外部服务。

1. 登录与导航

  1. 打开「后台首页」，输入现有管理员密码，无需用户名。已登录时直接显示六个工作栏目。
  2. 顶端第一排为商品、客户、销售、报表、工具和设置。第二排显示当前栏目的具体功能；深绿色表示当前栏目。
  3. 点击「后台首页」回到工作入口；「查看前台」打开客户所见网站。「操作说明」随时可查看本页。
  4. 工作结束点击 Logout／退出登录。服务重启或会话过期后需重新登录。

2. 常用操作放在哪里？

要做的事入口
修改单个商品、价格、库存或主图商品 → 商品／价格／库存
批量上传库存后台首页 → 批量上传库存，或工具 → 选择 Inventory
查看缺货、库存未知、缺图商品报表 → 选择相应报表 → Run report
客户资料、地址及账户启停客户 → 客户资料与地址
订单和付款／发货／退款测试销售 → 订单
设置优惠券销售 → Coupon 优惠券
修改说明页文字、审核评价工具 → 页面内容／评价审核
保存公司、税费、运费等设置草稿设置 → 设置草稿

3. 商品、价格与库存

  1. 进入商品管理，按 ProductCode（SKU）或名称搜索，点击对应商品打开编辑。
  2. Product Information：维护商品资料和可售状态。正常显示与允许结账是不同条件；资料已确认的商品才应批准结账。
  3. Product Price：Standard selling price 是实际零售价；RetailPrice 是参考值。QD 及客户价格组目前是参考资料，未启用客户专属定价。数量优惠在相应阶梯中填写。
  4. Product Image：选择或上传对应商品图片。Compatible Printers／See Also 用于维护机型关系与关联商品。
  5. 点击 Apply 保存；Cancel 放弃未保存修改。Change History 查看变更。

库存 0 = 缺货；空白库存表示未知，不等于有货。商品隐藏、未批准结账、无确认售价或库存不足时，可能无法加入购物车。

分类、品牌与供应商分别在商品栏的子菜单维护。当前前台保留三大类及 13 个品牌；不要为日常库存更新新建分类或品牌。图片库与详细内容编辑器属于辅助入口，单个商品优先使用商品管理页。

4. 批量上传与导出

  1. 进入 Utilities，选择 Products、Inventory、Prices、Customers 或 Archive 对应任务。
  2. 先下载该任务的模板，填写 CSV、XLSX 或 XLS。SKU 列设置为文本，避免前导零丢失。库存模板为 ProductCode,Quantity；价格为 ProductCode,StandardPrice（美元金额）。
  3. 选择文件；Excel 多工作表时选中正确的工作表。不要保留公式，先转换成已确认的数值。
  4. 先 Preview，核对每行 SKU、原值及新值；此时尚未应用。出现错误先修改文件。
  5. 确认预览正确后再 Apply。预览有效期 30 分钟；资料有其他修改或预览过期时重新预览。
  6. Worksheet activity 查看应用记录及可用的恢复操作。恢复不会覆盖后来已更改的商品；有冲突时需重新核对。

上限 5,000 数据行，Excel 8 MB。新导入商品不会自动批准销售。Archive 是可恢复的隐藏操作。客户导入仅导入联系资料，不导入密码。当前没有迁移原站客户。

5. 客户 User

  1. 按关键词或 Enabled／Disabled 筛选，点击 New record 新增，或编辑已有客户。
  2. 维护姓名、邮箱、公司和电话。取消 Enabled 会停用账户并撤销其已有登录会话；更换邮箱也会撤销原会话。
  3. 地址簿支持新增、编辑及默认收货／账单地址，保存后用于本地结账。
  4. Prepare password reset link 生成本地一次性重置入口，到 Local mail preview 查看；不会发送邮件，不显示或发送原密码。
  5. Orders 查看客户关联订单。Export customers 下载联系资料 CSV。

Sales People 仅用于联系人、客户归属和佣金参考；员工账户权限在客户 → 员工账户与权限单独管理，见第13节。客户价格组也尚未参与前台定价。

6. 销售 Sales 与 Coupon

  1. 订单可按订单号、PO、客户、状态和日期查询；日期按 UTC。View 打开明细、历史和测试 PDF。
  2. New Sales Order 可选本地客户或游客，商品每行输入 ProductCode, Quantity。先 Preview，再勾选离线测试确认后创建。系统从数据库取价并预留库存。
  3. 手工订单没有配送地址时，运费和税费显示未计算。完整运费／税费测试请走前台结账。
  4. 待付款订单可以模拟付款成功、失败或取消；已付款订单可模拟发货；已付款或已发货订单可模拟全额退款，按实际测试需求选择是否归库。每次操作需确认本地模拟。
  5. PO 和内部备注可单独保存；History 查看状态变化。不得把测试发货当成真实物流发货。

优惠券：销售 → Coupon → New coupon，填写 Code、Percentage（百分比）或 Fixed USD amount（固定美元金额）、最低折前商品金额、可选使用次数和到期时间，勾选 Enabled 后 Save coupon。百分比输入 10 代表 10%；固定金额输入 10 代表 $10。点击列表中的优惠券可编辑；取消 Enabled 并保存即停用。已有 Code 不可直接改名，到期时间按本机时间输入。

使用次数包含待付款订单占用；取消、过期或失败会释放占用，完成购买或退款仍计使用次数。报价在销售 → 报价管理审核，QuoteAccepted 为批准、QuoteOnHold 为暂缓、QuoteReject 为拒绝；Refresh list 重新读取最新记录，已选择的状态按钮禁用。批准报价不预留库存。供应商采购见第14节，部分退货见第15节；均仅本地记录或模拟。

7. 报表 Reports

  1. 选择库存明细、低库存、库存未知、缺图、待复核，或测试销售、每日销售、待付款、税费、发票、付款、库存变更报表。
  2. 按品牌、展示状态和适用日期筛选，再点击 Run report。
  3. 结果显示后选择 CSV／XLSX／XLS，点击 Download report 下载。改变筛选条件后应重新运行。

销售类报告只反映本地测试订单，不是正式财务报表。All products 包括暂存及隐藏商品；数量空白与 0 的含义不同。

8. 内容、评价与设置

工具 → 页面内容：选择页面、编辑文字块，保存会改变本地前台内容。工具 → 评价审核：Approve 批准公开展示；Reject 拒绝或撤回公开展示；Refresh list 更新列表。未经审核不直接发布，已选择的状态按钮禁用。修改内容前请先核对目标页面。

设置有 Company、Tax、Payment、Shipping、Sales Order、Product、Email Template 七类。Save settings draft 只保存草稿，不会自动改变前台、税费、运费或支付运行规则。支持 JSON 文件或粘贴导入预览、草稿导出及历史版本恢复；税率和运费表有校验及模板。邮件模板可本地预览，不发送邮件。

尚未接入：真实支付、SMTP、承运商接口、部分原站高级设置。员工权限、采购及部分退货见第13—15节。请勿将草稿保存提示理解为这些服务已启用。

9. 常见问题

项目文件夹：部署包中的 app 目录。

10. 按钮与保存规则

页面／按钮作用与操作顺序
商品 New Product／搜索／RefreshNew Product 打开空白编辑器；搜索缩小列表；Refresh 重新读取商品。已有商品应先搜索后编辑，避免重复新建 SKU。
商品 Apply／CancelApply 保存当前商品所有页签的字段，并校验售价、库存和兼容机型；Cancel 关闭未保存编辑。Change History 可查看记录。
商品批量上传／导出批量按钮统一进入 Utilities，默认库存任务；更新价格时将 Operation 改为 Update Product Price。Export product list (CSV) 是商品列表导出，完整 Excel 导出在 Utilities。
分类 Save Category／行内 Cancel分类列表中勾选或调整排序后，Save Category 保存整批行内修改；Cancel 重载取消。编辑单条记录时使用记录编辑器的 Apply／Cancel，两者不是同一批操作。
品牌／供应商 Add／Apply／Cancel新增及编辑资料；上传 Logo 后仍需 Apply 才关联到记录。Remove logo 仅清除草稿选择，需 Apply 保存。13 品牌范围外的新品牌会被拒绝。日常维护不需要修改分类、品牌或商品对应关系。
隐藏／删除／恢复基础资料列表操作影响对应本地记录及展示或关联，先核对记录。Deleted records 查看可恢复记录；有版本冲突时重新加载。请勿为了整理后台入口而修改分类或品牌。
客户 Filter／New record／Save locally／CancelFilter 筛选；New record 新增；Save locally 保存；Cancel 关闭未保存编辑。Customers 与 Sales People 为不同记录；客户导出只在 Customers 下显示。
地址 Save address／Cancel独立保存地址草稿；客户姓名、邮箱未保存的修改不会因保存地址而自动保存。先保存客户资料，再改地址。
Coupon New coupon／Save coupon／Cancel changesNew coupon 开始空白草稿；点击列表编辑已有优惠券；Save coupon 保存；Cancel changes 清除未保存修改，不删除原优惠券。重复保存时按钮暂时禁用；使用记录不能手动清零。
订单 Clear／New Sales Order／Preview／CancelClear 清空查询条件；Preview 只核对数据库当前价格；创建后才预留库存；Cancel 关闭新订单草稿，不等于取消已创建订单。
订单取消／退款／PDF已创建订单需打开详情后，勾选本地测试确认，再使用 Cancel test order 或 Simulate refund。可用按钮取决于订单状态。PDF 为测试文件，不是正式发票。
Utilities Preview／Apply／Cancel previewPreview 不改业务数据；Apply 使用有效预览写入；Cancel preview 放弃预览。改任务、文件或 CSV 后须重新预览；不要将下载模板当成上传完成。
报表 Run report／Download report先运行再下载；下载格式可单独更换。筛选改变后先重新运行。空结果仍可能是正常情况，尤其是尚无客户和订单的本地站。
设置 Save／Cancel changes／Preview import／Apply imported draftSave 保存草稿；Cancel 重载已保存草稿。JSON 可选文件，或展开“或粘贴设置 JSON”后粘贴完整的草稿导出内容（上限2 MB）；粘贴有内容时优先使用粘贴内容，清空后才读文件。先预览再应用；预览后编辑字段、更换文件或修改粘贴内容均会作废旧预览，必须重新预览。保存文件和草稿均不会自动启用前台规则。
设置 Export／表格导出／RestoreExport this draft 导出已保存版本，不包括未保存修改。表格导出同样导出已保存表格；模板是空白示例。Restore this draft version 恢复该次记录保存后的版本，产生一条新历史，不改变前台。
页面内容 Add paragraph／Remove／Save／Restore选择页面后编辑文字块；新增或移除块需 Save page locally 才生效；Cancel page changes 重新加载当前已保存页面，放弃未保存文字。历史先 Preview 对比，再 Confirm restore，恢复会覆盖当前文字并记录新历史。该操作确实影响本地前台内容，当前验收仅在隔离库测试。
图片辅助工具／评价／本地邮件图片选择器可搜索、翻页、关闭或清除选择，最终保存才关联商品。内容修改可能清除结账批准，需再复核。评价按页内审核按钮处理；邮件 Refresh preview 仅重新查询，不发送邮件。重置链接的一次性密码填写由账户使用者完成。
打印／保存 PDF说明页按钮打开浏览器打印预览，选择打印机或“另存为 PDF”，由你确认保存位置。浏览器取消打印不会修改任何网站数据。

11. 验收范围与限制

本轮核对统一导航、各页面入口、搜索、页签、新增与取消草稿、隔离数据库写入流程、导入校验、导出 HTTP 文件、版本冲突及会话保护。对于空客户、空订单、空评价列表，主库不为演示而创建数据。

自动化浏览器的文件选择器受扩展权限限制；Excel 文件通过本地 HTTP 解析与预览测试，不代表已经逐种文件完成系统选择器测试。原生打印预览的最终保存由使用者完成。真实支付、真实邮件、未接入的外部高级功能不属于已完成功能。员工栏目权限现已接入，见第13节。

操作失败先查看页面状态提示：校验错误保留草稿供修正；版本冲突重新加载核对；会话过期先返回后台首页登录。切换页面前先保存或取消，勿把浏览器后退当作已保存。

12. 待确认项补验结果（2026-10-31）

本次用独立临时数据库中的虚构客户、报价、评价和订单补验空列表之外的操作：报价批准→暂缓→拒绝，评价批准→拒绝，测试付款失败后禁止发货与退款；内容取消修改恢复已保存文字；设置 JSON 粘贴预览→编辑后作废→重新预览→应用为草稿。主库没有加入这些验收记录。

JSON 粘贴入口解决不便选择文件时的草稿导入；不是绕过浏览器文件权限。原生文件选择器、浏览器最终打印/PDF保存及真实密码填写仍由使用者完成。员工权限、采购及部分退货现已补齐，详见第13—15节。真实网关、SMTP、承运商及Settings运行启用仍未接入。外部服务仍未接入，当前仍为离线测试系统。

13. 员工账户与栏目权限

入口：客户 User → 员工账户与权限（仅主管理员可见）。员工登录地址 /staff-login；主管理员使用IT设置的独立测试密码和 /admin 登录。员工账户与客户、Sales People 联系资料相互独立。

  1. 新增记录：用户名为3—60位字母、数字、点、横线或下划线；填写姓名、至少14字符初始密码和启用状态。不要使用真实支付密钥作为密码。
  2. 逐项勾选权限：products商品、customers客户、sales订单报价、coupons优惠券、content页面评价、purchasing采购、returns退货、reports报表。read=读取，write=写入；勾write必须同时勾相同栏目的read。建议只授予实际工作需要的栏目。
  3. 保存后员工用独立用户名、密码登录。界面隐藏未获授权的入口，服务端也会拒绝越权请求；知道URL不能绕过权限。
  4. 编辑时密码留空保留原密码；更改权限、密码、用户名或启停会增加版本，原会话立即失效。员工需要重新登录。
  5. 只读员工可以查看对应记录，但不能新增或执行写入。员工管理、设置、批量Utilities、基础分类品牌供应商及旧工具仍仅主管理员操作；采购权限可从现有供应商创建采购单，但不能改供应商主档。

当前权限按栏目读写划分，不含字段级、按客户归属限制或审批双人分离。审计记录在员工、采购、退货各记录的操作历史查看。密码只保存加盐哈希，不回显；操作说明不保存员工密码。编辑过程中若需刷新或切换记录，先保存或取消；刷新会同步读取列表和当前详情的最新版本。

14. 供应商采购与分批收货

入口：商品 Products → 采购单。需要purchasing.read查看、purchasing.write操作。仅本地记录，不会发送订单、付款或邮件给供应商。

  1. 新增记录，选择已启用供应商；商品每行填 SKU,数量,单位成本USD，例如 NBDK1201,5,2.00。单价最多两位小数；同单同SKU不可重复。成本不会覆盖零售价。
  2. 保存生成draft草稿。核对详情后“提交采购单”，变为submitted；这一步不增加库存。草稿可用“编辑采购草稿”修改供应商、商品行、成本及备注后保存；已提交的采购单不允许改行。
  3. 实际本地测试收货时，填写“本次收货”SKU和数量；此处是本次数量，不是累计数量。选择West或East，勾选本地确认，再点击“确认本次收货”。
  4. 部分收到变partially_received；全部收到变received。系统按确认数量增加总库存，并同步已有有效的West/East分仓数量；如分仓合计与总库存不一致，先核对修正再收货。每次收货有请求键和版本保护，重复请求不重复加库存，超收会拒绝，整批失败会回滚。
  5. 刷新列表会同步更新选中采购单详情；有未保存草稿时，先保存或取消再刷新。操作处理中按钮暂时禁用，等待结果再继续。只有未收货的draft/submitted采购单可取消。已部分收货暂不支持取消剩余或供应商退货；继续收货或保留记录，不应通过重做采购来重复入库。

库存未知的SKU不能直接收货加数；先由主管理员确认真实基准库存，再收货。收货会改变本地库存，但不改分类、品牌、售价、图片或销售批准。查看每条采购的操作历史与库存变更报表可核对入库。

15. 部分退货与模拟退款

入口：销售 Sales → 部分退货。需要returns.read查看、returns.write操作。仅支持已付款/已发货的本地测试订单；不会真实扣款或退款，也不发送物流通知。

  1. 新增记录，输入原TEST订单号，每行 SKU,退货数量，填写原因后保存。SKU必须与原订单一致。
  2. 系统生成requested申请，按原订单单价和折扣分摊计算金额，并按商品部分分摊原税费；不退运费、处理费及可识别的运费税。小数按分处理，多次退货累计不会超过原数量或可退金额。
  3. 核对后“批准退货”变approved；“拒绝／撤销退货申请”变rejected并释放数量占用。requested/approved都占用原订单可退数量，防止同时申请超量。
  4. 确认收到需处理的商品后，选择是否归库以及West/East仓库，勾本地测试确认，再点“完成模拟退款与归库”。变completed并记录模拟退款、库存变化和操作人。
  5. 完成操作重复提交不会再次退款或归库；以不同归库选项重做已完成记录会被拒绝。完成详情显示“已按退货数量归库”或“未归库（仅模拟退款）”，请据此核对，不能以页面复选框的当前状态代替已完成结果。已完成不允许直接撤销；不归库的退款也会消耗可退数量。未知库存需先确认基准，或明确选择不归库，不能把未知视为0。

已有非拒绝退货申请时，原订单全单退款接口被阻止，避免重叠退款。原订单保持test_paid/test_shipped状态，订单后台显示部分退款累计；销售和每日销售报告扣除已完成部分退款，新增PartialRefundUSD/AfterPartialRefundUSD列。日期筛选按原订单日期归集，不是退货发生日期。支付对账列表保留原付款流水，部分退款详情以退货记录和订单事件为准。

当前不支持换货、供应商退货、退货运费、信用卡真实退款、线下现金支付或会计系统对接。完成记录是离线测试凭据，不是正式财务单据。

16. 员工、采购与退货的按钮核对说明

情况处理方式
按钮灰色或输入不能修改可能是只读权限、当前状态不允许，或请求处理中。只读员工仍可“查看”及“刷新列表”，但不能新增或执行状态变更。
编辑后刷新、换记录或执行状态操作页面提示先保存或取消当前草稿，防止未保存编辑被覆盖。取消只放弃草稿，不取消原采购单或退货申请。
其他页面已修改同一记录先取消本页未保存草稿，再“刷新列表”；列表与当前详情一起读取最新版本，不应重复点击旧版本的保存或状态按钮。
未勾确认、超量收货或退货根据中文错误提示修正。失败事务不会留下半笔入库或退款；数量须为正整数，收货不得超过未收数量，退货不得超过扣除其他待退申请后的可退数量。
保存请求超时或网络错误先刷新核对是否已经成功。页面为同一次新建采购/退货申请提供重试识别，原资料重试不会新建第二条；修改资料后属于新草稿，不要在未核对前另建同一业务。
请求资料与首次提交不同该请求可能已完成。刷新核对采购收货余量或退货完成结果后再决定下一步，不要试图更改已完成记录的归库方式。
库存未知或分仓不一致请主管理员先核对实际基准。不要把未知库存填成0来绕过校验；取消或失败不会自动更改原库存。
会话过期或权限不足会话过期会显示登录入口并清除表单中的密码。权限不足时返回首页选择获授权栏目；隐藏菜单和服务端权限校验均生效。

本轮以临时库验证了采购双页面刷新、草稿保护、未确认/超量收货修正、只读采购/退货控件禁用、不归库退货完成显示，以及新建/完成重试保护。主库未加入测试员工或业务记录；前台内容不变。