From b5670e0fbce92182339245bfcacb7b446aa3196a Mon Sep 17 00:00:00 2001
From: koi2000 <koi20000@163.com>
Date: Wed, 29 Oct 2025 17:53:14 +0800
Subject: [PATCH 1/2] docs(pd): update test commands and improve documentation
 clarity

---
 hugegraph-pd/README.md           |   2 +-
 hugegraph-pd/docs/development.md | 235 +------------------------------
 2 files changed, 7 insertions(+), 230 deletions(-)

diff --git a/hugegraph-pd/README.md b/hugegraph-pd/README.md
index 3ff14b9e2a..a3c930d824 100644
--- a/hugegraph-pd/README.md
+++ b/hugegraph-pd/README.md
@@ -15,7 +15,7 @@ HugeGraph PD (Placement Driver) is a meta server that provides cluster managemen
 - **Node Scheduling**: Intelligent scheduling and load balancing of graph operations
 - **Health Monitoring**: Continuous health checks and failure detection via heartbeat mechanism
 
-PD uses [Apache JRaft](https://github.com/sofastack/sofa-jraft) for Raft consensus and RocksDB for persistent metadata storage, ensuring high availability and consistency in distributed environments.
+PD uses [sofa-jraft](https://github.com/sofastack/sofa-jraft) for Raft consensus and RocksDB for persistent metadata storage, ensuring high availability and consistency in distributed environments.
 
 ## Architecture
 
diff --git a/hugegraph-pd/docs/development.md b/hugegraph-pd/docs/development.md
index 691fcd9b7c..4bc4310e1c 100644
--- a/hugegraph-pd/docs/development.md
+++ b/hugegraph-pd/docs/development.md
@@ -181,26 +181,26 @@ mvn test jacoco:report
 
 ```bash
 # Core module tests
-mvn test -pl hg-pd-test -am -P pd-core-test
+mvn test -pl hugegraph-pd/hg-pd-test -am -P pd-core-test
 
 # Client module tests
-mvn test -pl hg-pd-test -am -P pd-client-test
+mvn test -pl hugegraph-pd/hg-pd-test -am -P pd-client-test
 
 # Common module tests
-mvn test -pl hg-pd-test -am -P pd-common-test
+mvn test -pl hugegraph-pd/hg-pd-test -am -P pd-common-test
 
 # REST API tests
-mvn test -pl hg-pd-test -am -P pd-rest-test
+mvn test -pl hugegraph-pd/hg-pd-test -am -P pd-rest-test
 ```
 
 #### Single Test Class
 
 ```bash
 # Run specific test class
-mvn test -pl hg-pd-test -am -Dtest=PartitionServiceTest
+mvn -pl hugegraph-pd/hg-pd-test test -Dtest=PartitionServiceTest -DfailIfNoTests=false
 
 # Run specific test method
-mvn test -pl hg-pd-test -am -Dtest=PartitionServiceTest#testSplitPartition
+mvn -pl hugegraph-pd/hg-pd-test test -Dtest=PartitionServiceTest#testSplitPartition -DfailIfNoTests=false
 ```
 
 #### Test from IDE
@@ -227,15 +227,6 @@ open hg-pd-test/target/site/jacoco/index.html
 - Utility classes: >70%
 - Generated gRPC code: Excluded from coverage
 
-### Integration Tests
-
-Integration tests start embedded PD instances and verify end-to-end functionality.
-
-```bash
-# Run integration test suite
-mvn test -pl hg-pd-test -am -Dtest=PDCoreSuiteTest
-```
-
 **What Integration Tests Cover**:
 - Raft cluster formation and leader election
 - Partition allocation and balancing
@@ -243,220 +234,6 @@ mvn test -pl hg-pd-test -am -Dtest=PDCoreSuiteTest
 - Metadata persistence and recovery
 - gRPC service interactions
 
-## Development Workflows
-
-### Adding a New gRPC Service
-
-#### 1. Define Protocol Buffers
-
-Create or modify `.proto` file in `hg-pd-grpc/src/main/proto/`:
-
-```protobuf
-// example_service.proto
-syntax = "proto3";
-
-package org.apache.hugegraph.pd.grpc;
-
-service ExampleService {
-    rpc DoSomething(DoSomethingRequest) returns (DoSomethingResponse);
-}
-
-message DoSomethingRequest {
-    string input = 1;
-}
-
-message DoSomethingResponse {
-    string output = 1;
-}
-```
-
-#### 2. Generate Java Stubs
-
-```bash
-cd hugegraph-pd
-mvn clean compile -pl hg-pd-grpc
-
-# Generated files location:
-# hg-pd-grpc/target/generated-sources/protobuf/java/
-# hg-pd-grpc/target/generated-sources/protobuf/grpc-java/
-```
-
-**Note**: Generated files are excluded from source control (`.gitignore`)
-
-#### 3. Implement Service
-
-Create service implementation in `hg-pd-service`:
-
-```java
-// ExampleServiceImpl.java
-package org.apache.hugegraph.pd.service;
-
-import io.grpc.stub.StreamObserver;
-import org.apache.hugegraph.pd.grpc.ExampleServiceGrpc;
-
-public class ExampleServiceImpl extends ExampleServiceGrpc.ExampleServiceImplBase {
-
-    @Override
-    public void doSomething(DoSomethingRequest request,
-                           StreamObserver<DoSomethingResponse> responseObserver) {
-        String output = processInput(request.getInput());
-
-        DoSomethingResponse response = DoSomethingResponse.newBuilder()
-            .setOutput(output)
-            .build();
-
-        responseObserver.onNext(response);
-        responseObserver.onCompleted();
-    }
-
-    private String processInput(String input) {
-        // Business logic here
-        return "Processed: " + input;
-    }
-}
-```
-
-#### 4. Register Service
-
-Register service in gRPC server (in `hg-pd-service`):
-
-```java
-// In GrpcServerInitializer or similar
-ExampleServiceImpl exampleService = new ExampleServiceImpl();
-grpcServer.addService(exampleService);
-```
-
-#### 5. Add Tests
-
-Create test class in `hg-pd-test`:
-
-```java
-// ExampleServiceTest.java
-package org.apache.hugegraph.pd.service;
-
-import org.junit.Test;
-import static org.junit.Assert.*;
-
-public class ExampleServiceTest extends BaseTest {
-
-    @Test
-    public void testDoSomething() {
-        ExampleServiceImpl service = new ExampleServiceImpl();
-        // Test service logic...
-    }
-}
-```
-
-#### 6. Update Documentation
-
-Document the new API in `docs/api-reference.md`.
-
-### Modifying Partition Logic
-
-Partition logic is in `hg-pd-core/.../PartitionService.java` (2000+ lines).
-
-**Key Methods**:
-- `splitPartition()`: Partition splitting
-- `balancePartitions()`: Auto-balancing
-- `updatePartitionLeader()`: Leader changes
-- `getPartitionByCode()`: Partition routing
-
-**Development Process**:
-
-1. **Understand Current Logic**:
-   ```bash
-   # Read relevant methods
-   # File: hg-pd-core/src/main/java/.../PartitionService.java
-   ```
-
-2. **Make Changes**:
-   - Modify partition allocation algorithm
-   - Update balancing logic
-   - Add new partition operations
-
-3. **Test Changes**:
-   ```bash
-   # Run partition service tests
-   mvn test -pl hg-pd-test -am -Dtest=PartitionServiceTest
-
-   # Run integration tests
-   mvn test -pl hg-pd-test -am -Dtest=PDCoreSuiteTest
-   ```
-
-4. **Submit Raft Proposals**:
-   All partition metadata changes must go through Raft:
-   ```java
-   // Example: Update partition metadata via Raft
-   KVOperation operation = KVOperation.put(key, value);
-   raftTaskHandler.submitTask(operation, closure);
-   ```
-
-### Adding a New Metadata Store
-
-Metadata stores extend `MetadataRocksDBStore` (in `hg-pd-core/.../meta/`).
-
-**Example**: Creating `GraphMetaStore`:
-
-```java
-package org.apache.hugegraph.pd.meta;
-
-public class GraphMetaStore extends MetadataRocksDBStore {
-
-    private static final String GRAPH_PREFIX = "@GRAPH@";
-
-    public GraphMetaStore(PDConfig config) {
-        super(config);
-    }
-
-    public void saveGraph(String graphName, Graph graph) throws PDException {
-        String key = GRAPH_PREFIX + graphName;
-        byte[] value = serialize(graph);
-        put(key.getBytes(), value);
-    }
-
-    public Graph getGraph(String graphName) throws PDException {
-        String key = GRAPH_PREFIX + graphName;
-        byte[] value = get(key.getBytes());
-        return deserialize(value, Graph.class);
-    }
-
-    public List<Graph> listGraphs() throws PDException {
-        List<Graph> graphs = new ArrayList<>();
-        String startKey = GRAPH_PREFIX;
-        String endKey = GRAPH_PREFIX + "\uffff";
-
-        scan(startKey.getBytes(), endKey.getBytes(), (key, value) -> {
-            Graph graph = deserialize(value, Graph.class);
-            graphs.add(graph);
-            return true;  // Continue scanning
-        });
-
-        return graphs;
-    }
-
-    private byte[] serialize(Object obj) {
-        // Use Hessian2 or Protocol Buffers
-    }
-
-    private <T> T deserialize(byte[] bytes, Class<T> clazz) {
-        // Deserialize bytes to object
-    }
-}
-```
-
-**Testing**:
-```java
-@Test
-public void testGraphMetaStore() {
-    GraphMetaStore store = new GraphMetaStore(config);
-
-    Graph graph = new Graph("test_graph", 12);
-    store.saveGraph("test_graph", graph);
-
-    Graph retrieved = store.getGraph("test_graph");
-    assertEquals("test_graph", retrieved.getName());
-}
-```
 
 ### Debugging Raft Issues
 

From 61fbbb3ab248e1efd8bba21af22df46caf75c77c Mon Sep 17 00:00:00 2001
From: imbajin <jin@apache.org>
Date: Wed, 29 Oct 2025 18:35:31 +0800
Subject: [PATCH 2/2] Update README.md

---
 hugegraph-pd/README.md | 16 +---------------
 1 file changed, 1 insertion(+), 15 deletions(-)

diff --git a/hugegraph-pd/README.md b/hugegraph-pd/README.md
index a3c930d824..65d700e677 100644
--- a/hugegraph-pd/README.md
+++ b/hugegraph-pd/README.md
@@ -3,8 +3,6 @@
 [![License](https://img.shields.io/badge/license-Apache%202-0E78BA.svg)](https://www.apache.org/licenses/LICENSE-2.0.html)
 [![Version](https://img.shields.io/badge/version-1.7.0-blue)](https://github.com/apache/hugegraph)
 
-> **Note**: From revision 1.5.0, the HugeGraph-PD code has been adapted to this location.
-
 ## Overview
 
 HugeGraph PD (Placement Driver) is a meta server that provides cluster management and coordination services for HugeGraph distributed deployments. It serves as the central control plane responsible for:
@@ -15,7 +13,7 @@ HugeGraph PD (Placement Driver) is a meta server that provides cluster managemen
 - **Node Scheduling**: Intelligent scheduling and load balancing of graph operations
 - **Health Monitoring**: Continuous health checks and failure detection via heartbeat mechanism
 
-PD uses [sofa-jraft](https://github.com/sofastack/sofa-jraft) for Raft consensus and RocksDB for persistent metadata storage, ensuring high availability and consistency in distributed environments.
+PD uses [SOFA-jraft](https://github.com/sofastack/sofa-jraft) for Raft consensus and RocksDB for persistent metadata storage, ensuring high availability and consistency in distributed environments.
 
 ## Architecture
 
@@ -256,21 +254,9 @@ PD exposes metrics via REST API at:
 
 ## Community
 
-- **Website**: https://hugegraph.apache.org
 - **Documentation**: https://hugegraph.apache.org/docs/
 - **GitHub**: https://github.com/apache/hugegraph
-- **Mailing List**: dev@hugegraph.apache.org
 
 ## Contributing
 
 Contributions are welcome! Please read our [Development Guide](docs/development.md) and follow the Apache HugeGraph contribution guidelines.
-
-## License
-
-HugeGraph PD is licensed under the [Apache License 2.0](https://www.apache.org/licenses/LICENSE-2.0).
-
----
-
-**Status**: BETA (from v1.5.0+)
-
-For questions or issues, please contact the HugeGraph community via GitHub issues or mailing list.
