wxserver/utils/migrate.js

/**
 * 数据自愈迁移
 *
 * Why 放在客户端而不是后端跑一次 SQL：
 *   本项目「本地 wx.Storage 是主真相源，云端只是备份」。在服务端改数据，客户端下次同步
 *   又会把本地的坏数据推上去覆盖掉。只有在每台设备上修，才能真正修干净。
 *
 * Why 每次启动都跑而不是用版本号只跑一次：
 *   本函数是纯检测式的——没有坏数据时不写库、不发请求、零副作用，成本只是遍历一遍数组
 *   （量级是个位数到几十条）。每次都跑还能顺带覆盖「从云端拉回来的坏数据」这种情况，
 *   比记版本号更稳。
 */

const storage = require('./storage')
const sync = require('./sync')
const lunar = require('./lunar')

const REBUILT_PERSON_REMARK = '自动恢复的联系人'
const FALLBACK_PERSON_NAME = '未命名'

/**
 * 迁移一：补齐老数据缺失的农历字段
 *
 * 背景：早期版本有独立的 lunar_birthday 类型，只记公历日期，没有 lunarMonth/lunarDay。
 * 后来改成用 isLunar 标志决定农历与否，这批老数据就变成了「声称是农历、却没有农历字段」。
 * 这种记录会被日期计算安全降级成按公历算——不会崩，但每年的日期是错的。
 * 用它存着的公历日期反算回农历，即可补齐。
 *
 * @returns {Array} 被修复的纪念日（已带上新字段）
 */
function _patchMissingLunarFields(anniversaries) {
  const patched = []
  const next = anniversaries.map(a => {
    if (!a.isLunar) return a
    if (a.lunarMonth && a.lunarDay) return a
    // 没有公历基准就无从反算，保持原样（不制造假数据）
    if (!a.solarYear || !a.solarMonth || !a.solarDay) return a

    const ld = lunar.solarToLunar(new Date(a.solarYear, a.solarMonth - 1, a.solarDay))
    const fixed = {
      ...a,
      lunarYear: ld.year,
      lunarMonth: ld.month,
      lunarDay: ld.day,
      isLeapMonth: ld.isLeap,
      updateTime: Date.now()
    }
    patched.push(fixed)
    return fixed
  })
  return { next, patched }
}

/**
 * 迁移二：为孤儿纪念日重建人员
 *
 * 背景：有些纪念日的 personId 指向已不存在的人员（历史上删人没级联干净）。
 * 首页按 persons 遍历，所以这些记录是隐形的；日历页按 anniversaries 遍历，会显示成「未知」。
 *
 * 做法：用纪念日自带的 personName 重建人员，并且**沿用原来的 personId**，
 * 这样纪念日记录一个字段都不用改，风险最小。
 *
 * @returns {Array} 新建出来的人员
 */
function _rebuildMissingPersons(persons, anniversaries) {
  const known = new Set(persons.map(p => p.id))
  const missing = new Map() // personId -> name

  for (const a of anniversaries) {
    if (!a.personId || known.has(a.personId)) continue
    const name = (a.personName || '').trim()
    const recorded = missing.get(a.personId)
    // 同一个失踪 personId 可能对应多条纪念日，优先采用非空的姓名
    if (!recorded || (recorded === FALLBACK_PERSON_NAME && name)) {
      missing.set(a.personId, name || FALLBACK_PERSON_NAME)
    }
  }

  if (missing.size === 0) return []

  const now = Date.now()
  return Array.from(missing.entries()).map(([id, name]) => ({
    id,
    name,
    nickname: '',
    avatar: '',
    remark: REBUILT_PERSON_REMARK,
    createTime: now,
    updateTime: now
  }))
}

/**
 * 执行迁移。幂等，可重复调用。
 * 任何异常都吞掉，绝不能因为迁移失败导致小程序起不来。
 * @returns {{ lunarPatched: Number, personsRebuilt: Number }|null}
 */
function run() {
  try {
    const anniversaries = storage.getAnniversaries()
    const { next, patched } = _patchMissingLunarFields(anniversaries)
    if (patched.length > 0) {
      storage.saveAnniversaries(next)
      // 逐条推送更新；失败会自动入队，下次启动 flush
      patched.forEach(a => sync.syncOrEnqueue({ kind: 'anniversary', action: 'update', data: a }))
    }

    const persons = storage.getPersons()
    const rebuilt = _rebuildMissingPersons(persons, next)
    if (rebuilt.length > 0) {
      storage.savePersons(persons.concat(rebuilt))
      rebuilt.forEach(p => sync.syncOrEnqueue({ kind: 'person', action: 'add', data: p }))
    }

    if (patched.length > 0 || rebuilt.length > 0) {
      console.log(`[migrate] 补齐农历字段 ${patched.length} 条，重建人员 ${rebuilt.length} 个`)
    }
    return { lunarPatched: patched.length, personsRebuilt: rebuilt.length }
  } catch (e) {
    console.error('[migrate] 迁移失败，已跳过（不影响启动）', e)
    return null
  }
}

module.exports = { run }