hungdn1701 / network-programming-starter

# Project Name
> **Course:** Network Programming (INT1433) · PTIT · Instructor: Dr. Hung N. Dang
>
> *One-sentence pitch: what your system does and for whom.*
👋 **New here? Read first:** `docs/student-guide.md` · 📜 Brief & grading: `INSTRUCTION.md` · 🚀 Workflow: `GETTING_STARTED.md`
> **Template note:** replace every *(italic placeholder)* below. Sections marked **(mandatory)** are required for grading.
---
## 1. Team (mandatory)
| # | Full name | Student ID | Class | GitHub | Role |
|:-:|-----------|:----------:|:-----:|--------|------|
| 1 | | | | @ | |
| 2 | | | | @ | |
| 3 | | | | @ | |
**Topic:** *(e.g., Multi-room chat over TCP)*
---
## 2. Problem & Idea (mandatory)
- **Problem:** *(What problem are you solving? Who has it?)*
- **Our idea:** *(Your solution in 2–3 sentences.)*
- **What makes it non-trivial:** *(The networking challenge — e.g., resuming transfers, real-time sync, fairness under load.)*
- **Out of scope:** *(What you deliberately do not build.)*
Full proposal: `docs/proposal.md`
---
## 3. Features
- [ ] **Connection & session:** *(handshake, authentication, ...)*
- [ ] **Custom protocol:** specified in `docs/protocol-design.md`
- [ ] **Concurrency:** many clients at once, thread-safe shared state
- [ ] **Robustness:** abrupt disconnects, malformed messages, timeouts
- [ ] **Feature A:** *(short description)*
- [ ] **Feature B:** *(short description)*
---
## 4. Architecture
 [code] 
| Aspect | Our choice | Why (one line) |
|--------|-----------|----------------|
| Language | | |
| Transport | TCP / UDP | |
| Framing | delimiter / length-prefix / fixed | |
| Concurrency model | thread-per-client / thread pool / event loop | |
Details: `docs/architecture.md`
---
## 5. Quick Start
 [code] 
*(Add any extra steps, e.g., running a GUI client natively.)*
---
## 6. Demo & Test Evidence
*(Screenshots or terminal output of: several clients at once, abrupt disconnect handling, your concurrency test.
Put images in `docs/asset/`. Full results: `docs/testing-guide.md`.)*
---
## 7. Documentation
| Document | Content |
|----------|---------|
| `docs/proposal.md` | M1 — problem, idea, scope, plan |
| `docs/protocol-design.md` | Application-layer protocol specification |
| `docs/architecture.md` | Concurrency model, components, connection lifecycle |
| `docs/testing-guide.md` | Test methods and our test evidence |
| `docs/ai-log.md` | AI usage log |
---
## 8. AI Disclosure (mandatory)
> Policy: `INSTRUCTION.md` §7. Disclosing AI use never lowers your score — hiding it does.
### 8.1 Summary
| Tool / model | Used by | Used for | Files / modules | Level |
|--------------|---------|----------|-----------------|-------|
| *(e.g., Claude)* | *(member)* | *(e.g., draft protocol table, review locking code)* | *(paths)* | *(Assist / Co-write / Generated)* |
**Levels:** **Assist** — explanations, suggestions, review; we wrote the code. **Co-write** — AI drafted parts, we
substantially rewrote. **Generated** — AI wrote most of it; we reviewed, tested and