⏱️历史状态序列库

功能与用途

历史状态序列定义了由一系列状态观测点对象构成的映射表，用于跟踪记录认缴出资、实缴出资及清洁实缴出资的历史状态。这样系统就可以回溯查询某个特定时间点的股东表决权状态，满足复杂决策流程的需求。

成员与属性

历史状态序列主要由状态观测点对象，及其“序号->对象”映射表构成。其中，第0号对象被用作计数器，因此有效的历史状态记录从第1号对象开始。

状态观测点

状态观测点由时间戳、表决权重、认缴出资额、实缴出资额、清洁实缴出资额5项属性构成。

状态观测点对象结构

状态观测点的属性列表

属性	商业法律含义
timestamp	观察点时间戳。48位时间戳，可支持毫秒级时间。
votingWeight	表决权重。百分数，即每元出资额所代表的表决权总数的100倍。例如，“100”，代表每元出资额代表1个表决权；“1800”，代表每元出资额代表18个表决权。
par	认缴出资额。可能存在认缴未实缴的余额。
paid	实缴出资额。实际缴付的出资金额。
cleanPaid	清洁实缴出资额。 没有任何质押、出让等权利负担的实缴出资金额。

历史状态序列

历史状态序是状态观测点对象的“序号->对象”映射表，其核心价值在于能以折中法快速找到某个特定时间点当时或之前最临近的状态观测点数据。

历史状态序列结构

查询接口

查询接口最能体现历史状态序列在整个系统中的功能和用途，具体请见下表。

接口名称	功能与用途
counterOfPoints	获取状态观测点编号计数器的当前值。
latest	获取最临近的状态观测点对象。
getAtDate	获取特定时间点当时或之前最临近的观测点对象。
pointsOfHistory	获取包括计数器及所有状态观测点在内的整个历史状态序列。

源代码

Checkpoints