
网站与后台使用手册
从第一台藏车,到每一次客户对话。版本 1.0 · 2026 年 11 月
01 / 启动与登录
安装 Node.js 22 或更新版本。本项目无需安装 npm 依赖。在项目文件夹双击 启动网站.cmd,保留运行窗口。
打开 http://localhost:3000,滚动至官网最底部,点击 Dealer administration ↗。后台也可通过 http://localhost:3000/admin.html 直接进入。
首次进入创建管理员账户:用户名至少 3 位,使用英文、数字或 ._@-;密码至少 12 位,重复输入确认。没有默认用户名或密码。请妥善保存自行设置的账户。
02 / 库存管理
新增或编辑一台车
- 点击「新增车辆」,或库存行右侧「编辑」。
- 上传小于 2 MB 的 JPG、PNG、WebP 主图,或填写公开的 HTTP(S) 图片链接。当前每台车支持一张主图。
- 填写品牌、车型、年款、车身类型、各地区挂牌价、里程与所在地;也可选择“接受报价”,无需填写价格,官网显示“欢迎报价 / ACCEPTING OFFERS”,并勾选可售地区(美国、加拿大、英国;支持多选);品牌、车型、城市与标签使用英文。
- 选择发布状态,点击「保存车辆」。刷新官网后,所有地区访客均可看到更新;可售地区仅标记销售范围。
| 挂牌币种来源 | 实际挂牌货币 | 该地区访客默认里程 |
|---|---|---|
| 美国 US | USD | 英里 mi |
| 加拿大 CA | CAD | 公里 km |
| 英国 UK | GBP | 英里 mi |
分别填写各地区实际挂牌价,至少填一个;留空地区显示询价提示,系统不自动换汇。选择“接受报价”时所有地区均隐藏金额;保存前可切回定价模式,已输入的数值在表单内保留,接受报价保存后则不再保留旧挂牌金额。每台车可独立勾选 US、CA、UK 的可售地区;默认全部可售,全部取消则三地均显示不可售,但不隐藏车辆。里程可切换公里或英里录入,系统统一以英里保存,并按访客地区展示;加拿大编辑表单会按整数公里四舍五入。
发布状态
草稿 后台保留、官网隐藏;新增车辆默认草稿。
展示中 官网所有地区访客都可以看到。
已下架 官网隐藏,保留资料,可重新上架;与草稿分别统计。
已售出 后台保留历史、官网隐藏。
侧边栏「下架记录」按时间保存每次下架的车辆、操作人和下架方式。可搜索、筛选、编辑、重新上架;恢复或删除车辆后历史仍保留。历史从本版本开始记录,不补造旧草稿的下架时间。点击「下架」可隐藏车辆而保留记录;「删除」需要二次确认且不能直接撤销,建议先导出备份。已售车辆重新上架也需确认。搜索可匹配品牌、车型、城市,可售地区与状态可同时筛选。
新版前台与品牌
JZ GARAGE 使用车行提供的标志。所有地区默认浏览相同的已发布库存;右上角地区选择切换里程单位及后台设置的对应地区挂牌价(USD / CAD / GBP),没有地区价格时显示询价提示。AVAILABLE IN 下拉可主动筛选美国、加拿大或英国可售车辆,卡片与详情会显示三地可售状态。价格筛选和排序使用挂牌数字,不自动换汇。点击 The collection 进入库存页;车辆卡片点击 View vehicle 可查看详情、参数、预约看车或获取报价。颜色、变速箱、配置未录入时显示 On request。理念区左侧卡片从当前已发布库存动态生成,支持自动滑动、前后切换、手机轻扫,点击进入详情;可用 Pause / Play 控制播放,悬停或聚焦时暂停,减少动态效果设置下默认不自动播放。无库存时隐藏轮播。当前每车只有一张主图,详情相册为 01/01;微信资料未配置,因此微信入口禁用。检测、漆面、PPF 与质保提示均需向车行确认,不代表已作保证。
03 / 客户询盘
客户通过官网 Enquire 或 Speak with a specialist 提交普通咨询后,后台「客户询盘」可查看。标注 ACCEPTING OFFERS 的车辆会显示报价卡片;客户可填写报价金额、币种(USD / CAD / GBP)、购买地区、邮箱、电话和留言,后台会显示 OFFER 标记、金额及地区。点击「刷新询盘」读取最新记录;点击邮箱可在邮件程序中联系客户,点击电话可拨号。电话输入框提示 Optional,可留空;如填写请包含国家/区号,例如 +1 416 555 0123 或 +44 20 7946 0123。
不需要先上线:本地服务运行时也能保存询盘。官网与后台须使用相同地址和端口,后台侧边栏会显示当前服务地址。连接中断时出现提示和“重新检查连接”;恢复后刷新列表。读取失败不代表没有记录;提交结果未确认时先核对再重试,避免重复提交。
询盘会实际保存,但当前不自动发送邮件或短信。心形收藏仅用于当前页面,刷新后不保留;本版没有客户账号。
04 / 账户设置
进入「账户设置」,输入当前密码和两次新密码。新密码至少 12 位;保存后其他会话失效。完成管理后点击「退出登录」。连续 8 次登录失败将暂时限制 15 分钟。
没有邮件找回密码入口。忘记密码时,先完整备份 data 文件夹,再联系维护人员重置管理员;不要直接删除数据库。
05 / 备份与恢复
库存、图片、客户询盘、下架历史及加密后的账户信息保存在 data/database.json 中,关闭浏览器不会丢失。
- 导出库存:后台点击「导出库存」,保存包含所有库存和上传图片的 JSON 文件,不包含账号或询盘。当前没有一键导入,恢复导出文件需维护人员协助。
- 完整备份:停止运行窗口,复制整个 data 文件夹到安全位置。恢复前也先停服务,再替换 data 文件夹并重新启动。
- 建议每次批量调整前、每周与迁移前备份;data 包含客户个人信息,切勿作为公开静态文件上传。
06 / 常见问题与上线范围
官网看不到车辆?
确认车辆状态为「展示中」,没有被搜索、价格或主动选择的 AVAILABLE IN 地区筛选排除。保存后刷新首页。
连接失败或无法登录?
确认启动窗口仍在运行,并使用 http://localhost:3000 。若出现 EADDRINUSE,表示 3000 端口已被占用,请关闭重复服务。其他端口设置详见项目中的「使用手册.md」。
图片没有显示?
外链可能失效或禁止引用,请改用本地上传。只支持小于 2 MB 的 JPG、PNG、WebP,不支持 SVG。在线字体和示例图片依赖网络。
可以直接让客户访问吗?
当前绑定 127.0.0.1,仅在本机可用。正式发布需服务器、域名、HTTPS、安全 Cookie、备份、真实门店资料及隐私/销售条款和当地价格披露。此版本提供车辆详情视图,但不含支付、融资、多图管理、自动邮件和多角色管理。示例库存与检测承诺需在上线前替换或核实。
视觉方向:哑光黑、反白品牌标志、香槟金价格与主按钮,以及支持减少动态效果设置的轻量动效。