系统架构

巴别鸟将企业文件管理、内容协作与数据存储分为不同服务层。部署时应分别规划业务服务、数据库、文件存储、搜索及预览转码，并按已启用的功能增加 AI、OCR 和第三方集成服务。

服务分层

层级	职责	部署关注点
用户入口	Web、桌面及移动客户端，提供文件浏览、协作、同步和映射盘入口	各终端功能与操作系统支持范围以对应版本为准
应用服务	账号、组织、权限、文件操作、分享、项目及审批等业务	按并发、业务量及可用性要求拆分或增加节点
数据库	保存业务记录、组织权限及文件元信息	需要数据库服务；标准部署与高可用部署的主备要求不同
文件存储	保存文件内容与版本数据	可按方案使用对象存储、共享存储或挂载盘，规划容量与备份
搜索与转码	建立检索索引，生成文档、图片等预览内容	文件数量、格式及并发影响资源需求；特殊格式需对应模块
异步处理	上传后处理、任务队列与自动化任务	关注排队、失败重试、运行日志和积压监控
AI 与 OCR	文本识别、向量索引、知识检索及模型调用	按启用模块选本地算力或经授权的外部模型 API

客户端负责本地交互、传输、同步与映射盘等功能，服务端负责权限判断、业务处理和云端数据保存。离线缓存或本地保存不等于文件已成功上传，应通过传输状态和云端版本确认结果。

白皮书记录了 Web、桌面与移动端的技术栈及服务化拆分方式，属于文档编写时的实现说明，不代表所有版本都采用相同组件或依赖版本。技术选型、国产化兼容与组件授权应在实施时核对。

数据库保存业务与权限等结构化数据；对象存储保存文件内容。阿里云、华为云等“云平台部署”仍然需要数据库，可按实施支持范围使用独立数据库服务器或合适的托管数据库。不能只准备云服务器与对象存储而遗漏数据库。

缓存与监控按规模和方案选配，不能把高可用/K8S 示例中的所有组件都当成基础单机部署的强制项。数据库兼容范围、主从方案及部署规格见配置建议。

多节点、主备切换和冗余存储用于降低单点故障影响；独立备份用于在误删、损坏或攻击后恢复。两者需要配合，并验证数据库、文件、配置与证书的恢复一致性。历史运行记录不等于永久零故障承诺。

访问入口应使用 HTTPS，账号和文件权限贯穿搜索、预览、下载及第三方调用。对外模型调用、分享和集成需明确数据范围与企业安全策略。