OpenLibrary 中作者与版本标识符输入组件的重构方案

在 OpenLibrary 项目中，存在一个关于作者和版本标识符输入组件的技术重构需求。本文将深入分析当前实现的问题、重构方案以及技术实现细节。

当前实现的问题分析

OpenLibrary 目前对作者和版本标识符的处理存在不一致性：

1. 作者标识符：使用 Vue 组件 AuthorIdentifiers 实现，数据存储在 remote_ids 字段中，格式为键值对
2. 版本标识符：使用传统方式实现，数据存储在 identifiers 字段中，格式为键值对数组

这种不一致性带来了以下问题：

• 代码重复和维护困难
• 用户体验不一致
• 功能扩展受限

重构方案设计

组件功能扩展

计划将现有的 AuthorIdentifiers 组件扩展为通用的 IdentifiersInput 组件，通过配置参数支持两种数据格式：

1. 单一值模式（用于作者标识符）

   • 每个标识符类型只能存储一个值
   • 数据格式：{"viaf": "12319102"}

2. 多值模式（用于版本标识符）

   • 每个标识符类型可存储多个值
   • 数据格式：{"goodreads": ["914886"], "librarything": ["4070590"]}

技术实现要点

1. 组件参数设计：

   • multiple：布尔值，控制是否允许多个值
   • inputPrefix：字符串，指定数据存储路径前缀

2. 数据模型适配：

   • 根据模式参数自动适配不同的数据结构
   • 提供统一的操作接口（添加、删除、验证）

3. 特殊权限处理：

   • 保留对 IA 版本标识符的特殊权限控制
   • 确保只有超级管理员可以添加 IA 标识符

实现步骤

1. 组件重构：

   • 扩展现有组件功能
   • 增加多值支持
   • 实现数据格式转换

2. 页面集成：

   • 替换版本编辑页面的标识符输入部分
   • 确保向后兼容

3. 测试验证：

   • 功能测试
   • 权限测试
   • 数据一致性测试

技术挑战与解决方案

1. 数据格式转换：

   • 在组件内部处理不同格式的转换
   • 确保与后端数据模型兼容

2. 权限控制：

   • 继承现有的权限检查机制
   • 在组件层面实现细粒度控制

3. 用户体验一致性：

   • 保持操作流程的一致性
   • 提供清晰的界面提示

预期收益

1. 代码质量提升：

   • 消除重复代码
   • 提高可维护性

2. 功能扩展性：

   • 更容易支持新的标识符类型
   • 为未来功能扩展奠定基础

3. 用户体验改善：

   • 统一的操作方式
   • 更直观的界面

这一重构将显著提升 OpenLibrary 标识符管理组件的质量和可维护性，为未来的功能扩展提供更好的基础架构支持。