freedak/chinese-family-tree-2

Fork 0

Files

T

freedakgmail b25f4bea02 0.0.9.0

2025-11-24 16:07:24 +08:00

5.6 KiB

Raw Blame History

🧹 代码清理完成

📝 清理概述

已完成无用文档和代码的清理工作。

🗑️ 删除的文档（19个）

功能开发文档（已过时）

❌ ACTIVITY_LOG_CHANGES_GUIDE.md
❌ FOUNDER_FEATURE.md
❌ FOUNDER_FEATURE_UPDATED.md
❌ FOUNDER_UI_IMPROVEMENTS.md
❌ FOUNDER_UI_FINAL.md
❌ FOUNDER_COMPLETE_SUMMARY.md
❌ FOUNDER_DETAIL_PAGE.md
❌ MEMBER_HISTORY_FEATURE.md
❌ MEMBER_API_HISTORY_INTEGRATION.md
❌ MEMBER_VERSION_HISTORY_FEATURE.md
❌ VERSION_HISTORY_DETAIL_VIEW.md

临时调试文档

❌ TREEID_PARAMETER_FIX.md
❌ TREEID_FINAL_CHECK.md
❌ TEST_API_RESPONSE.md
❌ CLEANUP_SUMMARY.md
❌ CLEAR_CACHE.md
❌ HOMEPAGE_ACTIVITY_LOG.md
❌ MEMBER_NAME_DISPLAY_LOCATIONS.md

已被替代的文档

❌ IMAGE_STORAGE_SOLUTION.md （被 IMAGE_MIGRATION_DONE.md 替代）

🔧 清理的代码

1. `hooks/use-avatar-cache.ts`

清理前：

import { useEffect, useState } from 'react'
import { db } from '@/lib/db'

// 全局图片缓存
const avatarCache = new Map<string, string>()

export function useAvatarCache(avatarImageId?: string) {
  const [avatarUrl, setAvatarUrl] = useState<string | undefined>(...)
  const [isLoading, setIsLoading] = useState(false)
  
  useEffect(() => {
    // 从 IndexedDB 加载...
    db.images.get(avatarImageId)...
  }, [avatarImageId])
  
  return { avatarUrl, isLoading }
}

export function clearAvatarCache() {
  avatarCache.forEach((url) => URL.revokeObjectURL(url))
  avatarCache.clear()
}

清理后：

// 简化的 hook，直接返回 URL
export function useAvatarCache(avatarUrl?: string) {
  return { avatarUrl, isLoading: false }
}

减少： 40+ 行代码

2. `components/ui/image-upload.tsx`

移除的导入：

- import { db } from "@/lib/db"
- import { v4 as uuidv4 } from "uuid"

原因： 不再使用 IndexedDB 和 UUID 生成

3. `components/members/photo-gallery.tsx`

移除的导入：

- import { db } from "@/lib/db"
- import { v4 as uuidv4 } from "uuid"

原因： 照片直接存储 URL，不需要 IndexedDB

4. `app/members/[id]/page.tsx`

清理前：

import { db } from "@/lib/db"

useEffect(() => {
  // 优先使用 avatarUrl（服务器存储）
  if (member?.avatarUrl) {
    setAvatarBlobUrl(member.avatarUrl)
  } 
  // 兼容旧的 IndexedDB 存储
  else if (member?.avatarImageId) {
    db.images.get(member.avatarImageId).then((image) => {
      if (image) {
        const url = URL.createObjectURL(image.blob)
        setAvatarBlobUrl(url)
        return () => URL.revokeObjectURL(url)
      }
    })
  } else {
    setAvatarBlobUrl(undefined)
  }
}, [member?.avatarUrl, member?.avatarImageId])

清理后：

// 移除 db 导入

useEffect(() => {
  if (member?.avatarUrl) {
    setAvatarBlobUrl(member.avatarUrl)
  } else {
    setAvatarBlobUrl(undefined)
  }
}, [member?.avatarUrl])

减少： 10+ 行代码，移除 IndexedDB 兼容逻辑

📊 清理统计

文档清理

删除文档数量： 19 个
保留有用文档： 12 个

代码清理

清理文件数量： 4 个
移除代码行数： ~60 行
移除无用导入： 5 个

保留的有用文档

✅ README.md - 项目说明
✅ CHINESE_LOCALIZATION.md - 中文化指南
✅ DATABASE_SEED_INFO.md - 数据库种子数据
✅ DEPLOYMENT_NOTES.md - 部署说明
✅ LOCAL_DEV_GUIDE.md - 本地开发指南
✅ IMAGE_MIGRATION_DONE.md - 图片迁移完成文档
✅ SERVER_FILE_STORAGE_IMPLEMENTATION.md - 服务器存储实现
✅ docs/BUTTON_PERMISSIONS.md - 按钮权限
✅ docs/BUTTON_USAGE_GUIDE.md - 按钮使用指南
✅ docs/EMAIL_CONFIGURATION.md - 邮件配置
✅ docs/RELATIONSHIP_CALCULATOR.md - 关系计算器
✅ docs/UI_BUTTONS_INVENTORY.md - UI 按钮清单

✨ 清理效果

1. 代码更简洁

移除了所有 IndexedDB 相关的兼容代码
简化了头像加载逻辑
减少了不必要的依赖

2. 文档更清晰

删除了过时的开发文档
删除了临时调试文档
保留了真正有用的参考文档

3. 维护更容易

代码逻辑更直接
没有历史包袱
更容易理解和修改

🔍 仍然保留的 IndexedDB 相关代码

`lib/db.ts`

保留 IndexedDB 定义，因为：

可能有其他功能还在使用
作为历史数据的备份
便于未来的数据迁移

`lib/db-upgrade.ts`

保留数据库升级逻辑，因为：

可能需要处理旧版本数据
数据迁移工具

`types/family.ts`

保留 avatarImageId 字段定义，因为：

数据库 schema 可能还有旧数据
向后兼容性

📋 后续建议

可选的进一步清理

完全移除 IndexedDB
- 如果确认不再需要，可以删除 lib/db.ts
- 移除 dexie 依赖
数据库字段清理
- 从 Prisma schema 中移除 avatarImageId
- 从 types/family.ts 中移除相关字段
依赖清理
```
npm uninstall dexie uuid
```

不建议立即清理的原因

可能有用户数据仍在使用旧字段
需要先完成数据迁移
保持向后兼容性

✅ 清理完成

代码库现在更加简洁和易于维护！

主要改进

✅ 删除 19 个过时文档
✅ 清理 4 个代码文件
✅ 移除 ~60 行无用代码
✅ 简化头像加载逻辑
✅ 保留有用的参考文档

代码质量提升

更少的代码行数
更清晰的逻辑
更少的依赖
更好的可维护性

5.6 KiB Raw Blame History