资料库/项目文档

整理与使用约定

项目文档

栖页用于保留项目资料的目录结构、交付批次与维护上下文。查阅前,可以先了解下面几项约定。

资料是怎么组织的

交付资料、维护笔记、接口约定和版本记录分别整理为四个集合。每份资料有独立的 DOC- 编号,集合索引与文档清单使用同一组编号关系。

发布包的目录

qiyepages-1.8.2/
├ README.txt
├ docs/integration-guide.txt
├ data/catalog.csv
├ data/collections.json
└ manifest.json

README 保留整理说明,CSV 保存文档索引,JSON 保存集合定义。发布清单记录版本号、整理日期和导出信息。

导出格式

  • CSV 使用 UTF-8,文档行包含编号、集合、标题、状态、日期与版本。
  • 单独导出的 CSV 尾部有一行 _export 元信息,导入文档表时将其排除。
  • JSON 的 _export 字段保存批次信息,集合与文档列表分别存放。

日期与历史版本

页面与索引显示原始发布日期,下载的导出信息用于区分不同批次。维护资料按月份留档,目录记录与对应发布版本保持关联。