سير عمل / أتمتة
توليد توثيق تلقائي من تعليقات الكود (n8n + Ollama)
Git commit → استخراج تعليقات الدوال → توليد Markdown موحّد بـ Ollama → نشر في Docusaurus.
الهدف من مسار العمل
توثيق دائم التحديث بدون تكلفة كاتب تقني متفرّغ.
خطوات التشغيل التفصيلية
الخطوات
خطوة
الأدوات في هذه الخطوة
مخطط سير العمل
رسم بياني مُولَّد تلقائيًا
flowchart RL
S1["1. GitHub webhook on push"]
S2["2. Diff changed files"]
S3["3. Extract docstrings/comments"]
S4["4. Ollama generate Markdown reference"]
S5["5. Commit to docs/ branch"]
S6["6. Docusaurus auto-rebuild"]
S7["7. Telegram notify writer"]
S1 --> S2
S2 --> S3
S3 --> S4
S4 --> S5
S5 --> S6
S6 --> S7
subgraph Tools["🔧 الأدوات المستخدمة"]
T0(("n8n"))
T1(("Ollama"))
T2(("GitHub Webhook"))
T3(("Docusaurus"))
end
style Tools fill:#fffbeb,stroke:#f59e0b,stroke-width:1px
n8n
Ollama