在这里插入图片描述

目录

  1. 概述
  2. 功能设计
  3. Kotlin 实现代码(KMP)
  4. JavaScript 调用示例
  5. ArkTS 页面集成与调用
  6. 数据输入与交互体验
  7. 编译与自动复制流程
  8. 总结

概述

本案例在 Kotlin Multiplatform (KMP) 工程中实现了一个 人力资源工具 - 员工离职风险预警工具

  • 输入:员工离职风险评估数据(工作满意度、薪资满意度、职业发展、工作环境、团队关系),使用空格分隔,例如:75 70 65 80 85
  • 输出:
    • 离职风险基本信息:各项风险指标评分
    • 离职风险分析:综合风险分数、风险等级、最高风险项、最低风险项
    • 离职风险评估:各项指标的详细评估
    • 离职预警:根据分析结果的离职预警信息
    • 保留建议:根据评估结果的员工保留建议
  • 技术路径:Kotlin → Kotlin/JS → JavaScript 模块 → ArkTS 页面调用。

这个案例展示了 KMP 跨端开发在人力资源管理领域的应用:

把员工离职风险预警逻辑写在 Kotlin 里,一次实现,多端复用;把预警界面写在 ArkTS 里,专注 UI 和体验。

Kotlin 侧负责解析员工数据、计算风险指标、评估离职风险、生成保留建议;ArkTS 侧只需要把输入字符串传给 Kotlin 函数,并把返回结果原样展示出来即可。借助 KMP 的 Kotlin/JS 能力,这个员工离职风险预警工具可以在 Node.js、Web 前端以及 OpenHarmony 中复用相同的代码逻辑。


功能设计

输入数据格式

员工离职风险预警工具采用简单直观的输入格式:

  • 使用 空格分隔 各个参数。
  • 第一个参数是工作满意度(整数或浮点数,范围 0-100)。
  • 第二个参数是薪资满意度(整数或浮点数,范围 0-100)。
  • 第三个参数是职业发展(整数或浮点数,范围 0-100)。
  • 第四个参数是工作环境(整数或浮点数,范围 0-100)。
  • 第五个参数是团队关系(整数或浮点数,范围 0-100)。
  • 输入示例:
75 70 65 80 85

这可以理解为:

  • 工作满意度:75 分
  • 薪资满意度:70 分
  • 职业发展:65 分
  • 工作环境:80 分
  • 团队关系:85 分

工具会基于这些数据计算出:

  • 综合风险分数:所有风险指标的反向加权平均值(高分表示低风险)
  • 离职风险等级:根据综合风险分数的等级评估
  • 最高风险项:风险分数最低的方面
  • 最低风险项:风险分数最高的方面
  • 风险差距:最高和最低风险的差异

输出信息结构

为了便于在 ArkTS 页面以及终端中直接展示,Kotlin 函数返回的是一段结构化的多行文本,划分为几个分区:

  1. 标题区:例如"⚠️ 员工离职风险预警",一眼看出工具用途。
  2. 离职风险基本信息:各项风险指标评分。
  3. 离职风险分析:综合风险分数、风险等级、最高风险项、最低风险项。
  4. 离职风险评估:各项指标的详细评估。
  5. 离职预警:根据分析结果的预警信息。
  6. 保留建议:根据评估结果的保留建议。

这样的输出结构使得:

  • 在 ArkTS 中可以直接把整段文本绑定到 Text 组件,配合 monospace 字体,阅读体验类似终端报告。
  • 如果将来想把结果保存到日志或者后端,直接保存字符串即可。
  • 需要更精细的 UI 时,也可以在前端根据分隔符进行拆分,再按块展示。

Kotlin 实现代码(KMP)

核心代码在 src/jsMain/kotlin/App.kt 中,通过 @JsExport 导出。以下是完整的 Kotlin 实现:

