FacadeAI 项目信息管理软件 · 用户指引

1.1 我能用这个软件做什么

• 在电脑上集中浏览平台整理的建筑幕墙项目信息。
• 按地区、类别、阶段等筛选项目，快速聚焦与自己材料类型、行业匹配的项目列表。
• 对单个项目查看详细文字信息、项目图片（效果图、立面图、节点图）以及主要联系人信息（仅限有权限用户）。

依据：MainWindow.xaml / ProjectDiscoveryView.xaml / ProjectDetailView.xaml

1.2 使用前需要准备什么

• 账号：由平台管理员为贵司业务人员创建账号，并分配登录邮箱/手机号与初始密码。
  依据：ApplicationDbContext.Users / AuthController / UserService
• 网络：客户端需要保持与平台服务器的正常网络连接，以便获取最新的项目数据和图片。
• 系统环境：Windows 10 或更高版本（64 位），建议分辨率 ≥ 1366 × 768。
  窗口最小尺寸：725 × 500 依据：MainWindow.xaml MinWidth/MinHeight

2.1 获取与安装客户端

• 通过公司内部指定渠道获取安装包（对应 FacadeAi.Desktop 客户端）。
• 安装完成后，桌面会出现 “Facade Workplace” 或类似名称的快捷方式。

依据：MainWindow.xaml Title="Facade Workplace"

2.2 首次启动与基础设置

• 双击快捷方式启动客户端，首次启动会弹出带动画的欢迎窗口，提供“登录 / 注册”选择。
• 软件不要求额外代理配置。
• 若网络不可达，后续加载项目时会看到“请求超时”或“网络连接失败”等提示。

依据：LoginWindow.xaml(.cs)ProjectApiService 超时与异常处理

3.1 登录步骤

• 启动客户端，在欢迎窗口点击“登录”，进入登录表单界面。
• 输入管理员分配的邮箱/手机号和密码，点击“登录”。
• 客户端调用后端认证接口验证成功后，获取 JWT 令牌，用于后续访问项目接口。

依据：LoginViewModel.LoginCommand → IAuthService.LoginAsyncAuthService.LoginAsync / AuthController.Login

3.2 登录常见提示与处理

• “账号或密码错误 / 邮箱或密码错误”
  检查输入是否正确（注意大小写与中英文输入法），多次失败请联系管理员重置密码。
• “请求超时，请检查网络连接” 或 “网络连接失败: …”
  请联系 IT 检查网络。
• “用户未登录或登录已过期，请重新登录”
  表示本地登录状态已失效，按提示退出后重新登录即可。

3.3 账号类型与权限说明

• 普通账号（未开通付费权限）
  可登录、查看匹配后的项目列表；点击“查看详情”时按钮以黄色背景 + 💰 图标提示为升级入口，无法打开完整详情。
• 已开通付费权限账号
  可正常打开项目详情页，查看文字信息、图片与联系人信息。

依据：ProjectDiscoveryView.xaml 中 Button/DataTrigger 绑定 IsUserPaidProjectsController.GetProjectDetail 权限判断

3.4 退出登录

• 点击右上角头像，打开用户菜单，选择“退出登录”。
• 退出后本地 JWT 与会话信息将被清理，下次需要重新登录。

4.1 首页整体布局

• 顶部：菜单栏，包括 “主页、业务线索、幕墙计算、规范查询、建筑翻译、系统造价、更多” 等入口， 右侧为通知铃铛、用户菜单及窗口控制按钮。
• 中部右侧：主要业务内容区，显示项目列表（ProjectDiscoveryView）或项目详情。
• 中部左侧：导航及预留区域，一般供应商不需要频繁操作。

4.2 日常使用入口

• 日常使用主要集中在顶部“业务线索”相关入口，实际加载项目列表与详情视图。
• 右上角铃铛图标：查看新项目线索通知。
• 右上角头像：打开用户菜单（含“检查更新”“帮助”“退出登录”等）。

4.3 状态与提示

• 列表区域会显示当前加载状态与错误说明，如“正在搜索项目…”、“网络连接超时，请稍后重试”等。
• 登录状态失效时，操作会弹出会话过期提示，引导重新登录。

依据：ProjectDiscoveryViewModel.ProgressStatus / ErrorMessage 绑定ProjectApiService.HandleSessionExpiredAsync

5.1 查看项目列表

• 在项目列表页可以看到按时间排序的项目清单，每行展示： 录入时间、项目名称、地点、类别、阶段、幕墙系统、系统面积等关键信息。

5.2 “新”标记与未读项目

• 未读项目行会使用淡黄色背景，项目名称右侧显示红色“新”标签，提示为新线索。
• 阅读后，系统会在后端记录查看行为，用于统计与个性化推荐。

5.3 打开项目详情

• 在项目列表中点击“查看详情”按钮：
• 已开通付费权限账号：直接进入详情页面，查看：
  • 基本信息：项目名称、地点、阶段、投资估算、建设方、设计单位等；
  • 图片：效果图、立面图、系统标准节点图（可点缩略图切换主图）；
  • 联系人：主要对接人及联系方式、微信二维码（如有）。
• 普通账号：按钮以黄色样式提示为升级入口，不会打开详情。

依据：ProjectDetailView.xaml 布局ProjectDetailViewModel.ProjectDetail / RenderImages / Contacts

6.1 按条件筛选项目

