# Quickstart Verification Guide: Core Distributed Architecture

This guide verifies the core components (PD, Server, Client) and storage engine behavior.

## Prerequisites

- Rust Toolchain (`rustc`, `cargo`)
- `protoc` (Protocol Buffers compiler)
- CMake (for building RocksDB)

## 1. Build Workspace

```bash
cargo build
```

## 2. Run Integration Test

This feature includes a comprehensive integration test script.

```bash
# Run the custom verification script (to be implemented in tasks)
# ./scripts/verify-core.sh
```

## 3. Manual Verification Steps

### A. Start PD (Placement Driver)

```bash
cargo run --bin rdb-pd
# Should listen on default port (e.g., 2379)
```

### B. Start Server (Storage Node)

```bash
cargo run --bin rdb-server -- --pd-addr 127.0.0.1:2379
# Should listen on default port (e.g., 50051)
```

### C. Run Client Operations

```bash
# Get TSO
cargo run --bin rdb-client -- tso
# Output: Timestamp: 1735689...

# Raw Put
cargo run --bin rdb-client -- raw-put --key foo --value bar
# Output: Success

# Raw Get
cargo run --bin rdb-client -- raw-get --key foo
# Output: bar

# CAS (Create)
cargo run --bin rdb-client -- cas --key meta1 --value "{json}" --expected 0
# Output: Success, Version: 1735689...

# CAS (Conflict)
cargo run --bin rdb-client -- cas --key meta1 --value "{new}" --expected 0
# Output: Conflict! Current Version: 1735689...
```