تخطي إلى المحتوى الرئيسي
خلف الكواليس

كيف نبنيتواصل فعلياً

مطوّر واحد وذكاء اصطناعي متقدم. خمسة أشهر. الأساس جاهز والفريق يكبر. هذه الأرقام الحقيقية، الأدوات، والمنهجية وراء تواصل.

01

الأرقام

مقاييس حقيقية من مستودعات git الخاصة بنا. بدون أرقام مبالغ فيها — كل إحصائية مسحوبة مباشرة من الكود.

438,000+

سطر برمجي

1,400+

Git Commit

65

مواصفة

4,200+

مهمة

32

تطبيق Django

24

شاشة موبايل

1,000+

ملف ترجمة

5

أشهر تطوير

02
المنهجية

تطوير مبني على المواصفات

كل ميزة تبدأ كمواصفة مكتوبة، وليس كمهمة في Jira. بنينا إطار عمل مخصص اسمه SpecKit يفرض مساراً صارماً من الفكرة إلى كود الإنتاج.

1

التحديد

وصف الميزة بلغة طبيعية يصبح مواصفة منظمة مع قصص المستخدم ومعايير القبول وحدود النطاق.

2

التخطيط

البنية التقنية ونماذج البيانات وعقود API وهيكل الملفات — كلها موثقة قبل كتابة سطر كود واحد.

3

المهام

تقسيم مهام مرتب حسب التبعيات مع علامات التوازي ونقاط التحقق وبوابات المراحل. كل مهمة لها تتبع على مستوى الملفات.

4

التنفيذ

الذكاء الاصطناعي ينفذ المهام بالتسلسل، يحمّل السياق لكل مهمة من الدستور ومراجع الأنماط. مراجعات مصغرة بعد كل مهمة.

5

المراجعة

مراجعة كود ملتزمة بالدستور مع تصنيف حسب الخطورة (حاجز/خطأ/تحذير/ملاحظة)، ربط بالمواصفات، واقتراحات إصلاح تلقائية.

كتبنا 65 مواصفة ميزة عبر المشروع، أنتجت أكثر من 4,200 مهمة مُتتبعة بنسبة إنجاز 68%.

github/spec-kit

الدستور

وثيقة حية من 2,168 سطراً تضم 24 مبدأ هندسياً يلتزم به كل سطر كود. من مفاتيح UUIDv7 إلى عزل بيانات المدارس، ومن تطابق الترجمات إلى معايير سهولة الاستخدام — الدستور هو المرجع الوحيد.

24 مبدأ يغطي جودة الكود والأمان والصلاحيات والترجمة وإمكانية الوصول والأداء واتساق التصميم.

claude-code — speckit
/speckit.specify "Add homework submission system"
→ spec.md created (12 user stories, 34 acceptance criteria)
/speckit.plan
→ plan.md generated (data model, API contracts, file structure)
/speckit.tasks
→ tasks.md: 47 tasks across 5 phases, 12 parallelizable
/speckit.implement
→ Phase 1/5: Setup ████████████████ 6/6 complete
→ Phase 2/5: Core ██████████████░░ 11/13...
/akhiq.review
→ 0 BLOCKER · 0 ERROR · 2 WARNING · 4 INFO
→ Constitution compliance: 24/24 principles PASS ✓
cat constitution.md
1# Tawaasal Engineering Constitution v1.16.0
2
3## Core Principles (24 total)
4
5### I. Code Quality First
6 - No N+1 queries — use select_related(), prefetch_related()
7 - TypeScript strict mode, no `any` types
8 - All icon buttons MUST have aria-label
9
10### II. Security & Authorization (NON-NEGOTIABLE)
11 - Multi-tenant isolation at database query level
12 - Permission checks at API level, never trust frontend
13
14### XVI. i18n Compliance (BLOCKING)
15 - Every user-facing string in EN + AR translation files
16 - RTL layout with ltr:/rtl: Tailwind prefixes
17
18### XXIV. UUIDv7 Primary Keys (NON-NEGOTIABLE)
19 - All models inherit UUIDv7BaseModel
20 - Time-ordered, non-enumerable, offline-safe
21
22# 2,168 lines · 24 principles · enforced on every commit
03
أدوات الذكاء الاصطناعي

الأدوات التي نستخدمها

بناء تطبيق إنتاجي بالذكاء الاصطناعي يتطلب أكثر من أداة واحدة. كل أداة تخدم غرضاً مختلفاً في سير العمل.

04
البنية المعمارية

البنية التقنية الكاملة

ثلاث منصات، فلسفة واحدة. كل طبقة تلتزم بنفس الدستور ونفس منهجية التطوير.

الخلفية

v3.14 / v5.2

Python 3.14، Django 5.2، DRF — 32 تطبيقاً، 509 ملفات، 151 ألف سطر. متعدد المستأجرين عبر django-tenants مع PostgreSQL 17. مفاتيح UUIDv7 أولية، صلاحيات مركزية، تسجيل تدقيق.

الواجهة الأمامية

v19 / v5.9

React 19، TypeScript 5.x، Vite — 629 ملفاً، 183 ألف سطر. Tailwind CSS، Framer Motion، حالة Zustand، react-i18next مع دعم ثنائي اللغة EN/AR كامل وتخطيط RTL.

الموبايل

v3.38 / v3.10

Flutter 3.38، Dart 3.10، Riverpod — 500 ملف، 104 آلاف سطر. 24 وحدة ميزات، يعمل بدون إنترنت مع Drift/SQLite، 20 سمة جاهزة، ومصادقة بالبصمة.

الترجمة المشتركة

1,003 files

1,003 ملف ترجمة بالإنجليزية والعربية. كل نص يراه المستخدم يمر عبر نظام ترجمة موحّد — الخلفية والواجهة والموبايل كلها تعتمد على مصدر واحد.

05
الجدول الزمني

البداية

خمسة أشهر من أول إيداع إلى منصة إنتاجية كاملة بأكثر من 438 ألف سطر كود. هذا هو الأساس — ما يأتي بعده أكبر.

01

نوفمبر 2025

انطلاقة المشروع. أساس الخلفية، بنية متعددة المستأجرين، إدارة المستخدمين، وأول تطبيقات Django. تأسيس سير عمل SpecKit.

02

ديسمبر 2025

الميزات الأساسية: الواجبات، التقييم، الحضور، التقويم، الرسائل، نظام الصلاحيات، وإدارة الاشتراكات. إكمال أكثر من 20 مواصفة.

03

يناير 2026

ميزات متقدمة: الحماية، قوالب الاتصال، استيراد/تصدير البيانات، محرر نص غني، إدارة دورة حياة الطالب.

04

فبراير 2026

تطبيق Flutter للموبايل: تجارب الطالب والولي والمعلم والموظف. مزامنة بدون اتصال، نظام سمات، وتكافؤ عبر المنصات.

05

مارس 2026

الموقع التسويقي، نظام إدارة المحتوى، الصفحات العامة، وهذه الصفحة التي تقرأها الآن. ثورة تصميم UI عبر الويب والموبايل.

ما التالي

توسيع الفريق، استقطاب مدارس تجريبية، وبناء الميزات التي تحوّل المنصة إلى منتج. الأساس جاهز — حان وقت التوسّع.

تريد تجربتها بنفسك؟

خمسة أشهر من الهندسة بمطوّر واحد والذكاء الاصطناعي. تخيّل ما سيحققه فريق متنامٍ. جرّب العرض التجريبي واكتشف ما أنجزناه.