🛠️ Structure & Data Builder Manual
The Smart Result Builder is the heart of the software. This is where you define your school details, create classes, subjects, and enter student marks.
1. Institute & Visual Settings
Setup Your Branding
- Institute Name: Enter your school or madrasa name (e.g., "Al-Huda Academy").
- Exam Name: Define the exam title (e.g., "Annual Examination 2026").
- Logo & Background: Click "Choose File" to upload your school logo (PNG/JPG) and a background watermark.
- Typography:
- Select "Urdu (Nastaleeq)" if you are creating Urdu cards.
- Select "Right to Left (RTL)" for Urdu/Arabic layouts.
2. Class Structure (The Setup)
Create Classes & Subjects
- Add Class: Enter a name (e.g., "Class 9th"), Total Marks, and Pass %. Click + Add Class.
- Total Mode (Auto/Manual):
- Auto Sum: Automatically calculates total marks based on subjects added.
- Manual: You define a fixed total (e.g., 550) regardless of subject sums.
- Add Subjects: Inside the class box, type a Subject Name (e.g., "English"), Total Marks (e.g., 100), and Pass Marks (e.g., 33). Click Add Subject.
Note: You can delete subjects or classes using the red delete/cross buttons.
3. Student Data Entry (The Magic)
Excel Copy-Paste Feature
You do not need to type every student manually! Follow these steps:
- Select your class from the dropdown menu.
- Open your Excel Sheet containing: Roll No, Name, Father Name, Subject Marks.
- Copy the data from Excel (Ctrl + C).
- In the software, click the First Cell (Roll No) of the first row.
- Press Ctrl + V to paste.
The software will automatically create rows and fill in all the data for you.
4. Saving Your Data
Once you are done, click the green 💾 Save JSON button. This will download a file to your computer. Keep this file safe! You will load this file into the Card Generator and Result Viewer.
🛠️ اسٹرکچر اور ڈیٹا بلڈر - ہدایت نامہ
اسمارٹ رزلٹ بلڈر اس سافٹ ویئر کا دل ہے۔ یہاں آپ اپنے اسکول کی تفصیلات، کلاسز، مضامین اور طلباء کے نمبرز درج کرتے ہیں۔ یہاں بنائی گئی ڈیٹا فائل (JSON) باقی تمام ٹولز میں استعمال ہوتی ہے۔
۱۔ ادارہ اور بصری ترتیبات (Settings)
اپنی برانڈنگ سیٹ کریں
- ادارے کا نام: اپنے اسکول یا مدرسے کا نام لکھیں (مثلاً: "الحق اکیڈمی")۔
- امتحان کا نام: امتحان کا عنوان دیں (مثلاً: "سالانہ امتحان ۲۰۲۶")۔
- لوگو اور بیک گراؤنڈ: اپنے اسکول کا مونوگرام اور واٹر مارک اپ لوڈ کریں۔
- ٹائپوگرافی (لکھائی):
- اگر آپ اردو کارڈ بنا رہے ہیں تو "Urdu (Nastaleeq)" منتخب کریں۔
- اردو کے لیے سمت "Right to Left (RTL)" منتخب کریں۔
۲۔ کلاس کا ڈھانچہ (Class Structure)
کلاس اور مضامین بنائیں
- کلاس شامل کریں: نام (مثلاً "نہم کلاس")، کل نمبر اور پاس فیصد لکھیں۔ + Add Class پر کلک کریں۔
- ٹوٹل موڈ (Auto/Manual):
- Auto Sum: مضامین کے نمبروں کو خودکار جمع کر کے ٹوٹل بنائے گا۔
- Manual: آپ اپنی مرضی کا فکس ٹوٹل (مثلاً 500) رکھ سکتے ہیں۔
- مضمون شامل کریں: مضمون کا نام (مثلاً "اردو")، کل نمبر اور پاس نمبر لکھ کر Add Subject پر کلک کریں۔
۳۔ اسٹوڈنٹ ڈیٹا انٹری (جادوئی فیچر)
ایکسل (Excel) کاپی پیسٹ
آپ کو ہر طالب علم کا ڈیٹا ہاتھ سے لکھنے کی ضرورت نہیں! درج ذیل طریقہ اپنائیں:
- ڈراپ ڈاؤن سے اپنی کلاس منتخب کریں۔
- اپنی ایکسل شیٹ کھولیں جس میں: رول نمبر، نام، ولدیت، اور نمبرز موجود ہوں۔
- ایکسل سے ڈیٹا کاپی کریں (Ctrl + C)۔
- سافٹ ویئر میں آکر پہلی قطار کے پہلے خانے (Roll No) پر کلک کریں۔
- کی بورڈ سے Ctrl + V دبائیں۔
سافٹ ویئر خودکار طریقے سے تمام قطاریں بنا دے گا اور ڈیٹا بھر دے گا۔
۴۔ ڈیٹا محفوظ کرنا
کام مکمل ہونے پر سبز رنگ کے 💾 Save JSON بٹن پر کلک کریں۔ یہ فائل آپ کے کمپیوٹر میں محفوظ ہو جائے گی۔ اس فائل کو سنبھال کر رکھیں، یہی فائل رزلٹ کارڈ بنانے کے لیے استعمال ہوگی۔
🛠️ دليل المستخدم - منشئ الهيكل والبيانات
يعد Smart Result Builder قلب البرنامج. هنا تقوم بتحديد تفاصيل مدرستك، وإنشاء الفصول والمواد، وإدخال درجات الطلاب. يتم استخدام ملف البيانات (JSON) الذي تم إنشاؤه هنا بواسطة جميع الأدوات الأخرى.
١. إعدادات المعهد والمظهر
إعداد الهوية البصرية
- اسم المعهد: أدخل اسم مدرستك أو معهدك.
- اسم الامتحان: حدد عنوان الامتحان (مثل "الامتحان السنوي ٢٠٢٦").
- الشعار والخلفية: قم بتحميل شعار المدرسة وصورة العلامة المائية.
- الخط والاتجاه:
- اختر "Arabic" للخطوط العربية الجميلة.
- اختر "Right to Left (RTL)" لاتجاه النص من اليمين لليسار.
٢. هيكل الفصل (Class Structure)
إنشاء الفصول والمواد
- إضافة فصل: أدخل الاسم، المجموع الكلي، ونسبة النجاح. انقر على + Add Class.
- وضع المجموع (Total Mode):
- Auto Sum: يحسب تلقائياً مجموع درجات المواد.
- Manual: تحدد أنت المجموع الكلي يدوياً.
- إضافة مواد: اكتب اسم المادة، الدرجة الكلية، ودرجة النجاح، ثم انقر Add Subject.
٣. إدخال بيانات الطالب (الميزة الذكية)
النسخ واللصق من إكسل (Excel)
لا تحتاج إلى كتابة كل طالب يدوياً! اتبع الخطوات التالية:
- اختر الفصل من القائمة المنسدلة.
- افتح ملف Excel الذي يحتوي على: رقم الجلوس، الاسم، اسم الأب، الدرجات.
- انسخ البيانات من Excel (Ctrl + C).
- في البرنامج، انقر فوق الخلية الأولى (Roll No) في الصف الأول.
- اضغط Ctrl + V للصق.
سيقوم البرنامج بإنشاء الصفوف تلقائياً وملء جميع البيانات.
٤. حفظ البيانات
بمجرد الانتهاء، انقر فوق الزر الأخضر 💾 Save JSON. سيتم تنزيل ملف على جهاز الكمبيوتر الخاص بك. احتفظ بهذا الملف! ستستخدمه لاحقاً لإنشاء البطاقات.