DEV Community: ahmedawe2026-svg

بنيتُ «مكتب الرسالة»: تطبيق ويب مجاني وبلا أي مكتبات لتنظيم رسالة الدكتوراه

ahmedawe2026-svg — Thu, 08 Oct 2026 08:13:42 +0000

🔗 التطبيق الحيّ: https://ahmedawe2026-svg.github.io/DBA-Research-Dissertation-Assistant/
💻 الكود المصدري (رخصة MIT): https://github.com/ahmedawe2026-svg/DBA-Research-Dissertation-Assistant
🌍 النسخة الإنجليزية من هذا المقال على Dev.to: https://dev.to/ahmedawe2026svg/building-thesis-desk-a-free-zero-dependency-web-app-to-organize-a-phd-dissertation-3j5d

المشكلة: رسالة الدكتوراه موزّعة على عشرة برامج

كتابة رسالة الدكتوراه ليست مهمة واحدة، بل مهامّ متوازية: تبني الهيكل (أجزاء وأقسام)، وتقرأ وتُفهرس عشرات الدراسات، وتحافظ على قائمة مراجع بصيغة APA 7، وتتأكد أن كل اقتباس حقيقي وغير مسحوب من النشر، وتحاول أن يبقى العمل المكوّن من مئات الصفحات متّسقاً داخلياً.

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

بنيتُ «مكتب الرسالة» لجمع سير العمل كله في مكان واحد — ولإثبات نقطة: يمكن أن يعمل هذا كله في المتصفح، بلا إنترنت، بلا خادم، وبلا أي مكتبات.

لماذا JavaScript خام بلا أُطُر عمل؟

جاءت أهداف التصميم أولاً، فأبعدتني عن أُطُر العمل:

يعمل بلا إنترنت افتراضياً. الباحث على اتصال بطيء أو محدود لا يجب أن ينتظر شبكة توصيل محتوى. التطبيق ملف HTML واحد مع CSS وJS بسيطين، وبعد التحميل لا يحتاج الشبكة إطلاقاً.
الخصوصية بنيوية لا وعد. كل بيانات المستخدم في localStorage. لا خادم، ولا حساب، ولا تتبّع. الاستدعاءات الشبكية الوحيدة هي طلبات اختيارية لواجهات عامة (Crossref وOpenAlex) عندما تطلبها صراحةً. غير ذلك، لا شيء من عملك يغادر جهازك.
بلا اعتماديات = بلا تلف مع الزمن. لا node_modules، ولا خطوة بناء، ولا سطح هجوم لسلسلة التوريد، ولا إصدارات رئيسية تكسر كل شيء. إن عمل اليوم، سيعمل بعد عشر سنوات.
سهل المساهمة. أي مساهم جديد يفتح index.html في المتصفح ويبدأ العمل خلال دقائق — بلا تثبيت أي أدوات.

مفتاحان في localStorage يحملان البيانات كلها (thesis-desk-v2 لبيانات التطبيق وtd-api لإعدادات الواجهات)، مما يجعل النسخ الاحتياطي والاستضافة الذاتية أمراً بسيطاً.

ماذا يوجد داخل التطبيق

التطبيق منظّم حول المراحل الفعلية لعمل الرسالة:

١. ملف المشروع وتتبّع الهيكل

هيكل نموذجي من 7 أجزاء / 48 قسماً. تتتبّع التقدّم في كل قسم، وترى حالة التحقق، وتحصل على لوحة تبيّن موقفك الحقيقي لا المفترض.

2. قواعد التحقق

أكثر من 25 قاعدة مدمجة تكشف المشكلات الشائعة: أقسام ناقصة، ضعف الاتساق الداخلي، حقول مراجع فارغة، تعارض بين الاقتباس والدراسة… أشبه بمدقّق (linter) لسير عمل الرسالة.

3. سجل الدراسات السابقة

كل دراسة سابقة تصبح بطاقة منظّمة (المنهج، العيّنة، النتائج، الصلة). يحوّل هذا كومة ملفات PDF إلى جدول قابل للبحث والمقارنة تبني منه مراجعة الأدبيات.

4. سجل المراجع بصيغة APA 7

مدير مراجع مخصّص ينسّق المدخلات وفق APA 7 ويصنّفها (مقال دورية، كتاب، رسالة جامعية، ورقة مؤتمر…).

5. فحص المراجع (Crossref + OpenAlex)

الجزء الأكثر توفيراً للوقت: يتحقّق من المراجع عبر Crossref وOpenAlex للتأكد من وجودها، وحلّ معرّفات DOI، والتقاط المدخلات المسحوبة. (أستبعد عمداً الأعمال المسحوبة وما بلا DOI من المسارات الآلية.)

