Suitenumerique/docs项目中的法律页面文档化方案

背景与现状分析

在Suitenumerique/docs项目中，当前的法律页面(如隐私政策、服务条款等)存在一个显著的技术问题：这些内容被硬编码(hard-coded)在系统中，并且直接包含了DINUM(法国政府数字部门)的特定内容。这种实现方式带来了两个主要限制：

1. 可重用性差：由于内容被硬编码且包含特定机构信息，其他组织或项目难以直接复用这套文档系统
2. 维护困难：每次法律条款变更都需要开发人员介入修改代码，而不是由内容管理员直接维护

技术解决方案设计

核心思路

将法律页面内容从代码中解耦，转为使用文档系统管理，具体实现方案包括：

1. 文档化存储：将法律页面内容作为普通文档存储在文档系统中
2. 管理界面：在Django Admin后台为每种法律页面(每种语言版本)提供文档ID配置选项
3. 权限控制：确保这些特殊文档只能由管理员编辑，同时对公众可见

技术实现要点

1. 文档关联机制：

   • 为每种法律页面类型(如隐私政策、服务条款等)创建配置项
   • 支持多语言版本，每种语言关联一个文档ID

2. 权限与可见性：

   • 在管理界面添加明确提示，说明这些文档必须设置为公开可见
   • 实现文档编辑权限限制，确保只有管理员可以修改

3. 前端展示：

   • 保持现有URL路由不变，确保外部链接不受影响
   • 从文档系统动态加载内容而非硬编码展示

替代方案比较

1. 数据库存储方案：

   • 将法律内容存储在数据库表中
   • 优点：结构化管理，查询效率高
   • 缺点：缺乏版本控制，内容编辑体验不如文档系统

2. 混合方案：

   • 使用Markdown文件存储但保留在代码库中
   • 优点：保留版本控制
   • 缺点：仍需要开发人员参与内容更新

最终选择的文档系统方案平衡了易用性和灵活性，最适合需要内容管理员直接维护的场景。

实施建议

1. 分阶段迁移：

   • 第一阶段：实现基础功能，允许关联现有文档
   • 第二阶段：添加权限验证和警告提示
   • 第三阶段：提供内容迁移工具(如需)

2. 文档规范：

   • 为管理员编写专门的操作指南
   • 包含文档命名规范、可见性设置等最佳实践

3. 前端兼容：

   • 保持现有模板结构，仅替换内容获取方式
   • 考虑添加缓存机制提高性能

技术优势

这一改进将为项目带来以下技术优势：

1. 解耦内容与代码：符合关注点分离原则
2. 增强可维护性：非技术人员可直接管理法律内容
3. 提高可重用性：去除机构特定内容，使项目更通用
4. 支持国际化：多语言管理更加规范化

该方案已由核心开发者确认正在开发中，采用前端实现方式，将保持足够的灵活性以便后续定制。