انتقل إلى المحتوى

البناء أمام الجميع

إعادة بناء Financy على Seed، الجزء 1: منتج حقيقي على قالب SaaS جاهز

نُشر في · قراءة في 4 دقائق·

متوفرة أيضًا باللغات: Deutsch وEnglish وEspañol وFrançais و日本語 وPortuguês (Brasil) وРусский و简体中文

نبتة بنفسجية صغيرة تُنقل من أصيص رمادي مشقوق إلى أصيص بنفسجي جديد، وتسقيها نبتة بنفسجية كبيرة بجانبها.

باختصار

  • يبدأ Financy، تطبيقي مفتوح المصدر لتتبّع المال، من جديد كنسخة من Seed. النسخة القديمة مجمّدة في فرع منفصل، مرجعًا لما كانت تفعله.
  • أول commit فيه هو ملفات Seed ومعها 19 ملفًا خاصًا به: الرخصة وREADME وقواعد الوكلاء ووثائق المنتج وملفا ‎.seed.
  • أول مزامنة، بعد يوم من النسخ وبعد تغيير الهوية البصرية، جلبت 19 commit من Seed و616 ملفًا دون أي تعارض.
  • لا توجد بعد أي ميزة مالية. ما يحتاجه أي منتج يُبنى في Seed أولًا، ثم يأخذه Financy بمزامنة.

هل يمكن بناء منتج حقيقي على قالب SaaS جاهز مع الاستمرار في تلقّي تحديثاته؟ هذا بالضبط ما أفعله الآن مع Financy، تطبيقي المجاني مفتوح المصدر (AGPL-3.0) لتتبّع مال الفرد أو العائلة. بدأ Financy من جديد كنسخة من Seed في 3 نوفمبر 2026، وفي 4 نوفمبر تلقّى أول دفعة من تغييرات Seed: ‏19 commit و616 ملفًا، دون أي تعارض. هذه السلسلة تتابع إعادة البناء وهي تحدث.

المقال للمطوّرين الذين يختارون قالب SaaS ويريدون رؤيته في منتج حقيقي لا في عرض تجريبي، ولكل من يهمّه Financy. كل شيء هنا علني: كل رقم مأخوذ من المستودعين على GitHub، ويمكنك أن تعدّه بنفسك باستخدام git.

لماذا إعادة بناء Financy بدل إصلاحه؟

بدأ Financy الأول في أبريل 2025 ووصل إلى 157 commit. كان يدير حسابات بعدة عملات، ويحوّل بينها، وله اختبارات من البداية إلى النهاية. لكنه كان يحوي أيضًا كودًا لم أعد أثق به: كتبت جزءًا كبيرًا منه بسرعة بنماذج الذكاء الاصطناعي المتاحة آنذاك، وكانت بنيته وإدارة حالته ومزامنته ستتغيّر على أي حال ليصبح المنتج الذي أريده.

النصف الآخر من الجواب هو ما كان ينقص Financy. تطبيق مال للعائلة يحتاج إلى تسجيل دخول بالتحقق بخطوتين، ومجموعات بأدوار، وتحديثات حيّة على كل جهاز، وتطبيق يعمل دون اتصال، ولوحة إدارة، وموقع عام. هذه هي البنية التحتية لأي SaaS، لا علاقة لها بالمال، وكنت قد قضيت أكتوبر أبني معظمها في Seed (ما وصل في أكتوبر، بالإنجليزية). كتابتها مرة ثانية داخل Financy هي بالضبط الخطأ الذي وُجد Seed ليمنعه.

لذلك جُمّد Financy القديم في فرعه legacy. هو مرجع لـما يفعله Financy (ميزاته، وقواعد المال، والحالات الحدّية)، وليس أبدًا لـكيف: لا تُنقل منه حتى دالة مساعدة واحدة. قاعدة مالية مأخوذة منه هي فرضية: تصبح اختبارًا أولًا، ثم كودًا جديدًا.

كيف بدأ Financy من Seed؟

بطلب دمج واحد، financy#83: ملفات Seed ومعها 19 ملفًا تجعل النسخة هي Financy. عددتها بمقارنة أول commit في Financy مع commit ‏Seed المسجّل فيه:

git fetch https://github.com/spy4x/seed main
git diff --stat "$(git show 3d267c6f:.seed/commit)" 3d267c6f

هذه الملفات الـ19 هي: رخصة AGPL-3.0، مع إشعار MIT الخاص بـSeed في ملف مستقل؛ وREADME يقول بوضوح إن التطبيق ليس جاهزًا بعد؛ وAGENTS.md الخاص بـFinancy، أي القواعد التي يتبعها كل وكيل وكل شخص يعمل عليه؛ ووثائق المنتج؛ واسم الصورة في خط النشر، كي لا يكتب وسم من Financy فوق صور Seed أبدًا؛ وحذف ملفات إعدادات خادم Seed الأربعة المشفّرة؛ والملفان اللذان يجعلان المزامنة ممكنة.

