-
Notifications
You must be signed in to change notification settings - Fork 0
Home
GiZano edited this page Jan 23, 2026
·
1 revision
Welcome to the technical documentation hub for the Distributed Systems & IoT Class Project. This repository hosts a centralized server infrastructure and five distinct client implementations, all interoperating through a unified TCP/IP JSON protocol.
The project follows a star topology where all clients communicate exclusively with the Central Server, which acts as a message router.
- Server: Python-based, multi-threaded, handles routing and session management.
- Clients (Groups 1-5): Independent implementations (CLI, GUI, Web) developed by different student teams.
-
Shared Protocol: Defined in
utils.py, strictly enforced.
- Server Specifications & Protocol * Read this first! Contains the mandatory JSON standard, port numbers, and connection rules.
Detailed documentation for each group's specific client architecture:
- Group 1 - Client Docs (Work In Progress)
- Group 2 - Client Docs (Work In Progress)
- Group 3 - CLI Client
- Group 4 - Client Docs (Work In Progress)
- Group 5 - Client Docs (Work In Progress)
-
Shared Utilities (
utils.py): Always ensure your client imports the shared library. It contains:-
get_local_ip(): Automatic IP discovery. -
create_json_msg(): Factory for valid protocol messages. -
decode_json_msg(): Safe parser for incoming bytestreams.
-
Maintained by the Class 5H of High School Archimede in Treviglio.