@OptIn(ExperimentalJsExport::class)
@JsExport
fun employeeTurnoverRiskPredictor(inputData: String = "75 70 65 80 85"): String {
    // 输入格式: 工作满意度 薪资满意度 职业发展 工作环境 团队关系
    val parts = inputData.trim().split(" ").filter { it.isNotEmpty() }

    if (parts.size < 5) {
        return "❌ 错误: 请输入完整的信息,格式: 工作满意度 薪资满意度 职业发展 工作环境 团队关系\n例如: 75 70 65 80 85"
    }

    val jobSatisfaction = parts[0].toDoubleOrNull() ?: return "❌ 错误: 工作满意度必须是数字"
    val salarySatisfaction = parts[1].toDoubleOrNull() ?: return "❌ 错误: 薪资满意度必须是数字"
    val careerDevelopment = parts[2].toDoubleOrNull() ?: return "❌ 错误: 职业发展必须是数字"
    val workEnvironment = parts[3].toDoubleOrNull() ?: return "❌ 错误: 工作环境必须是数字"
    val teamRelationship = parts[4].toDoubleOrNull() ?: return "❌ 错误: 团队关系必须是数字"

    if (jobSatisfaction < 0 || jobSatisfaction > 100) {
        return "❌ 错误: 工作满意度必须在 0-100 之间"
    }

    if (salarySatisfaction < 0 || salarySatisfaction > 100) {
        return "❌ 错误: 薪资满意度必须在 0-100 之间"
    }

    if (careerDevelopment < 0 || careerDevelopment > 100) {
        return "❌ 错误: 职业发展必须在 0-100 之间"
    }

    if (workEnvironment < 0 || workEnvironment > 100) {
        return "❌ 错误: 工作环境必须在 0-100 之间"
    }

    if (teamRelationship < 0 || teamRelationship > 100) {
        return "❌ 错误: 团队关系必须在 0-100 之间"
    }

    // 计算离职风险分数(反向计算,高分表示低风险)
    val turnoverRiskScore = 100 - ((jobSatisfaction + salarySatisfaction + careerDevelopment + workEnvironment + teamRelationship) / 5)

    // 判断离职风险等级
    val turnoverRiskLevel = when {
        turnoverRiskScore >= 80 -> "🔴 极高风险"
        turnoverRiskScore >= 60 -> "🟠 高风险"
        turnoverRiskScore >= 40 -> "🟡 中等风险"
        turnoverRiskScore >= 20 -> "🟢 低风险"
        else -> "🟢 极低风险"
    }

    // 找出最高和最低风险项
    val riskFactors = mapOf(
        "工作满意度" to jobSatisfaction,
        "薪资满意度" to salarySatisfaction,
        "职业发展" to careerDevelopment,
        "工作环境" to workEnvironment,
        "团队关系" to teamRelationship
    )

    val highestRisk = riskFactors.minByOrNull { it.value }
    val lowestRisk = riskFactors.maxByOrNull { it.value }

    // 判断各项风险等级
    val getRiskGrade = { score: Double ->
        when {
            score >= 80 -> "低风险"
            score >= 60 -> "较低风险"
            score >= 40 -> "中等风险"
            score >= 20 -> "较高风险"
            else -> "高风险"
        }
    }

    // 生成风险分析
    val riskAnalysis = StringBuilder()
    riskAnalysis.append("• 工作满意度: ${String.format("%.1f", jobSatisfaction)} 分 (${getRiskGrade(jobSatisfaction)})\n")
    riskAnalysis.append("• 薪资满意度: ${String.format("%.1f", salarySatisfaction)} 分 (${getRiskGrade(salarySatisfaction)})\n")
    riskAnalysis.append("• 职业发展: ${String.format("%.1f", careerDevelopment)} 分 (${getRiskGrade(careerDevelopment)})\n")
    riskAnalysis.append("• 工作环境: ${String.format("%.1f", workEnvironment)} 分 (${getRiskGrade(workEnvironment)})\n")
    riskAnalysis.append("• 团队关系: ${String.format("%.1f", teamRelationship)} 分 (${getRiskGrade(teamRelationship)})\n")

    // 生成保留建议
    val retentionAdvice = StringBuilder()
    if (jobSatisfaction < 60) {
        retentionAdvice.append("• 工作满意度低: 建议改进工作内容,提高工作吸引力\n")
    }
    if (salarySatisfaction < 60) {
        retentionAdvice.append("• 薪资满意度低: 建议调整薪酬待遇,提高竞争力\n")
    }
    if (careerDevelopment < 60) {
        retentionAdvice.append("• 职业发展低: 建议制定职业发展计划,提供晋升机会\n")
    }
    if (workEnvironment < 60) {
        retentionAdvice.append("• 工作环境差: 建议改善工作环境,提高工作条件\n")
    }
    if (teamRelationship < 60) {
        retentionAdvice.append("• 团队关系差: 建议加强团队建设,改善人际关系\n")
    }
    if (retentionAdvice.isEmpty()) {
        retentionAdvice.append("• 员工满意度良好,继续维护关系\n")
    }

    // 生成离职预警
    val turnoverWarning = when {
        turnoverRiskScore >= 80 -> "🔴 极高风险:员工离职风险极高,建议立即采取行动,进行深度沟通。"
        turnoverRiskScore >= 60 -> "🟠 高风险:员工离职风险较高,建议加强关注,制定保留计划。"
        turnoverRiskScore >= 40 -> "🟡 中等风险:员工离职风险中等,建议定期跟进,了解需求。"
        turnoverRiskScore >= 20 -> "🟢 低风险:员工离职风险较低,建议继续维护,保持良好关系。"
        else -> "🟢 极低风险:员工离职风险极低,建议继续保持,争取长期合作。"
    }

    // 生成员工价值评估
    val employeeValue = when {
        jobSatisfaction >= 80 && teamRelationship >= 80 -> "高价值员工"
        jobSatisfaction >= 60 && teamRelationship >= 60 -> "中价值员工"
        else -> "基础员工"
    }

    // 构建输出文本
    val result = StringBuilder()
    result.append("⚠️ 员工离职风险预警\n")
    result.append("═".repeat(60)).append("\n\n")
    
    result.append("📊 离职风险基本信息\n")
    result.append("─".repeat(60)).append("\n")
    result.append("工作满意度: ${String.format("%.1f", jobSatisfaction)} 分\n")
    result.append("薪资满意度: ${String.format("%.1f", salarySatisfaction)} 分\n")
    result.append("职业发展: ${String.format("%.1f", careerDevelopment)} 分\n")
    result.append("工作环境: ${String.format("%.1f", workEnvironment)} 分\n")
    result.append("团队关系: ${String.format("%.1f", teamRelationship)} 分\n\n")

    result.append("📈 离职风险分析\n")
    result.append("─".repeat(60)).append("\n")
    result.append("离职风险分数: ${String.format("%.1f", turnoverRiskScore)}/100\n")
    result.append("离职风险等级: ${turnoverRiskLevel}\n")
    result.append("最高风险项: ${highestRisk?.key} (${String.format("%.1f", highestRisk?.value ?: 0.0)} 分)\n")
    result.append("最低风险项: ${lowestRisk?.key} (${String.format("%.1f", lowestRisk?.value ?: 0.0)} 分)\n")
    result.append("员工价值: ${employeeValue}\n\n")

    result.append("🔍 离职风险评估\n")
    result.append("─".repeat(60)).append("\n")
    result.append(riskAnalysis.toString()).append("\n")

    result.append("🎯 离职预警\n")
    result.append("─".repeat(60)).append("\n")
    result.append("${turnoverWarning}\n\n")

    result.append("💡 保留建议\n")
    result.append("─".repeat(60)).append("\n")
    result.append(retentionAdvice.toString()).append("\n")

    result.append("📋 员工保留策略\n")
    result.append("─".repeat(60)).append("\n")
    result.append("1. 建立员工满意度监测体系,定期评估\n")
    result.append("2. 制定个性化职业发展计划,提供晋升机会\n")
    result.append("3. 建立薪酬激励机制,提高竞争力\n")
    result.append("4. 改善工作环境,提高工作条件\n")
    result.append("5. 加强团队建设,改善人际关系\n")
    result.append("6. 建立员工关怀机制,提高归属感\n")
    result.append("7. 定期进行离职面谈,了解离职原因\n")
    result.append("8. 建立离职风险预警机制,及时发现问题\n")
    result.append("9. 制定高潜力员工保留计划,重点关注\n")
    result.append("10. 建立人才发展通道,支持职业成长\n\n")

    result.append("🔧 员工保留方法\n")
    result.append("─".repeat(60)).append("\n")
    result.append("• 薪酬优化: 提高薪资待遇,增加福利\n")
    result.append("• 职业发展: 提供晋升机会,制定发展计划\n")
    result.append("• 工作环境: 改善办公环境,提高工作条件\n")
    result.append("• 团队建设: 加强团队凝聚力,改善人际关系\n")
    result.append("• 工作内容: 优化工作内容,提高工作吸引力\n")
    result.append("• 管理方式: 改进管理方式,提高管理水平\n")
    result.append("• 企业文化: 建立积极文化,提高员工认同\n")
    result.append("• 学习机会: 提供培训机会,支持能力提升\n\n")

    result.append("⚖️ 离职风险等级标准\n")
    result.append("─".repeat(60)).append("\n")
    result.append("• 极高风险 (80-100分): 员工离职风险极高,需立即采取行动\n")
    result.append("• 高风险 (60-79分): 员工离职风险较高,需加强管理\n")
    result.append("• 中等风险 (40-59分): 员工离职风险中等,需定期关注\n")
    result.append("• 低风险 (20-39分): 员工离职风险较低,需维护关系\n")
    result.append("• 极低风险 (0-19分): 员工离职风险极低,需继续保持\n")

    return result.toString()
}