• 在列表顶部“项目筛选”区域，可以组合使用以下条件：
• • 项目地点（下拉选择）
  • 项目类别（下拉选择）
  • 项目阶段（下拉选择）
  • 录入时间（开始日期 / 结束日期）
• 点击“搜索”后，客户端会携带筛选条件请求后端，只返回同时满足条件且和你材料/行业匹配的项目。

依据：ProjectDiscoveryView.xaml 筛选 UIProjectDiscoveryViewModel.SearchCommand → ProjectApiService.GetProjectsAsyncProjectsController.GetProjects / ApplyUserMatching

6.2 重置与刷新

• 重置：清空所有筛选条件，回到第一页并重新拉取项目列表。
• 刷新：保留当前筛选和页码，从服务器重新获取数据，同时配合本地缓存检查和更新。

6.3 分页与排序

• 底部分页控件支持“上一页 / 下一页”，可查看更多项目。
• 排序原则由服务器统一控制（例如按录入时间倒序），当前版本不开放自定义排序字段。

7.1 新项目线索提示

• 右上角铃铛图标旁的红点数字表示新匹配项目线索的数量。
• 点击后会弹出通知卡片，例如“系统为您匹配 X 个新项目线索，请查看”。

7.2 操作结果与错误提示

• 在列表或详情顶部，系统会提示当前操作状态，如“正在搜索项目…”、“加载项目详情中…” 等。
• 网络异常或请求失败时，会给出具体文案（如“网络连接超时，请检查网络连接，稍后会自动重试…”）。
• 这些提示便于你截图并反馈给技术支持，辅助排查问题。

8.1 查看当前登录信息

• 点击右上角头像，用户面板会显示当前登录用户的名称，通常来自你的姓名 / 邮箱 / 手机号。
• 名称展示规则由客户端根据用户资料动态组合。

8.2 检查更新与帮助

• 用户菜单中提供“检查更新”和“帮助”按钮，用于检查版本或打开帮助入口。
• 具体行为（如是否弹出公司内部文档链接）由运营方后续配置。

当前桌面客户端不支持用户自行修改个人资料，如需变更，请联系管理员在后台进行配置；可以支持修改密码。

9.1 登录后列表为空或只有少量项目

• 可能原因：
• • 账号尚未配置材料类型或行业类别；
  • 在当前筛选条件下，没有匹配项目。
• 建议操作：
• • 先点击“重置”清空筛选，再点“搜索”；
  • 如仍为空，请联系管理员确认你账号的材料和行业设置。

9.2 项目详情与列表信息不一致，或图片似乎未更新

• 客户端会在本地缓存项目数据与图片，并通过项目版本与更新时间与服务器比对。
• 如短时间内仍看到旧图片，可尝试：
• • 在列表页点击“刷新”；
  • 关闭并重新启动客户端，再重新打开该项目详情。
• 如需彻底清理本地缓存，可删除目录： %LocalAppData%\FacadeAI\Cache （例如 C:\Users\<用户名>\AppData\Local\FacadeAI\Cache），然后重新登录。

9.3 打开项目图片很慢或加载失败

• 首次打开某项目时，需要从云端下载图片，加载速度取决于网络质量。
• 再次打开同一项目时，会优先使用本地缓存，通常会明显加快。
• 若持续出现“网络连接失败”提示，请检查网络或联系 IT；同时可将错误提示截图发给技术支持。

9.4 频繁提示“登录已过期，请重新登录”

• 说明本地保存的登录状态已过期或服务器端会话已清理，属于正常安全策略。
• 退出后重新登录即可。如频繁出现，请记录大致时间和操作步骤，反馈给技术支持用于排查。

10.1 账号使用规范

• 账号仅限本人使用，请勿与无关人员共享，也不要在不受控环境（如网吧）长时间保持登录。
• 在公共电脑上使用后，务必通过用户菜单“退出登录”，再关闭客户端。

10.2 项目信息的合规使用

• 系统中的项目文字、图片等信息均属于平台及相关权利方的机密数据，只限在正常商务接洽和项目评估范围内内部使用。
• 禁止将整库或大批量项目数据导出到外部系统，或在未经授权的情况下对外传播。
• 本地缓存的图片和数据仅用于加速浏览，缓存内容经过加密和水印处理，不应被用于另行保存或对外分发。

10.3 操作行为的记录

• 为保障系统安全与优化体验，服务器会记录登录日志、项目查看记录、异常行为等信息。
• 这类记录主要用于内部风控和服务优化，不会对外公开具体个人行为明细。

11.1 反馈使用问题

• 建议在出现以下情况时及时反馈：
• • 无法登录或频繁掉线；
  • 明显的数据不一致（例如列表与详情严重不符）；
  • 某些项目或图片长期无法加载。
• 反馈时尽量提供：
• • 问题发生的大致时间；
  • 主要操作步骤（例：“登录 → 业务线索 → 搜索广州 → 点击某项目详情”）；
  • 包含错误提示文案的截图。

11.2 业务与账号相关支持

• 如需新开账号、修改材料/行业配置、调整访问权限或升级为付费账号，请联系平台管理员或公司内指定对接人。
• 所有账号与角色的变更均通过后台管理与 API 服务完成，保证审核与追踪。

本指引仅涵盖当前版本已在客户端实现的功能。 未在本文出现的功能（如自助在线支付开通等）在当前版本中暂未提供，后续如有更新，将以新版本说明和运营通知为准。