ندوب
أين أخطأت في Seed v1: الإفراط في الهندسة في قالب SaaS
نُشر في · قراءة في 5 دقائق· Anton Shubin
متوفرة أيضًا باللغات: Deutsch وEnglish وEspañol وFrançais و日本語 وPortuguês (Brasil) وРусский و简体中文

باختصار
- أنجز Seed v1 (من 2019 إلى 2022) 33 بندًا من 66 في خارطة طريقه، ولم ينجز أيًّا من البنود الـ17 الخاصة بتطبيق الويب ولوحة الإدارة وتطبيق PWA ورفع الملفات.
- كان فيه 31 مشروع Nx و23 صنف رسائل CQRS وتسع خدمات سحابية، كلها حول ثلاثة جداول في قاعدة البيانات.
- الإفراط في الهندسة هو أن تبني ميزةً بطريقة أعقد مما تحتاج. وليس أن تبني ميزات كثيرة.
- يبني Seed اليوم كل ميزة من أولها إلى آخرها على شكل واحد منسوخ، على خادم واحد، وفيه كل ميزات المنتج التي اكتفى v1 بالتخطيط لها.
أين أخطأت في Seed v1؟ بالغتُ في هندسته: بنيت سقالة منتج كبير قبل أن يوجد المنتج نفسه. خارطة طريقه تقول ذلك بنفسها. من أصل 66 بندًا كان 33 منجزًا، وكان هذا النصف في معظمه أدوات وتمديدات خلفية: مستودع واحد كبير (monorepo)، وقواعد lint صارمة، وخطّاف pre-commit، وأصناف أساس لـCQRS، ونشر على Google Cloud. أما النصف الآخر فبقي فيه تقريبًا كل ما يستعمله الإنسان: المجموعات، والدفع، والتحديثات الفورية، والعمل دون اتصال، ورفع الملفات، ولوحة الإدارة.
هذا المقال للمطوّرين الذين يبنون قالب SaaS خاصًا بهم، أو أول منتج SaaS لهم، ويشكّون في أنهم يلمّعون
الورشة بدل أن يصنعوا الأثاث. كل رقم هنا مأخوذ من الكود: ما زال v1 في المستودع تحت الوسم
v1-final، والأوامر التي عددتُ بها موجودة في
طلب الدمج الذي أضاف هذا المقال. لم تتأذَّ أي ذكرى؛ كل ما
فعلته أنني عددت.
ما كان Seed v1؟
«Full-stack startup monorepo template» كما وصف نفسه في ملف README، مع أفضل الممارسات من اليوم الأول. Angular في الواجهة، وNest.js وPrisma فوق PostgreSQL في الخلفية، وFirebase لتسجيل الدخول، وGoogle Cloud للتشغيل، وNx ليمسك كل ذلك معًا، وYarn للتثبيت. أول commit بتاريخ 16 يونيو 2019، وآخر واحد بتاريخ 23 ديسمبر 2022: 134 commit في ثلاث سنوات ونصف.
لم يخفت تدريجيًا، بل توقّف: جاء 55 من هذه الـcommits في آخر شهرين، ثم لا شيء، حتى بدأ Seed من جديد بتاريخ مستقل يوم 26 يناير 2026.
ماذا وعدت خارطة الطريق، وماذا بُني فعلًا؟
كانت خارطة الطريق في README تعلّم كل بند بأنه منجز أو مخطّط له. آخر تحديث لها كان يوم 25 نوفمبر 2022:
| قسم خارطة الطريق | منجز | مخطّط |
|---|---|---|
| البيئة وتنظيم الكود | 8 | 7 |
| الخلفية | 14 | 5 |
| قاعدة البيانات | 3 | 1 |
| الواجهة المشتركة (الدخول، الحالة، الاختبارات) | 6 | 3 |
| الأنماط | 2 | 0 |
| PWA (دون اتصال، إشعارات، تثبيت) | 0 | 4 |
| رفع الملفات | 0 | 4 |
| لوحة الإدارة | 0 | 3 |
| تطبيق الويب (المجموعات، الوقت الفعلي، الحساب) | 0 | 6 |
| المجموع | 33 | 33 |
كانت اشتراكات Stripe ضمن قسم الخلفية، مخطّطًا لها. أما جدول المستخدمين في لوحة الإدارة فقد وصل فعلًا في ديسمبر 2022، بعد آخر تحديث لخارطة الطريق، فلنحسبه لـv1.
ثلاث من العلامات الـ33 كانت النسخ الاحتياطي التلقائي، واستعادة نسخة احتياطية، ونسخ القراءة المتماثلة. كل واحدة منها كانت رابطًا إلى توثيق Google Cloud SQL، ووثيقة البنية التحتية نفسها قالت إن التماثل «not yet used». كنت أضع علامة على واجبات أنجزتها Google.
إلى أين ذهب العمل إذن؟
إلى الورشة. رسائل الـcommits تحمل نوعها، وهي تحكي القصة أفضل مني:
- 52 من أصل 134 commit من نوع
envأوenvironment: إعدادات، وأدوات، وCI، وتحديثات، وإعادة تسمية. و31 فقط من نوعfeat. - أول commit يتيح لإنسان أن يفعل أي شيء (واجهة API بسيطة للمستخدمين: التسجيل، وقراءة الملف
الشخصي وتعديله) هو رقم 38، بتاريخ 31 مايو 2021، بعد قرابة سنتين من الأول. وبين أول 37 commit يوجد
28 من نوع
environment. - أُعدّ الـCI ثلاث مرات: GitLab CI في يوليو 2019، ثم GitHub Actions في مارس 2021، ثم Google Cloud Build في يونيو 2021. ومع ذلك بقي CI/CD في آخر نسخة من خارطة الطريق ضمن المخطّط له.
- أربع عمليات إعادة تسمية لتطبيقات ومجلدات في يومين في فبراير 2021، ثم commit عنوانه «massive refactoring» بعد سنة.
كم من البنية لكم من البيانات؟
في مخطّط قاعدة بيانات v1 ثلاثة نماذج فقط: User وUserDevice وNotification. وحولها:
- 31 مشروع Nx: ثلاثة تطبيقات، وتطبيقان لاختبارات end-to-end، و26 مكتبة. تسجيل الدخول المشترك في الواجهة وحده كان أربع مكتبات: container وguards وstate وUI.
- 65 ملف
index.ts، و63 منها لا تفعل شيئًا سوى إعادة تصدير ملفات أخرى. - طبقة CQRS بأصناف أساس خاصة بها فوق نواقل الأوامر والاستعلامات والأحداث، تحمل 11 أمرًا و5 استعلامات و7 أحداث، ومعها 19 معالجًا.
- تسع خدمات سحابية في وثيقة البنية التحتية (Cloud Run وCloud SQL وCloud Tasks وCloud Logging وCloud IAM وFirebase Authentication وHosting وStorage، وSentry)، ودليل إعداد موسوم «WIP» يبدأ بخطوات يدوية.
- 104 حزم npm في ملف
package.jsonالجذري، منها 50 اعتمادية تشغيل.
للمقارنة: في Seed اليوم 34 حزمة workspace حول 73 جدولًا. البنية الآن تكبر مع البيانات بدل أن تسبقها.
هل كانت المشكلة كثرة الميزات؟
لا، وهذا ما أريد أن أقوله بدقة. الإفراط في الهندسة هو أن تبني ميزة بطريقة أعقد مما تحتاج: طبقات زائدة، وحماية من حالات توقيت نادرة، وأتمتة لا يشغّلها أحد. وليس معناه «هذه الميزة لا لزوم لها». قائمة أمنيات v1 كانت سليمة. في Seed اليوم كل ميزات المنتج التي اكتفى v1 بالتخطيط لها، وأكثر: مفاتيح المرور (passkeys) وعامل تحقق ثانٍ، ومجموعات بأدوار ودعوات، وفوترة Stripe لكل عضو، وتحديثات فورية، وتطبيق يعمل دون اتصال، ومخزن ملفات، ولوحة إدارة على نطاقها الخاص، وتسع لغات منها العربية (README).
بل إنه ما زال يستعمل CQRS: الأوامر والاستعلامات والأحداث يمرّ كلٌّ منها عبر ناقله الخاص، وكل تغيير في مجموعة يكتب حدثه في جدول outbox يفرغه عامل في الخلفية. النمط لم يكن المذنب قط. المذنب كان كتابة أربع مكتبات لتسجيل الدخول قبل أن توجد مجموعة واحدة.
ماذا يفعل Seed بشكل مختلف الآن؟
- شكل واحد لكل ميزة. الميزة الجديدة تنسخ ميزة الملاحظات ملفًا ملفًا وبترتيب ثابت: كل ملفات تجميعة الملاحظات. والدليل يقولها صراحة: «Do not invent a second shape»، أي لا تخترع شكلًا ثانيًا.
- خادم واحد بدل تسع خدمات. يشغّل Docker Compose التطبيق وPostgres والوكيل والمراقبة على خادم تتحكّم فيه أنت: من git clone إلى الإنتاج على خادم Hetzner واحد (بالإنجليزية).
- مبادئ تقول «لا». من مبادئ Seed: «Ship small, safe slices» و«Avoid speculative complexity» و«Add deps only with clear ROI»، أي: سلّم على شرائح صغيرة وآمنة، ولا تبنِ تعقيدًا تحسّبًا لما قد يأتي، ولا تضف اعتمادية إلا حين يكون عائدها واضحًا.
- معايير الويب قبل الأطر. الخوادم تتكلم Fetch وWeb Crypto وWebSocket، لا واجهة خاصة بمنصة واحدة: لماذا بُني Seed على معايير الويب (بالإنجليزية).
أنواع الـcommits تغيّرت أيضًا. من أصل 531 commit في Seed منذ البداية الجديدة، 194 من نوع feat و46
من نوع chore أو ci أو build. معظمها طلبات دمج مدموجة بطريقة squash، فحجمها لا يساوي حجم commits
النسخة الأولى، لكن الاتجاه واضح.
هل يفعل قالبك الشيء نفسه؟
ثلاثة فحوص سريعة مأخوذة من أرقام v1 أعلاه:
- عُدّ مجلداتك وجداولك. مكتبات أكثر من الجداول علامة إنذار.
- اقرأ النصف «المخطّط له» من خارطة طريقك. إن كان فيه كل ما سيلمسه المستخدم، فأنت تبني الورشة.
- ابحث عن الـcommit الذي استطاع فيه إنسان أن يفعل شيئًا لأول مرة. إن كان رقم 38، فمرحبًا، هذا أنا.
أو تجاوز السقالة كلها: Seed مجاني وبرخصة MIT، وأساسه مبنيّ بالفعل. انسخه وأطلق ميزتك الأولى هذا الأسبوع (بالإنجليزية).