6. البحث الأكاديمي

مُنطلق نحو أكثر من 36 منصة أكاديمية لتنتقل للمصدر الصحيح بسرعة.

7. مصفوفة الاتساق

شبكة تساعدك على التحقق من اتساق الأهداف والأسئلة والفرضيات والمناهج والنتائج — نوع الاتساق الداخلي الذي يحبّ المحكّمون التنقيب فيه.

8. المولّد الآلي

بالاعتماد على موضوع ما، يستعلم OpenAlex ويرشّح النتائج ويجمّع مسوّدة أولى منظّمة لمادة مراجعة الأدبيات. هذا معين على الكتابة بوضوح: المخرَج نقطة انطلاق تُراجَع وتُحرَّر وتُتحقَّق، وليس نصاً نهائياً يُلصَق.

ملاحظات هندسية

عقلية الملف الواحد. التطبيق الأساسي ملف HTML واحد عن قصد، حتى يمكن تنزيله وتشغيله من ذاكرة USB أو مشاركته كما هو. المستودع يضمّ أيضاً نسخة مطابقة تحت standalone/.
شبكة تدريجية واختيارية. التطبيق مفيد كلياً بلا إنترنت، وميزات الشبكة (الفحص/البحث/التوليد) أفعال صريحة برسائل واضحة.
نقل البيانات. لأن كل شيء في localStorage تحت مفاتيح معلومة، فالتصدير/النسخ/الاستعادة مباشر، وبلا احتكار.
RTL أولاً. الواجهة عربية (من اليمين لليسار) مع وضع ليلي، وتعمل على الجوال.
قابلية الاختبار بلا أدوات. الكود الخام سهل الفحص والتصحيح، والمستودع فيه CI يتحقق من البنية والملفات.

ما يهمّني أكثر: الصدق في دور الأداة

أي أداة أكاديمية تولّد نصاً ملزَمة بأن توضّح دورها بوضوح تام. لذلك هذا التنبيه جزءٌ من المنتج، لا حاشية:

⚠️ تنبيه أخلاقي وعلمي:
هذا التطبيق أداة مساعدة للجمع والفحص والتنسيق، وليس بديلاً عن الباحث أو المشرف. يجب مراجعة كل مُخرَج وتحريره والتحقق منه، والالتزام بسياسة جامعتك بشأن أدوات المساعدة. النصوص المولّدة آلياً مسوّدات أولية فقط.

المولّد الآلي لا يكتب رسالتك. إنه يساعدك على الجمع والتنظيم وإنتاج مسوّدات تبقى مسؤوليتك أنت في مراجعتها والتحقق منها والدفاع عنها.

جرّبه، اكسرْه، طوّره

المشروع برخصة MIT ومفتوح فعلاً للمساهمة. هناك قضايا «بداية جيدة» في: إتاحة لوحة المفاتيح/ARIA، وصيغ تصدير إضافية (BibTeX/RIS)، والاختبارات.

🌐 حيّ: https://ahmedawe2026-svg.github.io/DBA-Research-Dissertation-Assistant/
💻 GitHub: https://github.com/ahmedawe2026-svg/DBA-Research-Dissertation-Assistant
🐛 الأفكار والمشاكل: https://github.com/ahmedawe2026-svg/DBA-Research-Dissertation-Assistant/issues

إن كنت تحضّر الدكتوراه، يسعدني أن أعرف أي جزء من سير عملك هو الأكثر إزعاجاً — فمن هناك يجب أن تأتي الميزة التالية.

⚠️ تنبيه أخلاقي وعلمي:
هذا التطبيق أداة مساعدة للجمع والفحص والتنسيق، وليس بديلاً عن الباحث أو المشرف. يجب مراجعة كل مُخرَج وتحريره والتحقق منه، والالتزام بسياسة جامعتك بشأن أدوات المساعدة. النصوص المولّدة آلياً مسوّدات أولية فقط.

Building Thesis Desk: a free, zero-dependency web app to organize a PhD dissertation

ahmedawe2026-svg — Thu, 08 Oct 2026 08:03:31 +0000

🔗 Live app: https://ahmedawe2026-svg.github.io/DBA-Research-Dissertation-Assistant/
💻 Source code (MIT): https://github.com/ahmedawe2026-svg/DBA-Research-Dissertation-Assistant

The problem: a dissertation is spread across ten tools

Writing a doctoral dissertation is not one task — it is many running in parallel. You are building a structure (chapters, parts, sections), reading and cataloguing dozens of studies, keeping a reference list in perfect APA 7 format, checking that every citation is real and retracted-free, and trying to keep the whole 200-page effort internally consistent.

