CukaiMate Data Repository

一个包含马来西亚税收减免和评估记录的结构化数据仓库，用于CukaiMate应用。该仓库维护了不同财政年度（如FY2025、FY2026）的TypeScript数据模型，并将它们编译成由本地Express API提供的静态JSON文件。

A structured data warehouse containing Malaysian tax relief and assessment records, designed for the CukaiMate application. This warehouse maintains TypeScript data models for various fiscal years (e.g., FY2025, FY2026), and compiles these models into static JSON files served by a local Express API.

原始信息汇总

数据集概述

数据集基本信息

• 数据集名称：CukaiMate Data Repository
• 数据集用途：为CukaiMate应用提供结构化的马来西亚税务减免与评估记录数据。
• 数据格式：主要包含TypeScript数据模型，并编译为静态JSON文件供外部应用使用。
• 数据内容：按财政年度（如FY2025、FY2026）组织的税务减免规则、收入类型和资格门槛等精确税务数据。
• 许可证：GNU GPLv3

数据集主要特征

• 结构化税务数据：按财政年度组织，包含精确的税务减免规则、收入类型和资格门槛。
• 类型安全模型：严格使用TypeScript编写，确保数据结构一致。
• 自动化产物生成：通过脚本输出JSON副本（index.json、notes.json）及哈希版本控制。
• 本地API环境：内置Express服务器，可即时预览构建的数据结构API。
• 自动部署：更改推送到主分支时，自动部署到CF Workers。

数据导出格式

导出的JSON文件遵循以下TypeScript类型定义： typescript type AttachmentFile = { id: string; // 用于磁盘文件名的UUID name: string; // 用于显示的原始文件名 };

type AttachmentItem = { id: string; // UUID name: string; value: number; date?: Date; createdAt: Date; files: AttachmentFile[]; // 包含UUID和原始文件名的文件对象数组 };

type Value = { value: number | string | boolean; realValue?: number; attachmentItems?: AttachmentItem[]; attachmentEnabled?: boolean; // 附件模式是否激活 };

type exportedData = Record<string, Value>; // 键对应字段的id

项目结构

. ├── build/ # 生成的JSON数据和API目录 ├── constants/ # 全局常量定义 ├── scripts/ │ └── build-data.ts # 将TS对象处理为JSON的编译脚本 ├── src/ # 财政年度模型（如FY2025、FY2026） ├── types/ # 共享的TypeScript接口和类型定义 ├── index.ts # 聚合所有FY定义的入口点 └── server.ts # Express服务器配置

相关链接

• 数据集地址：https://github.com/ynshung/cukaimate-data
• 应用地址：http://cukaimate.com/
• 部署地址：https://data.cukaimate.com/index.json
• 反馈地址：https://cukaimate.com/feedback

搜集汇总

数据集介绍

构建方式

在税务数据管理领域，CukaiMate数据仓库采用结构化方法构建，以马来西亚税务减免与评估记录为核心内容。该数据集严格依据不同财政年度（如FY2025、FY2026）的官方税务规则，通过TypeScript数据模型进行精确建模，确保每一条数据均符合LHDN发布的法定标准。构建过程中，开发团队首先复制上一财政年度的模型框架，待新年度完整细则公布后，再系统性地修订与更新，最终通过自动化脚本将TypeScript对象编译为静态JSON文件，并辅以哈希版本控制，从而形成一套类型安全、版本清晰的数据体系。

特点

CukaiMate数据仓库的突出特点在于其高度结构化与类型安全的特性。数据集按财政年度精细组织，涵盖税务减免规则、收入类型及资格阈值等关键要素，所有数据均通过TypeScript接口严格定义，保障了数据结构的一致性。此外，该仓库集成了自动化构建流程，能够生成可直接调用的JSON文件，并内置本地Express服务器，支持实时预览API效果。数据集还实现了自动部署机制，一旦主分支更新，便会即时同步至云端Worker，确保外部应用始终获取最新版本。

使用方法

使用CukaiMate数据仓库时，开发者需先克隆代码库并安装Node.js依赖项。通过运行`npm run dev`命令，可同时启动TypeScript监听器与本地API服务器，便于在开发环境中实时测试数据模型。若需生成最终数据文件，执行`npm run build`即可将src目录下的模型编译为build文件夹中的JSON格式。数据集提供的本地服务器运行于2818端口，静态托管这些JSON文件，供外部应用通过HTTP请求直接获取。对于非开发者用户，则可通过CukaiMate官方反馈渠道提交数据建议或纠错信息。

背景与挑战

背景概述

在税务科技领域，高效、准确地处理税务减免与评估数据是提升个人财务管理效率的关键。CukaiMate Data Repository由CukaiMate团队创建，作为一个结构化马来西亚税务减免与评估记录的数据仓库，旨在为CukaiMate应用程序提供可靠的数据支持。该数据集通过TypeScript数据模型精确组织不同财政年度的税务规则、收入类型及资格阈值，自推出以来，为马来西亚纳税人提供了清晰的税务指导，推动了税务数字化工具的普及与应用，增强了公众对复杂税务政策的理解与遵从。

当前挑战

该数据集致力于解决税务信息标准化与可访问性问题，其核心挑战在于如何动态整合马来西亚税务局（LHDN）频繁更新的税务政策，确保数据实时性与准确性。构建过程中，团队需克服税务规则跨年度迁移的复杂性，通过自动化脚本将TypeScript模型转换为静态JSON格式，同时维护本地API环境以支持即时预览。此外，数据版权限制要求严格遵循LHDN的版权声明，这增加了数据合法使用的难度，需在贡献流程中设置谨慎的审核机制以避免侵权风险。

常用场景

经典使用场景

在税务科技领域，CukaiMate Data Repository作为马来西亚税务减免与评估记录的结构化数据源，其经典使用场景在于为税务计算工具提供核心数据支持。该数据集通过按财年组织精确的税务减免规则、收入类型及资格阈值，使得开发者能够构建自动化税务计算系统，用户可据此高效完成个人或企业税务申报，显著提升了税务处理的准确性与效率。

衍生相关工作

围绕该数据集，衍生了一系列经典工作，包括基于静态JSON产物的第三方税务集成工具、自动化税务审计系统以及跨平台税务教育应用。这些工作充分利用了数据集的版本化输出与结构化特性，扩展了税务数据在金融科技、政策分析及公共服务等领域的创新应用，形成了以数据为中心的税务生态系统。

数据集最近研究

最新研究方向

在税务科技领域，CukaiMate数据仓库以其结构化马来西亚税务减免与评估记录，为智能税务计算与合规自动化研究提供了关键数据基础。当前前沿研究聚焦于利用此类标准化税务数据，结合机器学习算法开发个性化税务规划工具，以应对动态变化的税务法规。随着全球数字税务报告要求日益严格，该数据集支持的研究正推动税务软件的实时更新与跨平台集成能力，促进税务服务的精准化与普惠化，对提升纳税合规效率与金融包容性具有显著意义。