代码说明

这段 Kotlin 代码实现了完整的员工离职风险预警和保留建议功能。让我详细解释关键部分:

数据验证:首先验证输入的满意度数据是否有效,确保数据在 0-100 范围内。

风险计算:通过反向计算得出离职风险分数,高分表示低风险。

等级评估:根据离职风险分数给出相应的风险等级。

项目分析:找出最高风险项和最低风险项,计算两者的差距,帮助识别改进方向。

建议生成:根据各项指标生成个性化的保留建议和离职预警。


JavaScript 调用示例

编译后的 JavaScript 代码可以在 Node.js 或浏览器中直接调用。以下是 JavaScript 的使用示例:

// 导入编译后的 Kotlin/JS 模块
const { employeeTurnoverRiskPredictor } = require('./hellokjs.js');

// 示例 1:极高风险
const result1 = employeeTurnoverRiskPredictor("75 70 65 80 85");
console.log("示例 1 - 极高风险:");
console.log(result1);
console.log("\n");

// 示例 2:高风险
const result2 = employeeTurnoverRiskPredictor("65 60 55 70 75");
console.log("示例 2 - 高风险:");
console.log(result2);
console.log("\n");

// 示例 3:中等风险
const result3 = employeeTurnoverRiskPredictor("55 50 45 60 65");
console.log("示例 3 - 中等风险:");
console.log(result3);
console.log("\n");

