Graph Abstraction Design

核心理念

本系统使用Graph数据库（Neo4j）作为底层存储，并定义了一套完整的Graph抽象。

三大核心抽象

1. Node（节点）

所有实体都是节点，实现 GraphNode 接口：

public interface GraphNode {
    Long getId();
    String getNodeType();
    Map<String, Object> getProperties();
    Object getProperty(String key);
    void setProperty(String key, Object value);
}

实现的节点类型：

• UserNode - 用户
• ServerNode - 服务器/社区
• ChannelNode - 频道
• MessageNode - 消息
• PasskeyCredentialNode - Passkey凭证

2. Edge（边/关系）

节点之间的关系，实现 GraphEdge 接口：

public interface GraphEdge {
    Long getId();
    String getRelationType();
    GraphNode getSourceNode();
    GraphNode getTargetNode();
    Map<String, Object> getProperties();
}

关系类型：

• MEMBER_OF - 用户加入服务器
• FRIEND_WITH - 用户好友关系
• HAS_CHANNEL - 服务器包含频道
• CONTAINS_MESSAGE - 频道包含消息

3. Prop（属性）

节点和边都可以有动态属性，实现 GraphProp 接口：

public interface GraphProp {
    String getKey();
    Object getValue();
    void setValue(Object value);
    Class<?> getValueType();
}

Graph数据模型示例

(User:UserNode {username, email, nickName})
   |
   |-[:MEMBER_OF {role, joinedAt}]-> (Server:ServerNode {name, description})
   |                                      |
   |                                      |-[:HAS_CHANNEL]-> (Channel:ChannelNode {name, type})
   |                                                              |
   |-[:FRIEND_WITH]-> (Friend:UserNode)                          |
                                                                  |
   (Message:MessageNode {content, createdAt}) <-[:CONTAINS_MESSAGE]-|

扩展性

每个节点和边都有 properties: Map<String, Object> 字段，可以动态添加自定义属性，无需修改数据模型。

示例：

user.setProperty("level", 10);
user.setProperty("verified", true);
user.setProperty("badges", Arrays.asList("early-adopter", "contributor"));

Neo4j 查询示例

查找用户所在的所有服务器

MATCH (u:User)-[:MEMBER_OF]->(s:Server)
WHERE u.id = \(userId
RETURN s
```

### 查找服务器的所有成员
```cypher
MATCH (s:Server)<-[:MEMBER_OF]-(u:User)
WHERE s.id =\)serverId
RETURN u

查找用户的好友列表

MATCH (u:User)-[:FRIEND_WITH]->(friend:User)
WHERE u.id = \(userId
RETURN friend
```

### 获取频道的最近消息
```cypher
MATCH (c:Channel)-[:CONTAINS_MESSAGE]->(m:Message)
WHERE c.id =\)channelId AND m.isDeleted = false
RETURN m
ORDER BY m.createdAt DESC
LIMIT 50

未来扩展方向

1. AI集成：在消息节点添加AI分析结果属性
2. 推荐系统：基于Graph关系进行智能推荐
3. 社交图谱分析：使用Graph算法分析用户关系
4. 知识图谱：将内容组织成知识节点并建立关联