智档宝

智档宝是围绕档案业务、库房设备、环境控制、RFID、数字化和现场交付形成的一条产品线。它不是单个 Web 项目，而是一组前端、后端、本地服务、设备程序、固件和定制项目共同组成的系统。

总览草稿

下面这张是讲解“三合一系统”时使用的 Excalidraw 草稿，用于辅助理解产品能力和现场系统之间的大致关系，不作为最终架构定稿。

文档定位

这个目录用于沉淀智档宝研发侧的稳定知识，包括产品能力、系统架构、代码仓库、设备接入、部署交付、调试运维和项目定制。

这里的文档按“先理解产品，再理解系统，再处理开发和交付”的顺序维护。产品线总览只放稳定入口，不承载临时项目记录。

阅读路径

读者	先看	目的
新人研发	1-产品视图	先理解智档宝覆盖哪些业务能力
前端 / 后端	2-系统架构	确认模块边界、服务职责和协作关系
产品 / 测试	1-产品视图	按能力查找业务流程和功能范围
实施 / 运维	4-打包分发、5-备份迁移	查部署、升级、迁移、回滚和现场验证方式
项目负责人	3-开发流程	区分主线、能力线、定制线和历史版本

主线文档入口

章节	解决的问题	适合什么时候看
1-产品视图	智档宝有哪些业务能力，档案、数字化、环境控制、RFID 分别覆盖什么	新人进入产品线、产品/测试确认功能边界
2-系统架构	前端、后端、中间件、本地服务、设备接入和硬件之间怎么协作	开发排查问题、设计新能力、判断故障位置
3-开发流程	版本线、分支关系、代表仓库、版本 hash 和开发演进	找仓库、查版本来源、判断定制线关系
4-打包分发	Linux / Windows 离线包怎么构建、命名、发布和验证	发版、交付、现场安装、确认包来源
5-备份迁移	旧现场怎么备份、换机、迁移、验证和回滚	升级前、重装前、换机前、跨系统迁移前

按场景阅读

场景	建议顺序
新人熟悉智档宝	1-产品视图 -> 2-系统架构 -> 3-开发流程
开发定位线上问题	2-系统架构 -> 3-开发流程 -> 具体功能页
准备正式发版	3-开发流程 -> 4-打包分发
现场部署或升级	4-打包分发 -> 5-备份迁移
换机、重装、跨系统迁移	5-备份迁移 -> 4-打包分发 -> 2-系统架构

目录结构

智档宝
├─ 1-产品视图
├─ 2-系统架构
├─ 3-开发流程
├─ 4-打包分发
└─ 5-备份迁移

维护原则

• 主线能力写在产品线目录，客户差异写到项目定制目录。
• 仓库地址和版本关系优先维护在 3-开发流程，不在每篇文章重复堆列表。
• 项目定制分组要标注来源主线、能力线和差异点，避免多年后无法判断 fork 关系。
• 架构文档只写稳定边界和关键流向，临时方案写到调试或项目记录。
• 打包、发布、备份、迁移和回滚必须写清楚来源包、版本 hash、数据对象和验证动作。
• ShowDoc 导入内容作为历史资料逐步迁移，不直接替代现行研发文档。