深浅色
管理员与部署
这一篇给管理员：开权限、改品牌、换域名、备份、搬服务器这些事。
账号与权限
Q：怎么给员工开权限？
A：权限分两层，两层都要照顾到：
- 企业微信那一层：员工要能打开系统，得先被加进应用的"可见范围"（在企业微信管理后台设置）。
- 系统这一层：员工用企业微信打开系统，默认是普通员工，只能看自己名下的客户和任务；主管能看到本业务线的；管理员看全部。
业务线配置页可以给每条业务线安排成员范围。员工说"菜单少""只能看不能改"，对照上面两层查。
相关：五种角色，分别能干什么、业务线配置
Q：忘了管理员密码怎么办？
A：分两种情况：
- 还有另一个管理员能登录：让他进"设置 → 系统就绪检查"，用"管理员密码重置"给你重置。重置后你下次登录必须先改密码。
- 所有管理员都进不去：找部署这套系统的技术人员，走服务器层面的恢复流程。不要试图直接改数据库里的密码，这条路走不通。
另外：密码连续输错 5 次，账号会锁 15 分钟。等着就行，别一直试。
相关：系统就绪检查
Q：员工离职了，账号要处理吗？
A：员工状态以企业微信为准。离职、停用之后，系统同步时会更新状态：他不能再被分配新客户，也登录不了。
已经存下来的东西不受影响：他名下的聊天记录、客户跟进记录都保留，不会因为离职被删。客户交接以企业微信里的安排为准，系统同步后更新。
相关：员工列表
Q：第一次登录后系统让我必须改密码，能跳过吗？
A：不能，这是安全设计。初始密码只用于第一次登录，改完密码后初始密码就作废了。记得顺手把初始密码从服务器配置里清掉。
相关：系统就绪检查
品牌与域名
Q：怎么改公司名和 Logo？
A：去"设置 → 首次配置向导"，里面有一项叫"品牌与域名"。企业名称、Logo、主题色、版权信息都能改，改完刷新页面就能看到。
相关：首次配置向导
Q：怎么换域名？
A：换域名要动三个地方，顺序别乱：
- 域名解析：把新域名解析到你的服务器。
- 服务器配置：换 HTTPS 证书，并把系统里填的"公开地址"改成新域名，重启服务。
- 企业微信后台：把"可信域名"和回调地址改成新域名。不改这里，企微相关功能会报错。
改完去"系统就绪检查"过一遍。
相关：域名与 HTTPS 配置
服务器与数据
Q：服务器要什么配置？
A：基本要求：
| 项目 | 要求 |
|---|---|
| 系统 | Linux x86_64（ARM 服务器大部分功能能用，但不能用会话存档） |
| 软件 | Docker 24 以上、Docker Compose v2 |
| 配置 | 建议 4 核 CPU、8 GB 内存、40 GB 磁盘 |
| 域名 | 一个能配 HTTPS 的专用域名 |
| 企业微信 | 管理员权限 + 一个自建应用 |
相关：安装前准备
Q：数据存在哪里？
A：客户、聊天记录、素材都存在你自己的服务器上，不上传第三方的云。只有你主动开启 AI 并把数据交给 AI 处理时，相关内容才会按配置发给 AI 服务（默认禁止，而且会先脱敏）。
服务器上，数据分三块：数据库、缓存、上传的文件。密钥单独放在服务器的配置文件里，网页上永远不回显。
相关：安装前准备
Q：能不能把系统搬到别的服务器？
A：能，走"备份 + 恢复"：
- 新服务器装好同一版本的系统；
- 准备好这台服务器的运行配置文件；
- 把备份目录拷过去；
- 执行恢复；
- 核对登录、客户数量、附件、企业微信连接。
恢复前先在别的机器上验证一遍备份，别直接拿正式环境试。
相关：备份与恢复
Q：系统能同时给几家公司用吗？
A：不能。这套系统是"一企一实例"：一家公司一套服务器、一个域名、一个数据库，互不相通。要多服务一家公司，就再部署一套独立的。
相关：这套系统能帮你做什么
备份与升级
Q：备份要备份什么？
A：系统的备份命令会生成一个备份目录，里面有三样加密文件（数据库、上传的文件、缓存状态），外加一份校验清单。恢复前会自动校验完整性。
另外两样东西不在备份里，要单独保管：
- 备份的解密钥匙（丢了备份就打不开）；
- 服务器的运行密钥文件。
建议每月至少做一次"在另一台机器上恢复"的演练。
相关：备份与恢复
Q：备份里有密钥吗？
A：没有运行密钥。备份不包含运行密钥文件（企业微信密钥、数据库密码这些都在里面）。所以备份文件本身不怕被别人拿到——前提是保持加密，正式环境不要关掉加密。
解密钥匙和运行密钥文件，要单独放进公司的密码保险柜。
Q：升级会不会丢数据？
A：正常升级不会。升级流程是先自动做一次完整备份，再换新版本、跑检查；检查不过会自动回到旧版本。升级和回滚都不动数据。
唯一要记住的：绝对不要用会删数据卷的命令（升级文档里标了是哪条），那是唯一能把数据真正删掉的操作。
相关：升级与回滚
Q："能力状态"页显示"未启用"，是什么意思？
A：这项功能当前不可用，页面会写明原因，比如：企业微信没配置、缺某项权限、AI 没开启。按原因去补配置，改完回这一页重新检查。
相关：能力状态
Q："系统就绪检查"页是干嘛的？
A：给你做体检的：域名、登录方式、文件存储、企业微信、AI 这些配置对不对，一页看完。刚装好系统、换过域名、改完配置，都建议跑一遍。管理员密码重置的入口也在这里。
相关：系统就绪检查