使用说明
使用说明
欢迎使用粽子定制柜智能报价系统。本指南将带你从登录开始，完成报价、模板管理与导出、历史记录查询，以及博客功能使用。请按章节查阅。
目录
一、准备工作
- 浏览器：推荐最新版本的 Chrome 或 Edge。
- 账号与权限：普通用户可进行报价与模板使用；管理员可进行用户/角色管理；手机号 18815292408 账号具有博客发布权限。
二、登录与账号
- 访问登录页
/login，输入邮箱/手机号与密码登录。 - 首次使用可在
/register注册。 - 登录后右上角可进入“个人中心”与“退出登录”。
三、首页与导航
首页提供三大功能入口与“快速操作”：
- 手动输入模式：快速输入柜体信息并生成报价。
- CAD 选择模式：上传 DWG/DXF 手动圈选柜体区域，系统计算尺寸。
- 自动识别模式（付费）：AI 识别 CAD 图纸柜体类型与尺寸（如已开通）。
- 快速操作：历史记录、模板管理、系统设置、博客（公开）、博客管理（仅作者显示）。
四、三种报价模式
1. 手动输入模式（/manual）
- 填写柜体名称、尺寸、材质等基础信息。
- 系统根据配置计算投影面积与费用，生成标准化报价。
- 可保存为项目，稍后在“历史记录”查看与编辑。
2. CAD 选择模式（/cad-select）
- 上传 CAD 文件（DWG/DXF）。
- 使用界面工具框选柜体区域，校对尺寸与类型。
- 系统计算尺寸并生成报价；可保存为项目。
3. 自动识别模式（/auto-recognize，付费）
- 上传 CAD 文件，系统自动识别柜体种类与关键尺寸。
- 用户可校准识别结果；生成报价并保存为项目。
五、模板管理与导出
1. 模板列表（/templates）
- 查看模板列表、创建、更新、删除模板。
- 支持设为默认模板、复制模板以快速复用结构。
2. 模板编辑与映射
- 编辑：
/templates/:id/edit（表格/Excel 模型编辑）。 - 字段映射：
/templates/:id/mapping，将业务字段映射到模板变量，用于导出。
3. 导出
- 系统预留导出接口（Excel/PDF 可扩展）。当前导出走
/api/export，将模板与报价数据合成导出。 - 如需自定义格式（公司抬头、印章、水印），可在模板中调整或联系我们支持扩展。
六、历史记录与项目管理
- 历史列表：
/history查看所有保存的报价项目。 - 详情与编辑：
/history/:id、/history/:id/edit可进行复制、更新、删除等操作。
七、系统设置与个人资料
- 系统设置：
/settings配置全局参数（如默认模板、单位、显示项等）。 - 个人资料：
/profile更新姓名、公司信息；支持修改密码。
八、用户与角色权限（管理员）
- 用户管理：
/admin/users查看/编辑用户，支持批量操作。 - 角色管理：
/admin/roles维护角色与权限，控制访问范围。 - 权限原则：JWT 认证、角色权限与资源所有权控制。
九、博客与 SEO
- 公开博客页：
/blog（服务端渲染，含 SEO 元信息、OG/Twitter、JSON-LD）。 - 文章详情：
/blog/:slug自动累计浏览量。 - 管理入口：
/admin/blog（仅手机号 18815292408 可见与发布）。支持标题、链接别名、摘要、封面、SEO 字段、HTML 正文与图片上传。 - 抓取资源：
/sitemap.xml、/robots.txt、/rss.xml。
十、常见问题与排错
1. 无法登录或权限不足
- 确认账号是否激活，若提示权限不足，请联系管理员赋权。
2. 模板列表为空或导出失败
- 先在“模板管理”中创建模板并完成字段映射；导出时选择正确模板与数据。
3. CAD 文件无法识别
- 请确认文件格式为 DWG/DXF，必要时转存为兼容版本；或使用“CAD 选择模式”手动圈选。
4. 博客页面空白或 404
- 确保已发布文章至少一篇；如为本地环境，请访问
http://localhost:3003/blog。
如需功能定制（导出格式、字段扩展、自动识别增强等），欢迎联系支持团队。