如何修改Dart分期应用模型并实现管理员分期管理功能

我是Flutter新手，想要实现一个分期应用功能，具体需求如下：

• 管理员可添加分期支付记录并保存至数据库；
• 若选择3个月分期计划则生成对应3个月时长，选择6个月则生成6个月时长，以此类推；
• 管理员可标记客户是否已支付分期，应用同步更新状态。

以下是我已创建的InstallmentsModel代码，请问该如何修改以实现上述功能？

import 'package:flutter/gestures.dart';

class InstallmentsModel {
  final double amount;
  final String installmentPlan;
  final List installemtnPlanwords;
  // final double durationnum;
  final List planMonths;
  // final double monthlyPayment;
  // final String durationWords;
  final bool isPaid;
  final double total;
  // final String monthPaid;
  final String paymentDate;
  InstallmentsModel({
    required this.amount,

    // required this.durationWords,
    // required this.monthlyPayment,
    required this.isPaid,
    // required this.monthPaid,
    required this.planMonths,
    required this.installmentPlan,
    required this.paymentDate,
    required this.installemtnPlanwords,
  }) : total = amount * 3;
}

List<InstallmentsModel> installments = [
  InstallmentsModel(
      amount: 16500,
      installmentPlan: '3',
      installemtnPlanwords: ['Months', 'Years'],
      planMonths: ['October', 'November', 'December'],
      isPaid: true,
      paymentDate: '12 April')
];

1. 重构Model结构，贴合需求逻辑 #

你的现有Model存在冗余注释字段和硬编码逻辑（比如total = amount *3），我们可以调整字段类型和逻辑，让它更适配分期场景：

class InstallmentsModel {
  // 数据库主键，用于唯一标识每条记录
  final String? id;
  // 分期总金额
  final double totalAmount;
  // 分期期数（如3、6，单位默认月）
  final int installmentCount;
  // 每月固定还款额
  final double monthlyPayment;
  // 每一期的支付状态，列表索引对应期数（索引0=第一期）
  final List<bool> paymentStatuses;
  // 记录创建时间，用于自动生成分期月份
  final DateTime createdAt;

  InstallmentsModel({
    this.id,
    required this.totalAmount,
    required this.installmentCount,
    required this.createdAt,
  }) : monthlyPayment = totalAmount / installmentCount,
       // 初始化时所有期数默认未支付
       paymentStatuses = List.filled(installmentCount, false);

  // 自动生成对应期数的月份列表（基于创建日期计算）
  List<String> get planMonths {
    List<String> months = [];
    for (int i = 0; i < installmentCount; i++) {
      DateTime targetMonth = createdAt.add(Duration(days: 30 * i));
      // 可根据需求调整月份格式，比如用intl包的DateFormat获取英文月份名
      months.add("${targetMonth.month}/${targetMonth.year}");
    }
    return months;
  }

  // 标记指定期数为已支付，返回新实例保持不可变性
  InstallmentsModel markAsPaid(int installmentIndex) {
    if (installmentIndex < 0 || installmentIndex >= installmentCount) return this;
    List<bool> updatedStatuses = List.from(paymentStatuses);
    updatedStatuses[installmentIndex] = true;
    final newModel = InstallmentsModel(
      id: id,
      totalAmount: totalAmount,
      installmentCount: installmentCount,
      createdAt: createdAt,
    );
    newModel.paymentStatuses = updatedStatuses;
    return newModel;
  }

  // 转换为Map，方便存入数据库（如sqflite）
  Map<String, dynamic> toMap() {
    return {
      'id': id,
      'totalAmount': totalAmount,
      'installmentCount': installmentCount,
      'createdAt': createdAt.toIso8601String(),
      'paymentStatuses': paymentStatuses.map((status) => status ? 1 : 0).toList(),
    };
  }

  // 从数据库Map数据初始化Model
  factory InstallmentsModel.fromMap(Map<String, dynamic> map) {
    List<bool> statuses = (map['paymentStatuses'] as List).map((val) => val == 1).toList();
    final model = InstallmentsModel(
      id: map['id'],
      totalAmount: map['totalAmount'],
      installmentCount: map['installmentCount'],
      createdAt: DateTime.parse(map['createdAt']),
    );
    model.paymentStatuses = statuses;
    return model;
  }
}

2. 核心功能适配说明 #

• 分期时长自动生成：通过installmentCount指定期数，planMonths getter方法会基于创建日期自动计算对应月份，无需手动传入，避免人为错误。
• 支付状态管理：用paymentStatuses列表存储每一期的支付状态，markAsPaid方法用于更新指定期数的状态，返回新实例保证数据不可变性。
• 数据库兼容：添加toMap和fromMap方法，直接支持sqflite等本地数据库的增删改查操作，id字段作为主键用于定位记录。

3. 后续功能实现建议 #

• 添加分期记录：做一个表单页面，让管理员输入总金额、选择分期期数，提交时生成InstallmentsModel实例并调用数据库插入接口。
• 更新支付状态：在分期列表页面，给每一期添加支付按钮，点击后调用markAsPaid生成新实例，再同步更新到数据库。
• 数据持久化：使用sqflite或Hive实现本地存储，确保应用重启后数据不会丢失。

内容的提问来源于stack exchange，提问作者Syed Mujtaba Ali