快速上手
| 适用对象 | 管理员、运营人员、订单处理人员、资源维护人员 |
|---|---|
| 系统用途 | 管理 Poshmark 订单、订货、发货、面单、资源池、提醒、通知和插件同步 |
| 数据说明 | 业务数据集中保存在 PostgreSQL，后台支持 JSON 导出和导入 |
| 版本说明 | 本文档根据当前系统功能编写，后续功能迭代后可继续补充 |
建议先阅读“快速上手流程”，再按业务模块学习具体功能。
一、系统概览
小恐龙跨境 Poshmark 运营管理系统 是面向 Poshmark 卖家日常运营的管理后台，帮助客户把订单、资源、订货、发货、提醒、面单和插件同步集中到一个系统中处理。
系统适合解决的问题
订单分散在 Poshmark 页面中，不方便筛选、归档和批量处理。
订货、国内物流、发美、到美、上线等流程需要人工记录和跟踪。
店铺、邮箱、手机号、安全信息需要集中维护，避免资源混乱。
面单下载、打印、失败排查需要更清晰的批量处理入口。
多人协作时需要按员工分配可见资源和操作权限。
推荐角色分工
| 角色 | 主要工作 | 常用模块 |
|---|---|---|
| 客户管理员 | 维护账号权限、系统设置、资源池、备份与插件下载 | 账号管理、系统设置、资源池 |
| 订单运营 | 同步订单、筛选订单、批量修改状态、归档异常订单 | 订单中心、工作台、异常看板 |
| 履约/发货人员 | 处理订货单、物流信息、发美批次、到美和预上线进度 | 订货单记录、发货记录、流程看板 |
二、快速上手流程
客户第一次使用时，可以按下面顺序完成基础配置和日常操作。
主要功能
管理员登录后台，配置微信Webhook地址，员工账号的录入。
运营人员安装浏览器插件，用以 Poshmark 订单页面同步销售订单。
在订单中心筛选新订单，按需要批量修改履约状态或预上线状态。
根据订单生成或维护订货单，记录采购和国内物流信息。
发货人员维护发货记录、发美批次、到美状态和上线进度。
需要发货时，批量下载或打印面单 PDF。
管理员定期导出 JSON 备份，便于跨服务器迁移或数据留存。
| 使用建议：建议先用少量订单测试完整流程，确认订单同步、订货、发货、面单下载和提醒都符合团队习惯后，再全面使用。 |
|---|
三、登录与基础操作
用户通过管理员提供的账号登录系统。不同账号可能看到的菜单和数据范围不同。
主要功能
支持账号密码登录。
可根据需要勾选 7 天免登录。
顶部支持搜索、全屏、语言切换、白天/夜晚主题切换等基础操作。
系统采用多标签页方式打开菜单，方便在订单、设置、日志等页面之间切换。
点击右上角刷新图标可以重新加载当前页面数据。
常用操作
1. 打开后台地址，输入账号和密码。
2. 登录成功后进入工作台。
3. 从左侧菜单进入对应业务模块。
4. 如页面数据未及时变化，点击刷新或重新进入页面。
四、工作台
工作台用于快速查看当天待处理事项、资源状态和运营进度，是客户每天进入系统后的第一入口。
主要功能
查看订单总数、待订货、待预上线、店铺数、手机号数量、邮箱数量。
查看待办事项，例如需要预上线的订单和手机号到期提醒。
查看运营进度，例如今日新增订单、今日订货、今日发美、工作流待办。
查看资源状态，例如正常店铺、邮箱库存、Gmail 安全缺口、手机号结构和到期情况。
通过快捷入口快速进入异常订单、订货单记录、工作流待办和邮箱安全管理。
异常看板用于提醒需要处理的问题。
五、订单中心
订单中心是订单管理的核心页面，用于查看、筛选、批量处理和归档订单。
主要功能
支持按店铺、状态、履约状态、预上线状态筛选订单。
支持搜索店铺、买家、商品或订单信息。
支持勾选多条订单后批量处理。
支持按订单 ID 批量修改履约状态、预上线状态和预上线日期。
支持下载订货单、下载面单、打印面单。
支持查看订单详情、删除、归档和回收站管理。
订单状态用于识别 Poshmark 原始订单状态，履约状态用于团队内部流程跟踪。
常用操作
1. 进入“订单业务 -> 订单中心”。
2. 使用搜索框或筛选条件找到目标订单。
3. 勾选需要处理的订单。
4. 选择批量操作，例如修改履约状态或下载面单。
5. 如需查看完整信息，点击订单行右侧“详情”。
| 使用建议：客户可以把订单中心作为每日处理清单：先筛选待订货，再处理国内物流和发美状态，最后维护预上线状态。 |
|---|
六、订货单记录
订货单记录用于把销售订单转成采购和订货跟踪记录，方便采购人员和履约人员协作。
主要功能
按订单生成订货记录。
维护采购状态、订货批次、备注等信息。
记录国内物流公司和国内物流单号。
回填国内物流和发美相关信息。
根据订货单状态跟踪采购进度。
避免订单已售出但未采购、未发货或未回填物流。
常用操作
1. 从订单中心选择需要订货的订单。
2. 生成或进入订货单记录。
3. 填写采购状态、物流公司、物流单号和备注。
4. 订单流程推进后及时更新对应状态。
七、发货记录与流程看板
发货记录和流程看板用于追踪订单从订货到完成的履约流转。
主要功能
维护国内运输、到仓、发美、到美、上线等流程状态。
记录发美批次，便于后续集中查询。
查看工作流待办，减少漏处理。
根据流程状态判断当前订单卡在哪个环节。
帮助团队按固定流程推进订单，而不是依赖聊天记录或表格。
八、面单下载与打印
面单功能用于批量下载或打印订单对应的 PDF 面单。
主要功能
支持勾选订单后批量下载面单 PDF。
支持合并生成 PDF 后直接打印。
下载失败时会显示具体失败原因，便于排查。
常见失败原因包括订单没有面单链接、Poshmark 链接失效、服务器浏览器环境异常等。
面单下载依赖订单同步时获取到的面单链接。
常用操作
1. 进入订单中心，勾选需要下载面单的订单。
2. 点击“下载面单”或“打印面单”。
3. 等待系统生成合并 PDF。
4. 如果失败，根据页面提示处理失败订单。
| 使用建议：如果某些历史订单的 Poshmark 面单链接已失效，需要重新同步订单或到 Poshmark 页面确认该订单是否仍可下载面单。 |
|---|
九、店铺账号管理
店铺账号用于记录 Poshmark 店铺资源，并与邮箱、手机号、订单和员工权限建立关联。
主要功能
新增、编辑和维护店铺账号。
查看店铺绑定的邮箱和手机号。
绑定邮箱和绑定手机号支持输入选择框：已有资源可直接选择，没有匹配项时可按提示新增到邮箱池或手机号池，并自动完成绑定。
批量导入店铺时可自定义字段顺序，店铺用户名为必填字段，用户 ID、绑定邮箱、绑定手机号、状态和备注可按实际数据选择。
批量导入时，如果绑定邮箱或绑定手机号不存在，系统会自动新增到对应资源池；邮箱类型会按项目配置中的邮箱后缀自动匹配。
识别店铺资源是否完整。
删除店铺前会检查是否存在关联订单或资源，避免误删。
员工账号可按店铺分配可见范围。
十、邮箱池管理
邮箱池用于维护客户店铺和账号相关的邮箱资源。
主要功能
记录邮箱、密码、辅助邮箱、状态和备注。
邮箱类型统一使用 Gmail、Apple、Outlook、企业邮箱、自定义等项目配置类型；原 iCloud 统一显示为 Apple。
新增或编辑邮箱时可选择手机号方式：实卡为手动输入手机号，API 接码为可搜索的手机号下拉输入框。
选择已有 API 接码手机号后，系统会自动填入对应接码 URL；输入不存在的手机号并填写 URL 后，保存邮箱时会同步新增到手机号池。
维护 Gmail 安全信息，例如辅助邮箱、2FA 和备用码。
记录邮箱是否已绑定店铺或手机号。
按类型、状态、绑定关系筛选邮箱。
支持批量导入、批量修改类型或状态、批量解绑店铺、批量删除和批量授权给员工。
表格支持列设置，可按工作需要自定义显示或隐藏列。
支持员工可见邮箱范围分配。
| 使用建议：邮箱、密码、2FA、备用码属于敏感信息，客户应只给必要人员开放查看权限。 |
|---|
十一、手机号池管理
手机号池用于管理实卡、API 接码等手机号资源，以及与店铺、邮箱之间的绑定关系。
主要功能
记录手机号、类型、状态、到期时间和备注。
手机号类型可在项目配置中自定义，例如 Poshmark、Gmail、Apple、Outlook、企业邮箱和自定义。
每个手机号类型可设置使用次数，用于控制同一个手机号最多可以绑定几个邮箱或店铺。
维护手机号与店铺、邮箱的绑定关系。
支持手机号到期提醒。
区分实卡和 API 接码资源。
支持批量导入、批量修改类型或状态、批量解绑店铺、批量删除和批量授权给员工。
表格支持列设置，可按工作需要自定义显示或隐藏列。
帮助客户掌握手机号库存和即将到期资源。
十二、项目配置与表格列设置
项目配置用于维护邮箱类型、邮箱后缀匹配规则和手机号类型，表格列设置用于调整各页面表格显示内容。
项目配置
进入“设置 / 项目配置”，可维护邮箱类型和手机号类型。
邮箱类型包含显示名称、类型值和匹配后缀。一个类型可以配置多个后缀，例如 Apple 可配置 icloud.com、me.com、mac.com。
店铺新增或批量导入时，如果输入的邮箱还不存在，系统会根据邮箱后缀自动判断类型；未匹配到后缀时会放入自定义类型。
手机号类型包含显示名称、类型值和使用次数。使用次数代表该类型下单个手机号最多可绑定几个邮箱或店铺。
保存配置后，邮箱池、手机号池、店铺绑定和批量导入会按新配置使用。
表格列设置
各主要列表页面支持“列设置”，可自定义显示或隐藏表格列。
列设置适用于订单中心、订货单记录、发货记录、店铺管理、邮箱池、手机号池、工作流、通知日志和账号权限等常用表格。
设置后会保存在当前浏览器中，刷新页面后仍会保留。
| 使用建议：如果员工只负责某一类工作，可隐藏不相关列，让列表更清爽，减少误操作。 |
|---|
十三、提醒、通知与日志
提醒和通知模块用于把关键待办推送给客户团队，操作日志用于追踪系统内的重要操作。
主要功能
配置预上线提醒天数。
配置提前提醒小时数和重复提醒小时数。
配置手机号到期提醒。
配置周日策略，例如遇到美国周日时提前一天提醒。
配置企业微信 Hook 接收通知。
维护通知模板，查看通知记录。
查看操作日志，了解谁在什么时间做了什么操作。
十四、浏览器插件使用
浏览器插件用于从 Poshmark 页面抓取销售订单，并同步到后台。
主要功能
客户可在系统设置中下载同步订单插件。
插件下载时会自动写入当前后台接口地址。
安装到浏览器后，在 Poshmark 相关页面执行同步。
同步成功后，订单会进入后台订单中心。
如果后台域名、IP 或端口更换，需要重新下载插件。
常用操作
1. 进入“设置 -> 系统设置 -> 插件下载”。
2. 点击“下载同步订单插件”。
3. 在浏览器扩展管理页面开启开发者模式。
4. 加载插件文件夹或安装插件压缩包。
5. 打开 Poshmark 页面，按插件提示同步订单。
十五、账号与权限
账号与权限用于支持多人协作。管理员可以根据岗位分配菜单权限和数据可见范围。
主要功能
支持管理员和员工角色。
员工可分配可见店铺、邮箱和手机号。
可配置编辑订单、删除订单、管理订货单、管理资源、下载插件、系统更新等权限。
权限不足时，对应菜单或操作按钮可能不可见或不可用。
建议客户按岗位最小权限分配，降低误操作风险。
十六、数据备份与迁移
系统支持将业务数据导出为 JSON 文件，并在新服务器或新环境中导入。
主要功能
导出全部数据会导出订单、店铺、邮箱、手机号、订货单、工作流、设置、主题配置、账号和权限等业务数据。
导出的 JSON 文件可用于跨服务器迁移。
导入备份 JSON 后，数据会写入当前服务器的数据库。
JSON 是迁移文件，最终数据仍保存在数据库中。
建议客户在大批量调整、系统更新或服务器迁移前先导出备份。
常用操作
1. 旧服务器进入“设置 -> 系统设置 -> 数据备份”。
2. 点击“导出全部数据”，保存 JSON 文件。
3. 新服务器完成系统初始化后进入同一页面。
4. 点击“导入备份 JSON”，选择旧服务器导出的文件。
5. 导入后刷新页面，确认订单和资源数据是否完整。
十七、常见问题
登录成功但页面没有变化
通常是浏览器缓存或后台未重启导致。可以刷新页面、重新登录，或联系管理员重启后台服务。
订单没有同步进后台
请确认浏览器插件是否已安装、插件接口地址是否指向当前后台、Poshmark 页面是否已加载出订单数据。
下载面单失败
查看页面显示的具体失败原因。常见原因包括订单没有面单链接、链接失效、服务器浏览器环境异常。
看不到某些店铺或资源
可能是账号权限或可见范围限制，请联系管理员检查员工账号的可见店铺、邮箱和手机号。
更新后页面没有变化
通常是后台未重启或浏览器缓存。管理员重启后台后，用户再强制刷新页面。
导入备份后数据仍为空
请确认导入的是系统导出的 JSON 备份，不是 PostgreSQL 的 SQL 备份；导入后刷新页面并确认数据库连接正常。
员工培训建议
第一次培训建议按“插件同步订单 -> 订单中心处理 -> 订货单 -> 发货记录 -> 面单下载 -> 提醒通知”的顺序演示。
正式使用前，建议先用 3 到 5 条订单跑完整流程。
管理员应先完成员工账号、权限和可见资源配置，再让员工开始使用。
重要调整前建议先导出备份。
| 后续功能：更多功能待开发，欢迎提供建议和需求。 |
|---|