// 示例 4:低风险
const result4 = employeeTurnoverRiskPredictor("45 40 35 50 55");
console.log("示例 4 - 低风险:");
console.log(result4);
console.log("\n");

// 示例 5:极低风险
const result5 = employeeTurnoverRiskPredictor("35 30 25 40 45");
console.log("示例 5 - 极低风险:");
console.log(result5);
console.log("\n");

// 示例 6:使用默认参数
const result6 = employeeTurnoverRiskPredictor();
console.log("示例 6 - 使用默认参数:");
console.log(result6);

// 实际应用场景:从用户输入获取数据
function predictEmployeeTurnover(userInput) {
    try {
        const result = employeeTurnoverRiskPredictor(userInput);
        return {
            success: true,
            data: result
        };
    } catch (error) {
        return {
            success: false,
            error: error.message
        };
    }
}

// 测试实际应用
const userInput = "80 75 70 85 90";
const prediction = predictEmployeeTurnover(userInput);
if (prediction.success) {
    console.log("员工离职风险预测结果:");
    console.log(prediction.data);
} else {
    console.log("预测失败:", prediction.error);
}

// 多个员工离职风险对比
function compareEmployeeTurnoverRisks(employees) {
    console.log("\n多个员工离职风险对比:");
    console.log("═".repeat(60));
    
    const results = employees.map((employee, index) => {
        const prediction = employeeTurnoverRiskPredictor(employee);
        return {
            number: index + 1,
            employee,
            prediction
        };
    });

    results.forEach(result => {
        console.log(`\n员工 ${result.number} (${result.employee}):`);
        console.log(result.prediction);
    });

    return results;
}

