How distributedfilesystem/centralized-distributed-file-systems works
This is a centralized-metadata distributed file system: users sign in through the desktop client, browse and administer a namespace, and upload or download file chunks transferred directly between the client and data servers. The metadata server handles namespace, transfer planning, authorization, sessions, and persisted metadata; data servers store chunks and report availability by heartbeat. Shared TCP framing and message contracts support these interactions. The README also describes a later Raft/replication HA stage, but the supplied source tree shows stage-one implementations, so that future capability is documented rather than represented as implemented components.
Main entry points: DfsClient.cs DFS client · MetadataServerHost.cs Metadata server · SqliteMetadataState.cs Metadata state · MainViewModel.cs Desktop UI
Components 25
Desktop client
- Desktop UI
src/Dfs.Client.Desktop/ViewModels/MainViewModel.cs - File browser
src/Dfs.Client.Desktop/ViewModels/FileBrowserViewModel.cs - Transfer manager
src/Dfs.Client.Desktop/ViewModels/TransferManagerViewModel.cs - Admin panel
src/Dfs.Client.Desktop/ViewModels/AdminPanelViewModel.cs
Client runtime
- DFS client
src/Dfs.Client.Core/DfsClient.cs
Metadata service
- Metadata server
src/Dfs.MetadataServer/Hosting/MetadataServerHost.cs - Namespace operations
src/Dfs.MetadataServer/Handlers/NamespaceHandler.cs - Path resolution
src/Dfs.MetadataServer/Handlers/NamespacePath.cs - Transfer planning
src/Dfs.MetadataServer/Handlers/TransferHandler.cs - Sessions and login
src/Dfs.MetadataServer/Security/SessionService.cs - RBAC authorization
src/Dfs.MetadataServer/Security/RbacAuthorizer.cs - Metadata state
src/Dfs.MetadataServer/Store/SqliteMetadataState.cs - Operation log
src/Dfs.MetadataServer/Store/OpLog.cs
Data service
- Data server host
src/Dfs.DataServer/Hosting/DataServerHost.cs - Heartbeat client
src/Dfs.DataServer/Hosting/HeartbeatClient.cs - Chunk storage
src/Dfs.DataServer/Storage/ChunkStorage.cs
Shared protocol and contracts
- TCP frame codec
src/Dfs.Shared/Framing/FrameCodec.cs - JSON serialization
src/Dfs.Shared/Framing/FrameSerialization.cs - Protocol handshake
src/Dfs.Shared/Framing/HandshakeHandler.cs - Wire messages
src/Dfs.Shared/Messages/MessageType.cs - Metadata contract
src/Dfs.Shared/Metadata/IMetadataStore.cs - Metadata commands
src/Dfs.Shared/Commands/IMetadataCommand.cs - Permission model
src/Dfs.Shared/Security/Permission.cs
Other components
- User
- Data servers
Connections 30
- User → Desktop UI: uses
README.md - Desktop UI → File browser: opens
- Desktop UI → Transfer manager: opens
- Desktop UI → Admin panel: opens
- File browser → DFS client: calls
src/Dfs.Client.Desktop/ViewModels/FileBrowserViewModel.cs - Transfer manager → DFS client: calls
src/Dfs.Client.Desktop/ViewModels/TransferManagerViewModel.cs - Admin panel → DFS client: calls
- DFS client → Metadata server: metadata requests
- DFS client → Data servers: chunk transfers
- Metadata server → Namespace operations: dispatches
- Metadata server → Transfer planning: dispatches
- Metadata server → Sessions and login: dispatches
- Namespace operations → Path resolution: resolves paths
src/Dfs.MetadataServer/Handlers/NamespaceHandler.cs - Namespace operations → Metadata state: reads and writes
src/Dfs.MetadataServer/Handlers/NamespaceHandler.cs - Transfer planning → Metadata state: reads and writes
src/Dfs.MetadataServer/Handlers/TransferHandler.cs - Transfer planning → RBAC authorization: checks access
src/Dfs.MetadataServer/Handlers/TransferHandler.cs - Transfer planning → Data servers: plans chunk access
- Sessions and login → Metadata state: loads and updates
src/Dfs.MetadataServer/Security/SessionService.cs - RBAC authorization → Metadata state: reads permissions
src/Dfs.MetadataServer/Security/RbacAuthorizer.cs - Metadata state → Operation log: persists operations
- Heartbeat client → Metadata server: registers and reports
src/Dfs.DataServer/Hosting/HeartbeatClient.cs - Heartbeat client → Chunk storage: reads capacity
src/Dfs.DataServer/Hosting/HeartbeatClient.cs - Data server host → Chunk storage: stores chunks
- DFS client → TCP frame codec: encodes TCP
src/Dfs.Client.Core/DfsClient.cs - TCP frame codec → JSON serialization: serializes payloads
src/Dfs.Shared/Framing/FrameCodec.cs - TCP frame codec → Wire messages: uses message types
src/Dfs.Shared/Framing/FrameCodec.cs - Protocol handshake → TCP frame codec: exchanges frames
src/Dfs.Shared/Framing/HandshakeHandler.cs - Namespace operations → Metadata contract: uses store contract
src/Dfs.MetadataServer/Handlers/NamespaceHandler.cs - Metadata contract → Metadata commands: submits commands
src/Dfs.Shared/Metadata/IMetadataStore.cs - RBAC authorization → Permission model: evaluates permissions
src/Dfs.MetadataServer/Security/RbacAuthorizer.cs