# django example

### ✅ Step 1: **Model (**[**models.py**](http://models.py)**)**

This defines the structure of your database table.

```javascript
pythonCopyEdit# models.py
from django.db import models

class Patient(models.Model):
    name = models.CharField(max_length=100)
    email = models.EmailField()
```

---

### ✅ Step 2: **Form (**[**forms.py**](http://forms.py)**)**

This helps validate input and map it to the model.

```javascript
pythonCopyEdit# forms.py
from django import forms
from .models import Patient

class PatientForm(forms.ModelForm):
    class Meta:
        model = Patient
        fields = ['name', 'email']
```

---

### ✅ Step 3: **HTML Template (patient\_form.html)**

This is the form the user fills out.

```javascript
htmlCopyEdit<!-- patient_form.html -->
<form method="POST">
  {% csrf_token %}
  {{ form.as_p }}
  <button type="submit">Submit</button>
</form>
```

---

### ✅ Step 4: **View (**[**views.py**](http://views.py)**)**

This processes the form and saves the data to the database.

```javascript
pythonCopyEdit# views.py
from django.shortcuts import render, redirect
from .forms import PatientForm

def register_patient(request):
    if request.method == 'POST':
        form = PatientForm(request.POST)
        if form.is_valid():
            form.save()  # ✅ This saves the data to the database
            return redirect('success')  # or wherever you want
    else:
        form = PatientForm()
    return render(request, 'patient_form.html', {'form': form})
```

---

### ✅ Step 5: **URL (**[**urls.py**](http://urls.py)**)**

Connects the view to a URL.

```javascript
pythonCopyEdit# urls.py
from django.urls import path
from . import views

urlpatterns = [
    path('register/', views.register_patient, name='register'),
]
```

---

### Final Flow:

1. User opens `/register/` page → sees the form.
    
2. User fills the form and clicks **Submit**.
    
3. Django **validates** the form.
    
4. If valid → [`form.save`](http://form.save)`()` saves data to the database table `Patient`.
    

Now, what Django is doing here with `forms.Form` is helping you on the **backend** — to:

✅ Validate the data  
✅ Easily connect the form to your database  
✅ Show errors automatically if something’s wrong  
✅ Reuse the form code and make it secure

---

### So here's the difference:

🖼️ **Your HTML form** = What the user sees and fills (frontend)  
🐍 **Django Form (**`forms.Form`) = Python code that helps handle and validate that data (backend)

---

### For example:

If your HTML form sends:

```javascript
<input type="text" name="first_name" />
```

Django will catch it using:

```javascript
first_name = forms.CharField(max_length=100)
```

Then Django can check:

* Is the first name empty? ❌
    
* Is it too long? ❌
    
* Is the phone number exactly 10 digits? ✅ or ❌
    
* Do the passwords match? ✅ or ❌
    
* Did the user agree to the terms? ✅
    

\==================================================================

Sure! Here's a **complete and simple working example** that includes:

✅ Django model  
✅ Django ModelForm  
✅ View to handle form submission  
✅ HTML file with manual `<input>` fields (not `{{` [`form.as`](http://form.as)`_p }}`)  
✅ How data flows to the database

---

### 🧩 1. [`models.py`](http://models.py)

```javascript
from django.db import models

class Patient(models.Model):
    first_name = models.CharField(max_length=100)
    email = models.EmailField(unique=True)

    def __str__(self):
        return self.first_name
```

---

### 🧩 2. [`forms.py`](http://forms.py)

```javascript
from django import forms
from .models import Patient

class PatientForm(forms.ModelForm):
    class Meta:
        model = Patient
        fields = ['first_name', 'email']
```

---

### 🧩 3. [`views.py`](http://views.py)

```javascript
from django.shortcuts import render, redirect
from .forms import PatientForm

def register_patient(request):
    if request.method == 'POST':
        form = PatientForm(request.POST)
        if form.is_valid():
            form.save()
            return redirect('success')  # You can define a simple success page
    else:
        form = PatientForm()
    return render(request, 'patient_form.html', {'form': form})
```

---

### 🧩 4. [`urls.py`](http://urls.py)

Make sure to add this in your [`urls.py`](http://urls.py):

```javascript
from django.urls import path
from . import views

urlpatterns = [
    path('register/', views.register_patient, name='register'),
    path('success/', views.success, name='success'),  # optional
]
```

Add a success view if needed:

```javascript
pythonCopyEditdef success(request):
    return render(request, 'success.html')
```

---

### 🧩 5. `patient_form.html` (manual input tags)

```javascript
htmlCopyEdit<!DOCTYPE html>
<html>
<head>
  <title>Patient Registration</title>
</head>
<body>
  <h2>Register</h2>

  <form method="POST">
    {% csrf_token %}

    <label>First Name:</label>
    <input type="text" name="first_name" required><br><br>

    <label>Email:</label>
    <input type="email" name="email" required><br><br>

    <button type="submit">Submit</button>
  </form>

</body>
</html>
```

---

### ✅ Flow Summary

1. **User fills the form** → HTML sends data to view via `POST`
    
2. **View** gets form data → Validates → Saves using [`form.save`](http://form.save)`()`
    
3. **Data gets stored in the database** using Django ORM
    
4. **Redirect to success page** (optional)
    
5. \==========================================================
    
    ### ✅ The `name` attribute in your HTML input:
    

```javascript
<input type="text" name="first_name">
```

**MUST match the field name in your Django** `ModelForm` — which in turn must match the name in your `Model`.

---

### 🔁 All 3 should be in sync:

| Layer | Field Name |
| --- | --- |
| **Model** | `first_name` |
| **Form** | `first_name` |
| **HTML** | `name="first_name"` |

---

### ✅ Why this matters:

When you submit the form:

* Django collects the data using the `name` values in the HTML.
    
* It maps those to the `fields` in the `ModelForm`.
    
* The `ModelForm` maps those to your database model and saves them.
    

If the names don’t match, Django won’t be able to connect the dots.

\=========================================================

### ✅ You should **store data from the signup page** in the database.

#### Why?

* The **signup page** is where a user registers their details (like name, email, password, etc.).
    
* This data needs to be saved in your **database** so you can use it later to check if the user exists when they try to log in.
    

### ❌ You should **not store data from the login page**.

* The **login page** is only for checking if the entered email/password matches what's already stored in your database.
    
* It just verifies, not stores.
    

### 🌟 Why use Django forms if we are only taking values and storing them?

Because Django forms do more than just capture input — they:

---

### ✅ 1. **Validate input automatically**

For example:

* Is the email valid?
    
* Is the phone number too long?
    
* Did the user leave a required field empty?
    

With Django forms, you don’t need to write all those checks yourself.

---

### ✅ 2. **Make rendering forms easier**

Instead of manually writing lots of `<input>` tags and error messages in HTML, you just write this in the template:

```javascript
htmlCopyEdit{{ form.as_p }}
```

And Django takes care of rendering all form fields with labels, input tags, and error messages (if any).

---

### ✅ 3. **Make saving to the database easier**

Using a `ModelForm`, you can directly save data to the database with just:

```javascript
pythonCopyEditform.save()
```

No need to write code to extract values and assign them to a model manually.

So, `'patient': patient` is basically telling Django to pass the `patient` object to the template, and you can use the key `'patient'` to access the patient data inside the template.