// 测试多个员工离职风险对比
const employees = [
    "75 70 65 80 85",
    "65 60 55 70 75",
    "55 50 45 60 65",
    "45 40 35 50 55"
];

compareEmployeeTurnoverRisks(employees);

// 员工离职风险统计分析
function analyzeEmployeeTurnoverStats(employees) {
    const data = employees.map(employee => {
        const parts = employee.split(' ').map(Number);
        return {
            jobSatisfaction: parts[0],
            salarySatisfaction: parts[1],
            careerDevelopment: parts[2],
            workEnvironment: parts[3],
            teamRelationship: parts[4]
        };
    });

    console.log("\n员工离职风险统计分析:");
    const avgJobSatisfaction = data.reduce((sum, d) => sum + d.jobSatisfaction, 0) / data.length;
    const avgSalarySatisfaction = data.reduce((sum, d) => sum + d.salarySatisfaction, 0) / data.length;
    const avgCareerDevelopment = data.reduce((sum, d) => sum + d.careerDevelopment, 0) / data.length;
    const avgWorkEnvironment = data.reduce((sum, d) => sum + d.workEnvironment, 0) / data.length;
    const avgTeamRelationship = data.reduce((sum, d) => sum + d.teamRelationship, 0) / data.length;
    
    console.log(`平均工作满意度: ${avgJobSatisfaction.toFixed(1)}`);
    console.log(`平均薪资满意度: ${avgSalarySatisfaction.toFixed(1)}`);
    console.log(`平均职业发展: ${avgCareerDevelopment.toFixed(1)}`);
    console.log(`平均工作环境: ${avgWorkEnvironment.toFixed(1)}`);
    console.log(`平均团队关系: ${avgTeamRelationship.toFixed(1)}`);
    console.log(`平均离职风险分数: ${(100 - ((avgJobSatisfaction + avgSalarySatisfaction + avgCareerDevelopment + avgWorkEnvironment + avgTeamRelationship) / 5)).toFixed(1)}`);
}

analyzeEmployeeTurnoverStats(employees);

JavaScript 代码说明

这段 JavaScript 代码展示了如何在 Node.js 环境中调用编译后的 Kotlin 函数。关键点包括:

模块导入:使用 require 导入编译后的 JavaScript 模块,获取导出的 employeeTurnoverRiskPredictor 函数。

多个示例:展示了不同离职风险等级的调用方式,包括极高、高、中等、低、极低等。

错误处理:在实际应用中,使用 try-catch 块来处理可能的错误。

多员工对比compareEmployeeTurnoverRisks 函数展示了如何对比多个员工的离职风险。

统计分析analyzeEmployeeTurnoverStats 函数演示了如何进行员工离职风险统计分析。


