📄️ بخش ۱: نمای کلی و مدل ذهنی
مدل Runtime، Objectهای اصلی، جهت Callbackها و چرخهی عمر تونل که باید پیش از تغییر هر تونل WaterWall بشناسید.
📄️ بخش ۲: Line و طول عمر
چرخهی عمر اتصال، خطرهای Re-entrancy، قفلکردن Line و الگوهای Finish صحیح که جلوی خطاهای Use-after-free را در تونلهای WaterWall میگیرند.
📄️ بخش ۳: بافر و Padding
مدل بافر sbuf_t، Buffer Poolهای Worker، بودجهی Padding سمت چپ و روش افزودن Header پروتکل بدون شکستن قابلیت ترکیب زنجیره.
📄️ بخش ۴: تونلهای Packet
معنای Packet Line، تونلهای Packet خالص، پلهای Packet/Stream، مقداردهی Packet Line و قواعد جهت در تونلهای جفت برای کارهای Layer 3.
📄️ بخش ۵: ساختار و روند کار
چیدمان فایلهای یک تونل WaterWall، مسئولیت هر فایل، Metadata در node.c، الگوهای Create و Line State، محدودیتهای HTTP و روند پیادهسازی.
📄️ بخش ۶: Build، Test و Review
Presetهای CMake، Buildهای متمرکز، ابزار آزمایش Integration، نکات محیط Build، Checklist کامل Review و قالب گزارش مورد انتظار از Coding Agentها.
📄️ Part 7: Shutdown & Signals
The three process shutdown APIs, the shutdown phase state machine, exit-code arbitration, worker stop/join rules, and how to classify a termination call site.