Справочник¶

sharp/                              Cargo workspace root
├── Cargo.toml                      Workspace definition
├── MANUAL.md                       ← этот документ
├── TODO.md                         Roadmap
├── CLAUDE.md                       AI assistant instructions
├── flamegraph.svg                  CPU profiling output
│
├── sharp/                          Core protocol library
│   ├── Cargo.toml
│   └── src/
│       ├── lib.rs                  Public exports, generate_nonce()
│       ├── packet/
│       │   ├── mod.rs              Packet, PacketType, serialization
│       │   └── codec.rs            PacketCodec (Encoder + Decoder)
│       ├── data.rs                 Data enum (Message, Ack, Nack, Ping, Connect)
│       ├── message.rs              Message wrapper over Bytes
│       ├── connection.rs           Connection, ConnectionType
│       ├── duplex.rs               run_connection() — poll_fn loop
│       ├── notify_channel.rs       NotifyChannel<T>
│       └── tests.rs                Protocol unit tests
│
├── client/                         Client library
│   ├── Cargo.toml
│   └── src/
│       ├── lib.rs                  Exports, DEFAULT_TIMEOUT
│       ├── publisher.rs            Publish trait, Publisher
│       ├── subscriber.rs           Subscribe trait, Subscriber
│       └── wal.rs                  Write-Ahead Log
│
├── server/                         MQ server
│   ├── Cargo.toml
│   └── src/
│       ├── main.rs                 Binary entry point (port 7427)
│       ├── lib.rs                  Server logic, ServerConfig, SubscriberWindow
│       └── tests/
│           ├── mod.rs
│           ├── multi_sub_tests.rs  Multi-subscriber delivery tests
│           ├── nack_tests.rs       NACK handling tests
│           └── ordering_tests.rs   Ordering and window tests
│
└── bench/                          Benchmark tool
    ├── Cargo.toml
    └── src/
        └── main.rs                 CLI + benchmark modes