ArkTS 页面集成与调用

在 OpenHarmony 的 ArkTS 页面中集成这个员工离职风险预警工具。以下是完整的 ArkTS 实现代码:

import { employeeTurnoverRiskPredictor } from './hellokjs';

@Entry
@Component
struct EmployeeTurnoverRiskPredictorPage {
  @State jobSatisfaction: string = "75";
  @State salarySatisfaction: string = "70";
  @State careerDevelopment: string = "65";
  @State workEnvironment: string = "80";
  @State teamRelationship: string = "85";
  @State predictionResult: string = "";
  @State isLoading: boolean = false;

  build() {
    Column() {
      // 顶部栏
      Row() {
        Text("⚠️ 员工离职风险预警")
          .fontSize(24)
          .fontWeight(FontWeight.Bold)
          .fontColor(Color.White)
      }
      .width("100%")
      .height(60)
      .backgroundColor("#E53935")
      .justifyContent(FlexAlign.Center)
      .padding({ top: 10, bottom: 10 })

      // 主容器
      Scroll() {
        Column() {
          // 工作满意度输入
          Text("工作满意度 (0-100)")
            .fontSize(14)
            .fontColor("#333333")
            .margin({ top: 20, left: 15 })

          TextInput({
            placeholder: "例如: 75",
            text: this.jobSatisfaction
          })
            .width("90%")
            .height(45)
            .margin({ top: 8, bottom: 15, left: 15, right: 15 })
            .padding({ left: 10, right: 10 })
            .backgroundColor("#FFCDD2")
            .border({ width: 1, color: "#E53935" })
            .onChange((value: string) => {
              this.jobSatisfaction = value;
            })

          // 薪资满意度输入
          Text("薪资满意度 (0-100)")
            .fontSize(14)
            .fontColor("#333333")
            .margin({ left: 15 })

          TextInput({
            placeholder: "例如: 70",
            text: this.salarySatisfaction
          })
            .width("90%")
            .height(45)
            .margin({ top: 8, bottom: 15, left: 15, right: 15 })
            .padding({ left: 10, right: 10 })
            .backgroundColor("#FFCDD2")
            .border({ width: 1, color: "#E53935" })
            .onChange((value: string) => {
              this.salarySatisfaction = value;
            })

          // 职业发展输入
          Text("职业发展 (0-100)")
            .fontSize(14)
            .fontColor("#333333")
            .margin({ left: 15 })

          TextInput({
            placeholder: "例如: 65",
            text: this.careerDevelopment
          })
            .width("90%")
            .height(45)
            .margin({ top: 8, bottom: 15, left: 15, right: 15 })
            .padding({ left: 10, right: 10 })
            .backgroundColor("#FFCDD2")
            .border({ width: 1, color: "#E53935" })
            .onChange((value: string) => {
              this.careerDevelopment = value;
            })

          // 工作环境输入
          Text("工作环境 (0-100)")
            .fontSize(14)
            .fontColor("#333333")
            .margin({ left: 15 })

          TextInput({
            placeholder: "例如: 80",
            text: this.workEnvironment
          })
            .width("90%")
            .height(45)
            .margin({ top: 8, bottom: 15, left: 15, right: 15 })
            .padding({ left: 10, right: 10 })
            .backgroundColor("#FFCDD2")
            .border({ width: 1, color: "#E53935" })
            .onChange((value: string) => {
              this.workEnvironment = value;
            })

          // 团队关系输入
          Text("团队关系 (0-100)")
            .fontSize(14)
            .fontColor("#333333")
            .margin({ left: 15 })

          TextInput({
            placeholder: "例如: 85",
            text: this.teamRelationship
          })
            .width("90%")
            .height(45)
            .margin({ top: 8, bottom: 15, left: 15, right: 15 })
            .padding({ left: 10, right: 10 })
            .backgroundColor("#FFCDD2")
            .border({ width: 1, color: "#E53935" })
            .onChange((value: string) => {
              this.teamRelationship = value;
            })

          // 按钮区域
          Row() {
            Button("📊 预测风险")
              .width("45%")
              .height(45)
              .backgroundColor("#E53935")
              .fontColor(Color.White)
              .fontSize(16)
              .fontWeight(FontWeight.Bold)
              .onClick(() => {
                this.isLoading = true;
                setTimeout(() => {
                  const input = `${this.jobSatisfaction} ${this.salarySatisfaction} ${this.careerDevelopment} ${this.workEnvironment} ${this.teamRelationship}`;
                  this.predictionResult = employeeTurnoverRiskPredictor(input);
                  this.isLoading = false;
                }, 300);
              })

            Blank()

            Button("🔄 重置")
              .width("45%")
              .height(45)
              .backgroundColor("#2196F3")
              .fontColor(Color.White)
              .fontSize(16)
              .fontWeight(FontWeight.Bold)
              .onClick(() => {
                this.jobSatisfaction = "75";
                this.salarySatisfaction = "70";
                this.careerDevelopment = "65";
                this.workEnvironment = "80";
                this.teamRelationship = "85";
                this.predictionResult = "";
                this.isLoading = false;
              })
          }
          .width("90%")
          .margin({ top: 10, bottom: 20, left: 15, right: 15 })
          .justifyContent(FlexAlign.SpaceBetween)

          // 加载指示器
          if (this.isLoading) {
            Row() {
              LoadingProgress()
                .width(40)
                .height(40)
                .color("#E53935")
              Text("  正在预测中...")
                .fontSize(14)
                .fontColor("#666666")
            }
            .width("90%")
            .height(50)
            .margin({ bottom: 15, left: 15, right: 15 })
            .justifyContent(FlexAlign.Center)
            .backgroundColor("#FFCDD2")
            .borderRadius(8)
          }

          // 结果显示区域
          if (this.predictionResult.length > 0) {
            Column() {
              Text("📋 预测结果")
                .fontSize(16)
                .fontWeight(FontWeight.Bold)
                .fontColor("#E53935")
                .margin({ bottom: 10 })

              Text(this.predictionResult)
                .width("100%")
                .fontSize(12)
                .fontFamily("monospace")
                .fontColor("#333333")
                .lineHeight(1.6)
                .padding(10)
                .backgroundColor("#FAFAFA")
                .border({ width: 1, color: "#E0E0E0" })
                .borderRadius(8)
            }
            .width("90%")
            .margin({ top: 20, bottom: 30, left: 15, right: 15 })
            .padding(15)
            .backgroundColor("#FFCDD2")
            .borderRadius(8)
            .border({ width: 1, color: "#E53935" })
          }
        }
        .width("100%")
      }
      .layoutWeight(1)
      .backgroundColor("#FFFFFF")
    }
    .width("100%")
    .height("100%")
    .backgroundColor("#F5F5F5")
  }
}

