GUIYAN · 规演笔记

把规则写成
可执行的代码

法条可推演,结果可复现。

记录把法律与税务规则变成可计算、可审计、可复核的程序的过程与方法。这里是一个人的工程笔记,不是产品说明。

Rules-as-Code Catala 中文财税规则

§ 01

我在做什么

一个从法条到程序的个人工程。

01

规则计算引擎

以 Catala 为地基做二次开发:把法条编译成可执行的程序,输入事实,输出结论与依据。重点不是算得快,而是每一步都能回到条文。

02

中文税务规则

第一个闭环选了个人所得税综合所得年度汇算:从应纳税所得额到税率表,逐条落到声明与定义。

03

可审计的工程

依赖许可、构建可复现、测试可追溯。一个用于法律计算的工具,自己首先要经得起审计。

§ 02

三个原则

判断一个规则计算工具是否可靠的标准。

  1. 01

    可追溯

    每个结果都能回到具体法条与版本,而不是只给一个数字。

  2. 02

    可复核

    计算过程对人和机器同时可见:人读得懂,机器跑得通。

  3. 03

    版本对应

    规则版本与法规版本一一对应;法条修订后,旧结果仍然可以复现。

§ 03

笔记

先把要写的问题列出来,再逐篇更新。

  1. 为什么用 Catala 写中国税法

    从法条结构到声明式规则:一个选型记录。

    计划中
  2. 把综合所得年度汇算拆成声明与定义

    一个税种的最小闭环:输入、公式、税率表与例外。

    计划中
  3. 规则版本管理:法条修订之后

    规则版本映射与历史结果重算。

    计划中
  4. 一次依赖许可审计

    清理 LGPL 阻断项、重建 SBOM 的过程记录。

    计划中

当前为写作计划;内容会逐步更新。

§ 04

关于

个人项目,记录过程,不代表任何机构意见。

规演(guī yǎn)是一个个人项目,方向是法律与税务领域的规则计算:把自然语言写成的规则,变成可执行、可审计、可复现的程序。这里记录学习过程、工程实践与阶段性成果。

取名「规演」,取规则的「规」、推演的「演」:规则的推演。

所有内容为个人技术分享,不代表任何机构意见。

项目
规演笔记 · GUIYAN
定位
规则计算引擎 · Rules-as-Code
技术地基
Catala(Apache-2.0)二次开发
首个方向
个人所得税综合所得年度汇算
站点
guiyantech.cn(苏ICP备2026085417号-1)