Crater版本迁移指南：从v4到v6的平滑过渡方案

Crater版本迁移指南：从v4到v6的平滑过渡方案

【免费下载链接】crater Open Source Invoicing Solution for Individuals & Businesses 项目地址: https://gitcode.com/gh_mirrors/cr/crater

迁移前准备工作

在开始版本迁移前，需完成以下准备工作以确保数据安全和迁移顺利进行：

1. 完整备份

   • 数据库备份：使用mysqldump或数据库管理工具导出当前数据库
   • 文件备份：复制项目根目录下的storage/和.env文件到安全位置
   • 代码备份：通过git clone https://gitcode.com/gh_mirrors/cr/crater获取最新代码前，确保本地修改已提交或备份

2. 环境检查

   • 确认PHP版本≥7.4（推荐8.0+）
   • 检查依赖扩展：mbstring, xml, ctype, json, openssl, tokenizer, bcmath, gd, zip
   • 验证数据库版本：MySQL≥5.7或PostgreSQL≥10

3. 迁移工具准备

   # 安装依赖管理工具
   composer install --no-dev
   npm install
   

v4到v5核心变更与迁移步骤

主要架构变更

v5版本引入了多项重大架构调整，需特别注意以下变更：

1. 多公司支持

   • 新增companies表和用户-公司关联关系
   • 管理员角色变更为"super admin"，支持跨公司管理
   • 数据迁移脚本：database/migrations/2021_11_23_093811_update_crater_version_500.php

2. 客户与发票重构

   • 独立customers表替代原用户关联模式
   • 发票/报价单与客户建立直接关联
   • 迁移逻辑实现：database/migrations/2021_11_13_114808_calculate_base_values_for_existing_data.php

迁移执行步骤

# 1. 应用v5数据库迁移
php artisan migrate --path=database/migrations/2021_11_23_093811_update_crater_version_500.php

# 2. 执行数据转换
php artisan migrate --path=database/migrations/2021_11_13_114808_calculate_base_values_for_existing_data.php

# 3. 更新权限设置
php artisan db:seed --class=PermissionsTableSeeder

数据验证要点

完成迁移后，需验证以下关键数据：

1. 客户数据完整性

   • 确认所有客户记录已正确迁移至新表
   • 验证客户关联的发票、付款记录是否完整

2. 多币种配置

   • 检查默认币种设置是否正确应用
   • 验证汇率转换是否准确：

   // 示例验证代码
   $invoice = \Crater\Models\Invoice::first();
   echo "原金额: {$invoice->total}, 基准金额: {$invoice->base_total}, 汇率: {$invoice->exchange_rate}";
   

v5到v6功能升级与迁移

核心功能增强

v6版本重点提升了财务处理能力和系统灵活性：

1. 销售税管理

   • 新增tax_types表支持复杂税种配置
   • 实现行项目级别的税收计算
   • 相关迁移：database/migrations/2022_01_05_115423_update_crater_version_600.php

2. 交易记录系统

   • 引入transactions表统一管理财务流水
   • 支持多种支付方式集成
   • 架构变更：database/migrations/2021_12_04_122255_create_transactions_table.php

迁移执行与验证

# 1. 应用v6数据库迁移
php artisan migrate --path=database/migrations/2022_01_05_115423_update_crater_version_600.php

# 2. 更新前端资源
npm run production

# 3. 清除缓存
php artisan cache:clear
php artisan view:clear

常见问题解决方案

迁移失败处理

1. 数据库连接错误

   [PDOException] SQLSTATE[HY000] [1045] Access denied for user 'crater'@'localhost'
   

   • 解决方案：检查.env文件数据库配置，确保凭据正确

2. 数据转换超时

   Maximum execution time of 60 seconds exceeded
   

   • 解决方案：修改php.ini增加max_execution_time = 300，或分批执行迁移

功能验证清单

功能模块	验证要点	参考文件
发票管理	编号序列连续性、税率计算准确性	app/Models/Invoice.php
客户管理	联系信息完整性、余额计算正确性	app/Models/Customer.php
报表生成	利润表、销售分析数据准确性	app/Services/ReportService.php

迁移后优化建议

性能优化

1. 数据库索引优化

   -- 为常用查询添加索引
   CREATE INDEX idx_invoices_customer_id ON invoices(customer_id);
   CREATE INDEX idx_invoices_status ON invoices(status);
   

2. 缓存配置

   // .env配置建议
   CACHE_DRIVER=redis
   SESSION_DRIVER=redis
   

安全增强

1. 更新密钥

   php artisan key:generate
   

2. 权限设置

   chmod -R 755 storage/
   chmod -R 755 bootstrap/cache/
   

总结与后续步骤

完成v4到v6的迁移后，系统将获得以下增强：

• 多公司管理能力，支持复杂组织架构
• 完善的多币种和税收处理系统
• 增强的报表分析功能
• 更灵活的自定义字段系统

建议迁移后进行一次完整的数据备份，并关注官方更新渠道获取后续维护信息：

• 项目文档：README.md
• 问题反馈：通过GitHub Issues提交
• 版本更新：定期检查官方仓库获取安全补丁

迁移过程中如遇复杂问题，可参考社区提供的迁移案例或寻求专业支持。

【免费下载链接】crater Open Source Invoicing Solution for Individuals & Businesses 项目地址: https://gitcode.com/gh_mirrors/cr/crater