Most researchers end up juggling Word documents, a reference manager, a spreadsheet for the literature review, a notes app, and a dozen browser tabs. The work is not hard because any one piece is hard — it is hard because the pieces are scattered and nothing talks to anything else.

I built Thesis Desk to put the whole workflow in one place — and to make a point: it can all run in the browser, offline, with no server and no dependencies.

Why vanilla JS, no frameworks?

The design goals came first, and they pointed away from frameworks:

Works offline, by default. A researcher on a slow or metered connection should not wait for a CDN. The app is a single HTML file plus plain CSS and JS. Once loaded, it never needs the network.
Privacy is structural, not a promise. Every bit of user data lives in localStorage. There is no backend, no account, no telemetry. The only network calls the app makes are opt-in lookups to public APIs (Crossref, OpenAlex) when you explicitly ask. Nothing about your work leaves your machine otherwise.
Zero dependency = zero rot. No node_modules, no build step, no supply-chain surface, no breaking major versions. If it works today, it will work in ten years.
Easy to contribute. A new contributor can open index.html in a browser and be productive in minutes — no toolchain to install.

Two localStorage keys hold the whole dataset (thesis-desk-v2 for the app data, td-api for API-related settings), which makes both backup and self-hosting trivial.

What's inside

The app is organized around the actual stages of dissertation work:

1. Project profile & structure tracker

A 7-part / 48-section skeleton of a typical doctoral dissertation. You track progress per section, see validation status, and get an at-a-glance dashboard of where you actually stand — not where you think you stand.

2. Validation rules

More than 25 built-in rules flag common problems: missing sections, weak internal consistency, empty reference fields, citation/study mismatches, and so on. Think of it as a linter for your dissertation workflow.

3. Literature review log

Each prior study becomes a structured card (method, sample, findings, relevance). This turns a pile of PDFs into a searchable, comparable table you can build the review from.

4. APA 7 reference log

A dedicated reference manager that formats entries in APA 7 and classifies them (journal article, book, thesis, conference paper, …).

5. Reference verification (Crossref + OpenAlex)

The part that saves the most time and pain: it checks references against Crossref and OpenAlex to confirm they exist, resolve DOIs, and catch entries that are retracted or otherwise unsafe to cite. (I deliberately exclude retracted works and items without a DOI from automated flows.)

6. Academic search

A launcher across 36+ academic platforms so you can jump to the right source quickly.

7. Consistency matrix

A grid that helps you check that objectives, questions, hypotheses, methods and findings actually line up — the kind of internal alignment reviewers love to poke at.

8. Auto-generator

Given a topic, it queries OpenAlex, filters the results, and assembles a structured first draft of literature-review material. This is explicitly a drafting aid: output is a starting point to be reviewed, edited and verified — never a finished text to paste in.

A few engineering notes

Single-file mindset. The core app is intentionally one big HTML file so it can be downloaded and run from a USB stick or shared as-is. The public repo also mirrors it under standalone/.
Progressive, opt-in network use. The app is fully useful offline. Network features (verification, search, generation) are explicit actions with clear feedback.
Data portability. Because everything is in localStorage under known keys, exporting/backing up/restoring is straightforward, and there is no lock-in.
RTL-first. It is an Arabic-first interface (RTL) with dark mode, and it works on mobile.
Testability without a toolchain. Plain DOM code is easy to inspect and patch; the repo has CI that validates the structure and assets.

The thing I care most about: honesty about what the tool does

An academic tool that generates text has an obligation to be crystal clear about its role. So this note is part of the product, not fine print:

⚠️ Ethical & academic note:
This app is a helper tool for collecting, checking and formatting — it is not a substitute for the researcher or supervisor. Every output must be reviewed, edited and verified, and you must comply with your university's policy on assistive tools. AI-generated text is only a first draft.

The auto-generator does not write your dissertation. It helps you gather, organize, and produce drafts you must still own, verify and defend.

Try it, break it, improve it

The project is MIT-licensed and genuinely open to contributions. Good first issues are open for things like keyboard/ARIA accessibility, additional export formats (BibTeX/RIS), and tests.

🌐 Live: https://ahmedawe2026-svg.github.io/DBA-Research-Dissertation-Assistant/
💻 GitHub: https://github.com/ahmedawe2026-svg/DBA-Research-Dissertation-Assistant
🐛 Issues & ideas: https://github.com/ahmedawe2026-svg/DBA-Research-Dissertation-Assistant/issues

If you are working on a PhD, I would love to hear which part of your workflow is the most painful — that is where the next feature should come from.

⚠️ Ethical & academic note:
This app is a helper tool for collecting, checking and formatting — it is not a substitute for the researcher or supervisor. Every output must be reviewed, edited and verified, and you must comply with your university's policy on assistive tools. AI-generated text is only a first draft.