⏱️历史状态序列库
Last updated
Last updated
历史状态序列定义了由一系列状态观测点对象构成的映射表，用于跟踪记录认缴出资、实缴出资及清洁实缴出资的历史状态。这样系统就可以回溯查询某个特定时间点的股东表决权状态，满足复杂决策流程的需求。
历史状态序列主要由状态观测点对象，及其“序号->对象”映射表构成。其中，第0号对象被用作计数器，因此有效的历史状态记录从第1号对象开始。
状态观测点由时间戳、表决权重、认缴出资额、实缴出资额、清洁实缴出资额5项属性构成。
timestamp
观察点时间戳。48位时间戳，可支持毫秒级时间。
votingWeight
表决权重。百分数，即每元出资额所代表的表决权总数的100倍。例如，“100”，代表每元出资额代表1个表决权；“1800”，代表每元出资额代表18个表决权。
par
认缴出资额。可能存在认缴未实缴的余额。
paid
实缴出资额。实际缴付的出资金额。
cleanPaid
清洁实缴出资额。 没有任何质押、出让等权利负担的实缴出资金额。
历史状态序是状态观测点对象的“序号->对象”映射表，其核心价值在于能以折中法快速找到某个特定时间点当时或之前最临近的状态观测点数据。
查询接口最能体现历史状态序列在整个系统中的功能和用途，具体请见下表。
counterOfPoints
获取状态观测点编号计数器的当前值。
latest
获取最临近的状态观测点对象。
getAtDate
获取特定时间点当时或之前最临近的观测点对象。
pointsOfHistory
获取包括计数器及所有状态观测点在内的整个历史状态序列。
