👨‍👨‍👧‍👧股东及股东库

功能与用途

股东库是汇总统计各股东出资额历史状态、股份类别归属及股东表决权排名的公共库合约，本质上是股份映射表的汇总统计衍生表，随股份登记的变更而变更。

成员与属性

股东库应用了三个特殊的数据结构，一个是历史状态序列，用于跟踪记录股东出资额变更历史；另一个是T型链表，用于跟踪计算股东及一致行动人的表决权排名情况；第三个是可枚举集合，用于跟踪记录股份编号列表、股份类别编号列表等列表类信息。

股东库的成员包括股东对象构成的“用户编号->股东对象”的股东映射表，采用T型链表结构的股东排名链表，以及采用“股份类别编号->股东用户编号列表”结构的分类股东编号表。

股东对象

股东对象本质上是股份映射表按持股股东、股份类别和变更时间分类筛选汇总而获得的查询结果表，从而方便系统可在运行时快速、准确的按特定检索条件查询获取特定的股份状态数据。

股东对象结构

股东对象的属性列表

属性	商业法律含义
votesInHand	股东权益情况（历史状态序列），即认缴、实缴及清洁实缴出资额的历史状态序列。
sharesOfClass	按类别区分的股份编号列表（可枚举集合）。第0号类别为股东持有的所有股份编号列表。
classesBelonged	按持股类别分类统计的股东用户编号汇总表（可枚举集合）。

股东库

除股东映射表以外，股东库还包括股东排名链表和分类股东编号表另外两个成员。

股东排名链表(chain)采用了T型链表数据结构，专门用于按股东协议规定的最低阈值筛选出大股东，并按其表决权进行排序。当股东协议规定按认缴出资额行使表决权时，链表会采用各股东持有的认缴出资额乘以相应的表决权重核算并排序；当股东协议被变更而改为采用实缴出资额行使表决权时，链表会自动随之更新计算各股东节点的表决权并更新排序。

分类股东编号表按其所持有的股份类别将股东(用户)编号分类汇总，从而可以方便的以股份类别号检索获取持有该类别股份的所有股东(用户)编号列表。

股东库结构

股东库的属性列表

属性	商业法律含义
chain	股东表决权排名表（T型链表）。
members	采用“用户编号->股东对象”结构的股东对象映射表。其中，第0号股东对象的votesInHand属性跟踪记录公司的所有者权益变更历史。
membersOfClass	按持股类别分类统计的股东编号列表（可枚举集合）。其中，第0号类别为公司所有股东编号列表。

查询接口

查询接口最能体现股东库在整个系统中的功能和用途，具体请见下表。

接口名称	功能与用途
isMember	根据用户编号查询是否为公司股东。
qtyOfMembers	获取公司股东总人数。
membersList	获取公司全部股东编号列表。
ownersEquity	获取公司当前所有者权益数据，即公司认缴、实缴出资总额。
capAtDate	获取特定时点公司所有者权益历史数据，即在历史某时点的公司认缴、实缴出资总额。
equityOfMember	获取特定股东当前的所有者权益数据，即该股东认缴、实缴、清洁实缴出资额及表决权重数据。
equityAtDate	获取特定股东特定时点的所有者权益历史数据。
votesAtDate	获取特定股东特定时点的表决权总值，即，出资额x表决权重/100。
votesHistory	获取特定股东的所有者权益全部变更历史数据。
isClassMember	校验特定股东是否为特定类别股份的持有人。
classesBelonged	获取特定股东所持全部股份的类别编号清单。
qtyOfClassMember	获取特定类别股份的持有股东人数。
getMembersOfClass	获取特定类别股份的股东(用户)编号清单。第0号类别指向公司全体股东(用户)编号清单。
qtyOfSharesInHand	获取特定股东所持全部股份的总数量。
sharesInHand	获取特定股东所持全部股份的编号列表。
qtyOfSharesInClass	获取特定股东所持特定类别股份的总数量。
sharesInClass	获取特定股东所持特定类别股份的股份编号列表。

源代码

MembersRepo