From c5d5c1408c4c6847c2924ffb7661c59b9258a119 Mon Sep 17 00:00:00 2001
From: Khaled Mahfouz <khaledmhfz2004@gmail.com>
Date: Wed, 11 Jun 2025 18:19:44 +0300
Subject: [PATCH] - version : 0.7

- description : adding download template option and move (template.csv -> templates/template.csv).
---
 app.py                                 | 17 ++++++---
 templates/index.html                   | 51 +++++++++++++++-----------
 template.csv => templates/template.csv |  0
 3 files changed, 41 insertions(+), 27 deletions(-)
 rename template.csv => templates/template.csv (100%)

diff --git a/app.py b/app.py
index 89aaa5f..32fe7db 100644
--- a/app.py
+++ b/app.py
@@ -2,7 +2,7 @@ import sqlite3
 import csv
 import io
 import re
-from flask import Flask, render_template, request, redirect, url_for, flash
+from flask import Flask, render_template, request, redirect, url_for, flash, send_from_directory
 
 # --- App Setup ---
 app = Flask(__name__)
@@ -50,8 +50,8 @@ def validate_phone(phone):
 def validate_student_data(form_data, is_csv=False):
     errors = []
     required_fields = ['student_name', 'age', 'parent_name', 
-                      'parent_phone_1', 'grade', 'school_name', 
-                      'address', 'memorizing']
+                       'parent_phone_1', 'grade', 'school_name', 
+                       'address', 'memorizing']
 
     # Check required fields
     for field in required_fields:
@@ -197,7 +197,7 @@ def import_csv():
                 student_data['address'],
                 student_data['memorizing']
             ))
-        
+            
         # Process validation results
         if row_errors:
             flash(f'تم العثور على أخطاء في {len(row_errors)} سطراً', 'warning')
@@ -228,5 +228,12 @@ def import_csv():
     
     return redirect(url_for('index'))
 
+# New route to download the CSV template
+@app.route('/download_csv_template')
+def download_csv_template():
+    # The directory where the template.csv is located (your templates folder)
+    # The second argument is the filename to be sent
+    return send_from_directory(app.template_folder, 'template.csv', as_attachment=True)
+
 if __name__ == '__main__':
-    app.run(debug=True)
\ No newline at end of file
+    app.run(debug=True)
diff --git a/templates/index.html b/templates/index.html
index f125098..2eae81d 100644
--- a/templates/index.html
+++ b/templates/index.html
@@ -62,33 +62,40 @@
     </div>
     
     <div class="bg-white p-6 rounded-xl shadow-lg mb-8">
-        <h2 class="text-2xl font-semibold mb-4 text-gray-800 border-b pb-4">استيراد من ملف CSV</h2>
-        <div class="bg-yellow-50 border border-yellow-200 text-yellow-800 text-sm p-4 rounded-lg mt-4">
-            <p class="font-bold">هام: تنسيق ملف CSV</p>
-            <p>يجب أن يكون الملف بصيغة CSV ومرمّزاً بترميز UTF-8.</p>
-            <p>يجب **ألا يحتوي** الملف على صف للعناوين، ويجب أن تكون الأعمدة بالترتيب الدقيق التالي:</p>
-            <p class="mt-2" style="direction: ltr; text-align: right;">
-                <code class="text-xs font-mono">اسم الطالب, العمر, اسم ولي الأمر, هاتف ولي الأمر 1, هاتف ولي الأمر 2, هاتف الطالب, الصف, اسم المدرسة, العنوان, المحفوظات</code>
-            </p>
-            <p>إذا كانت الحقول الاختيارية (هاتف ولي الأمر 2، هاتف الطالب) فارغة، اتركها كذلك.</p>
-        </div>
-        <div class="mt-6 text-left">
-            <form id="import-form" action="{{ url_for('import_csv') }}" method="POST" enctype="multipart/form-data">
-                <input type="file" name="file" id="csv-file-input" class="hidden" required accept=".csv">
+	    <h2 class="text-2xl font-semibold mb-4 text-gray-800 border-b pb-4">استيراد من ملف CSV</h2>
+	    <div class="bg-yellow-50 border border-yellow-200 text-yellow-800 text-sm p-4 rounded-lg mt-4">
+		    <p class="font-bold">هام: تنسيق ملف CSV</p>
+		    <p>يجب أن يكون الملف بصيغة CSV ومرمّزاً بترميز UTF-8.</p>
+		    <p>يجب **ألا يحتوي** الملف على صف للعناوين، ويجب أن تكون الأعمدة بالترتيب الدقيق التالي:</p>
+		    <p class="mt-2" style="direction: ltr; text-align: right;">
+		    <code class="text-xs font-mono">اسم الطالب, العمر, اسم ولي الأمر, هاتف ولي الأمر 1, هاتف ولي الأمر 2, هاتف الطالب, الصف, اسم المدرسة, العنوان, المحفوظات</code>
+		    </p>
+		    <p>إذا كانت الحقول الاختيارية (هاتف ولي الأمر 2، هاتف الطالب) فارغة، اتركها كذلك.</p>
+		    {# Added link to download CSV template #}
+		    <p class="mt-3">
+		    <a href="{{ url_for('download_csv_template') }}" class="text-blue-600 hover:underline font-semibold" download>
+			    تنزيل قالب CSV
+		    </a>
+		    </p>
+	    </div>
+	    <div class="mt-6 text-left">
+		    <form id="import-form" action="{{ url_for('import_csv') }}" method="POST" enctype="multipart/form-data">
+			    <input type="file" name="file" id="csv-file-input" class="hidden" required accept=".csv">
 
-                <button type="button" id="choose-file-button" class="px-6 py-2 bg-green-600 text-white font-semibold rounded-lg shadow-md hover:bg-green-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-green-500 transition-all">
-                    اختر ملف
-                </button>
+			    <button type="button" id="choose-file-button" class="px-6 py-2 bg-green-600 text-white font-semibold rounded-lg shadow-md hover:bg-green-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-green-500 transition-all">
+				    اختر ملف
+			    </button>
 
-                <span id="file-name-display" class="hidden ml-4 text-gray-700"></span>
+			    <span id="file-name-display" class="hidden ml-4 text-gray-700"></span>
 
-                <button type="submit" id="submit-import-button" class="hidden px-6 py-2 bg-blue-600 text-white font-semibold rounded-lg shadow-md hover:bg-blue-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-blue-500 transition-all">
-                    تأكيد ورفع الملف
-                </button>
-            </form>
-        </div>
+			    <button type="submit" id="submit-import-button" class="hidden px-6 py-2 bg-blue-600 text-white font-semibold rounded-lg shadow-md hover:bg-blue-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-blue-500 transition-all">
+				    تأكيد ورفع الملف
+			    </button>
+		    </form>
+	    </div>
     </div>
 
+
     <div class="bg-white p-6 rounded-xl shadow-lg">
         <div class="flex justify-between items-center mb-4 pb-4 border-b">
             <h2 class="text-2xl font-semibold text-gray-800">الطلاب المسجلون</h2>
diff --git a/template.csv b/templates/template.csv
similarity index 100%
rename from template.csv
rename to templates/template.csv