ArkTS 代码说明

这段 ArkTS 代码实现了完整的用户界面和交互逻辑。关键点包括:

导入函数:从编译后的 JavaScript 模块中导入 employeeTurnoverRiskPredictor 函数。

状态管理:使用 @State 装饰器管理七个状态:工作满意度、薪资满意度、职业发展、工作环境、团队关系、预测结果和加载状态。

UI 布局:包含顶部栏、五个输入框、预测风险和重置按钮、加载指示器和结果显示区域。

交互逻辑:用户输入满意度指标后,点击预测风险按钮。应用会调用 Kotlin 函数进行预测,显示加载动画,最后展示详细的预测结果。

样式设计:使用红色主题,与警告和风险相关的主题相符。所有输入框、按钮和结果显示区域都有相应的样式设置。


数据输入与交互体验

输入数据格式规范

为了确保工具能够正确处理用户输入,用户应该遵循以下规范:

  1. 工作满意度:整数或浮点数,范围 0-100。
  2. 薪资满意度:整数或浮点数,范围 0-100。
  3. 职业发展:整数或浮点数,范围 0-100。
  4. 工作环境:整数或浮点数,范围 0-100。
  5. 团队关系:整数或浮点数,范围 0-100。
  6. 分隔符:使用空格分隔各个参数。