هذان الملفان هما الحيلة كلها. ‏.seed/commit يحفظ commit ‏Seed الذي تطابقه النسخة، و.seed/skip يسرد مسارات Seed التي لا يأخذ Financy تغييراتها أبدًا، مثل README. المزامنة إذن هي git diff من ذلك الـcommit إلى main الحالي في Seed، يُطبَّق بدمج ثلاثي. الوصفة كاملة في Start a product from Seed and keep getting its updates (بالإنجليزية)، وهذا المقال يروي ما حدث حين اتّبعتها فعلًا.

هل نجحت أول مزامنة فعلًا؟

نعم، ومعها فخ صغير وضعته عمدًا. قبل المزامنة كان Financy قد غيّر ملفات من Seed: financy#123 أعطاه اسمه وأيقونة محفظة ولونه الأزرق بدل بنفسجي Seed، في 32 ملفًا. مزامنة لا تعمل إلا على نسخة لم يمسّها أحد لن تثبت شيئًا.

ثم نقل financy#127 ‏Seed من ec61062b إلى d9641f03. هذه 19 طلب دمج من Seed و616 ملفًا متغيّرًا، وطبّقها git apply --3way دون أي تعارض. ومما وصل:

  • تسجيل الدخول برمز يُرسل بالبريد الإلكتروني؛
  • سعر سنوي بجانب السعر الشهري؛
  • منطقة زمنية للمجموعة كلها؛
  • الواجهة البرمجية والـworker يعملان على Node وBun إضافة إلى Deno؛
  • إعداد يحدّد من أين يبدأ سجل تغييرات المنتج.

وأظهرت المزامنة أيضًا خطوة يقوم بها المنتج يدويًا. كان Seed قد أضاف للتو AGENTS.seed.md، وهو قواعد مستودع Seed نفسه؛ فحذفه Financy وأضافه إلى .seed/skip كي لا تعيده أي مزامنة لاحقة. بعد المزامنة يختلف Financy عن Seed في 59 ملفًا، وكل واحد منها غيّره Financy عن قصد.

ما الذي يذهب إلى Seed بدل Financy؟

كل ما قد يحتاجه أي SaaS. يحدّد AGENTS.md في Financy الترتيب: الكود الذي قد يفيد أي مشروع يذهب إلى المكتبات المشتركة @spy4x/*، والكود الذي يحتاجه أي منتج مبني على Seed يذهب إلى Seed، ولا يبقى في Financy إلا ما يحتاجه منتج مالي (الحسابات، والمعاملات، والميزانيات، وأسعار الصرف). لا حلول محلية مؤقتة "ننقلها لاحقًا": "لاحقًا" هي الطريقة التي يبتعد بها الـfork.

ثلاثة بنود من القائمة أعلاه هي هذا بالضبط. يحتاج Financy إلى فوترة سنوية، ويحتاج شهر العائلة إلى منطقة زمنية واحدة لكل أفرادها، ولا يجوز أن يبدأ سجل تغييراته بسنوات من commits التطبيق القديم. لا شيء من هذا يخصّ المال، لذا بُني كلٌّ منها في Seed ووصل إلى Financy عبر المزامنة. يومَي 3 و4 نوفمبر فُتحت في Seed ‏31 مسألة جديدة تذكر Financy، وبحلول 5 نوفمبر أُغلقت 8 منها.

ووجدت إعادة البناء ثغرات في وصفتي أنا. قائمة ما يزيله المنتج من موقع Seed كانت تفوّت عدة ملفات، والخطوة 1 كانت تسجّل أحدث commit في Seed، وقد يكون أحدث من النسخة، فتتخطّى أول مزامنة الـcommits التي بينهما بصمت. كلاهما أُصلح في Seed ‏(seed#811)، و الدليل يشرح الآن كيف تجد الـcommit الذي تطابق ملفاته ملفاتك. هذا الإصلاح يفيدك أكثر مما يفيدني: المنتج التالي على Seed لن يقع فيه.

ما الذي لم يُنجز بعد؟

معظمه. وأنا أكتب هذا، Financy هو Seed باسم Financy ورخصته ولونه. لا توجد بعد أي شاشة للحسابات أو المعاملات أو الميزانيات، فلا تحاول استخدامه الآن. حتى الاسم لم يُحسم: financy#126 تسأل هل نبقيه قبل الإطلاق.

الخطة علنية: مسائل Financy، مقسّمة على سبع مراحل، من الأساسات حتى الإطلاق وما بعده. كل ثغرة تصادفها في Seed تُصلح في Seed، لذا ستُظهر هذه السلسلة الجانبين: ما احتاجه Financy وما تعلّمه Seed منه.

تابع معي

راقب مستودع Financy (زر Watch) لترى كل طلب دمج يصل، واشترك في هذه المدوّنة ليصلك الجزء 2 بالبريد. إن كنت على وشك بدء منتجك الخاص، فـالدليل هو نفسه الذي يتبعه Financy، وإن فشلت معك خطوة منه افتح مسألة: فهذا يعني أن الوصفة تحتاج سطرًا إضافيًا.

تلقَّ المقال التالي عبر البريد

رسالة بريد إلكتروني قصيرة حين يُنشر مقال جديد أو يُطلق شيء جديد. تؤكد اشتراكك مرة واحدة عبر البريد الإلكتروني، وتلغيه بنقرة واحدة.

كل المقالات