rockarch/cartographer_frontend

cartographer_frontend

镜像概述

cartographer_frontend是一个React应用，为Cartographer提供用户交互前端，用于管理由指定主体/创建者归档的所有档案集合、子集合及各部分（记录组、子组、系列、子系列等）的JSON树表示（简称“排列地图”）。该应用是https://github.com/RockefellerArchiveCenter/project_electron%E7%9A%84%E4%B8%80%E9%83%A8%E5%88%86%EF%BC%8C%E8%AF%A5%E9%A1%B9%E7%9B%AE%E6%97%A8%E5%9C%A8%E4%B8%BARockefeller Archive Center的数字档案管理构建可持续、开放且以用户为中心的基础设施。

核心功能

• 提供可视化界面管理档案集合的多层级JSON树结构
• 支持档案元素的拖拽排序操作（基于react-sortable-tree库）
• 与后端服务集成，实现档案数据的增删改查

使用场景

适用于档案机构（如Rockefeller Archive Center）对数字档案的排列结构进行可视化管理和维护，帮助归档人员高效组织档案层级关系。

配置说明

本地开发

1. 安装https://git-scm.com/%E5%B9%B6%E5%85%8B%E9%9A%86%E4%BB%93%E5%BA%93%EF%BC%9A

   bash
   git clone https://github.com/RockefellerArchiveCenter/cartographer_frontend.git
   

2. 安装Docker后，在根目录执行docker-compose：

   bash
   docker-compose up
   

3. 应用启动成功后，可在浏览器访问http://localhost:8000
4. 停止服务：

   bash
   docker-compose down
   

   若需清除所有数据：

   bash
   docker-compose down -v
   

Docker镜像构建

每次向GitHub主分支推送提交时，仓库会在Docker Hub构建带有latest标签的镜像；创建标签时也会触发构建，以便部署特定版本的应用。

无障碍性说明

拖拽排序界面（基于react-sortable-tree库）存在以下无障碍问题：

• 不支持纯键盘交互（无法通过键盘移动档案元素）
• 屏幕阅读器无法有效读取元素：
  • 顶级元素被标记为“grid” aria-label
  • 拖拽树被识别为0列0行的表格
  • 档案元素的标题和文本无法被读取
  • 按钮与关联组件无有效关联

因该库是目前唯一支持多层树拖拽的工具，故仍在使用。若有更无障碍的替代方案，欢迎提交issue或联系开发团队。

许可证

本代码以MIT许可证发布。