示例输入

  • 极高风险75 70 65 80 85
  • 高风险65 60 55 70 75
  • 中等风险55 50 45 60 65
  • 低风险45 40 35 50 55
  • 极低风险35 30 25 40 45

交互流程

  1. 用户打开应用,看到输入框和默认数据
  2. 用户输入五项满意度指标
  3. 点击"预测风险"按钮,应用调用 Kotlin 函数进行预测
  4. 应用显示加载动画,表示正在处理
  5. 预测完成后,显示详细的预测结果,包括风险分析、建议等
  6. 用户可以点击"重置"按钮清空数据,重新开始

编译与自动复制流程

编译步骤

  1. 编译 Kotlin 代码

    ./gradlew build
    
  2. 生成 JavaScript 文件
    编译过程会自动生成 hellokjs.d.tshellokjs.js 文件。

  3. 复制到 ArkTS 项目
    使用提供的脚本自动复制生成的文件到 ArkTS 项目的 pages 目录:

    ./build-and-copy.bat
    

文件结构

编译完成后,项目结构如下:

kmp_openharmony/
├── src/
│   └── jsMain/
│       └── kotlin/
│           └── App.kt (包含 employeeTurnoverRiskPredictor 函数)
├── build/
│   └── js/
│       └── packages/
│           └── hellokjs/
│               ├── hellokjs.d.ts
│               └── hellokjs.js
└── kmp_ceshiapp/
    └── entry/
        └── src/
            └── main/
                └── ets/
                    └── pages/
                        ├── hellokjs.d.ts (复制后)
                        ├── hellokjs.js (复制后)
                        └── Index.ets (ArkTS 页面)

总结

这个案例展示了如何使用 Kotlin Multiplatform 技术实现一个跨端的人力资源工具 - 员工离职风险预警工具。通过将核心逻辑写在 Kotlin 中,然后编译为 JavaScript,最后在 ArkTS 中调用,我们实现了代码的一次编写、多端复用。

核心优势

  1. 代码复用:Kotlin 代码可以在 JVM、JavaScript 和其他平台上运行,避免重复开发。
  2. 类型安全:Kotlin 的类型系统确保了代码的安全性和可维护性。
  3. 性能优化:Kotlin 编译为 JavaScript 后,性能与手写 JavaScript 相当。
  4. 易于维护:集中管理业务逻辑,使得维护和更新变得更加容易。
  5. 用户体验:通过 ArkTS 提供的丰富 UI 组件,可以创建美观、易用的用户界面。

扩展方向

  1. 数据持久化:将离职风险预测数据保存到本地存储或云端。
  2. 数据可视化:使用图表库展示离职风险分布和趋势。
  3. 多员工管理:支持多个员工的离职风险管理和对比。
  4. 风险预警:设置风险预警阈值,及时提醒风险升级。
  5. 风险报表:生成详细的离职风险预测报表和分析报告。
  6. 集成 HRM:与人力资源管理系统集成,获取员工信息。
  7. AI 分析:使用机器学习进行离职风险预测和优化建议。
  8. 团队协作:支持人力资源团队的离职风险管理和协作。

通过这个案例,开发者可以学到如何在 KMP 项目中实现复杂的员工离职风险预警逻辑,以及如何在 OpenHarmony 平台上构建高效的跨端应用。这个员工离职风险预警工具可以作为人力资源管理平台、员工保留系统或人力资源决策支持工具的核心模块。

Logo

作为“人工智能6S店”的官方数字引擎,为AI开发者与企业提供一个覆盖软硬件全栈、一站式门户。

更多推荐