Bài 03: Django Apps

Apps Là Gì?

Định Nghĩa

Django App là một Python package thực hiện một chức năng cụ thể trong web application. Mỗi app là một module độc lập, self-contained, có thể reuse trong nhiều projects khác nhau.

Ví dụ thực tế:

E-commerce Website├── products/          # App quản lý sản phẩm├── cart/              # App giỏ hàng├── orders/            # App đơn hàng├── users/             # App người dùng├── reviews/           # App đánh giá└── payment/           # App thanh toán

Mỗi app tập trung vào một chức năng duy nhất và có thể hoạt động độc lập.

App vs Project

Sự khác biệt:

Aspect	Project	App
Định nghĩa	Toàn bộ website	Module chức năng
Số lượng	1 project	Nhiều apps
Scope	Toàn bộ codebase	Chức năng cụ thể
Reusability	Project-specific	Có thể reuse
Example	E-commerce site	Blog, Shop, Users

Ví dụ minh họa:

# PROJECT: mysite/#   Toàn bộ e-commerce website # APPS:# - blog/        ← App cho blog# - shop/        ← App cho cửa hàng# - accounts/    ← App cho user management # Mỗi app có thể dùng lại:# - blog/ → Dùng trong project khác# - shop/ → Dùng cho site khác

Django's Pluggable Apps Philosophy

Django khuyến khích "pluggable apps" - apps có thể plug in/out dễ dàng:

# settings.pyINSTALLED_APPS = [    # Built-in Django apps    'django.contrib.admin',    'django.contrib.auth',        # Third-party apps (plug in)    'rest_framework',        # Django REST Framework    'django_filters',        # Filtering support        # Your custom apps    'blog',    'shop',    'accounts',] # Muốn disable blog? → Comment out# 'blog',  # ← Disabled

Benefits:

✅ Modularity: Code tổ chức rõ ràng
✅ Reusability: Dùng lại app trong projects khác
✅ Maintainability: Dễ maintain và debug
✅ Testing: Test từng app độc lập
✅ Team collaboration: Nhiều người làm nhiều apps

Khi Nào Tạo App Mới?

Nên tạo app mới khi:

# ✅ Chức năng riêng biệt, có thể đứng độc lậpblog/          # Quản lý blog postscomments/      # Hệ thống commentanalytics/     # Tracking và analytics # ✅ Có thể reuse trong projects khácauthentication/  # Custom auth systemnotifications/   # Notification systemapi/            # RESTful API # ✅ Code base quá lớn, cần splitproducts/       # Từ shop/ app quá lớncategories/     # Split từ products/

KHÔNG nên tạo app khi:

# ❌ Quá nhỏ, chỉ 1-2 modelsuser_settings/   # Chỉ 1 model → Nên gộp vào users/ # ❌ Phụ thuộc quá nhiều vào app khácorder_items/     # Nên là part of orders/ # ❌ Chỉ dùng cho 1 project specificmysite_specific/  # Không reusable

Tạo App với startapp

Basic Command

# Syntaxpython manage.py startapp app_name # Example: Tạo blog apppython manage.py startapp blog # Output structure:# blog/#   ├── __init__.py#   ├── admin.py#   ├── apps.py#   ├── models.py#   ├── tests.py#   └── views.py#   └── migrations/#       └── __init__.py

Naming Conventions

Good app names:

# ✅ Descriptive, plural nounpython manage.py startapp productspython manage.py startapp articlespython manage.py startapp users # ✅ Clear purposepython manage.py startapp authenticationpython manage.py startapp apipython manage.py startapp dashboard

Bad app names:

# ❌ Too genericpython manage.py startapp apppython manage.py startapp main # ❌ Conflicts with Python modulespython manage.py startapp testpython manage.py startapp email # ❌ Using hyphenspython manage.py startapp my-app  # Use underscore: my_app # ❌ Starting with numberpython manage.py startapp 1stapp

Creating App in Specific Directory

# Tạo app trong thư mục apps/mkdir appspython manage.py startapp blog apps/blog # Structure:# apps/#   └── blog/#       ├── __init__.py#       ├── admin.py#       ... # Hoặc tạo sau đó movepython manage.py startapp blogmv blog apps/

Multiple Apps Example

# E-commerce project setupcd myshop/ # Tạo các appspython manage.py startapp productspython manage.py startapp cartpython manage.py startapp orderspython manage.py startapp customerspython manage.py startapp reviews # Structure:# myshop/#   ├── manage.py#   ├── myshop/          # Project config#   ├── products/        # Products app#   ├── cart/            # Shopping cart app#   ├── orders/          # Orders app#   ├── customers/       # Customers app#   └── reviews/         # Reviews app

Đăng Ký Apps trong INSTALLED_APPS

Why Register Apps?

Django cần biết apps nào được sử dụng để:

Load models vào database
Tìm templates
Collect static files
Run migrations
Enable admin interface

Registration Process

Step 1: Tạo app

python manage.py startapp blog

Step 2: Đăng ký trong settings.py

# mysite/settings.py INSTALLED_APPS = [    # Django built-in apps (đã có sẵn)    'django.contrib.admin',    'django.contrib.auth',    'django.contrib.contenttypes',    'django.contrib.sessions',    'django.contrib.messages',    'django.contrib.staticfiles',        # Your custom apps (thêm vào đây)    'blog',  # ← Đăng ký blog app]

Step 3: Verify registration

# Check if app is recognizedpython manage.py check # Output:# System check identified no issues (0 silenced).

Different Registration Formats

Format 1: App name (Simple)

INSTALLED_APPS = [    'blog',  # Shortest, most common]

Format 2: App config class (Recommended)

INSTALLED_APPS = [    'blog.apps.BlogConfig',  # Using AppConfig]

Format 3: Full path

INSTALLED_APPS = [    'apps.blog',  # If app is in apps/ directory    'apps.blog.apps.BlogConfig',  # With AppConfig]

AppConfig Class

Mỗi app có file apps.py với AppConfig:

# blog/apps.pyfrom django.apps import AppConfig class BlogConfig(AppConfig):    default_auto_field = 'django.db.models.BigAutoField'    name = 'blog'  # App name    verbose_name = 'Blog Application'  # Human-readable name        def ready(self):        """        Import signals, register tasks, etc.        Runs when Django starts        """        import blog.signals  # Register signals

Using custom AppConfig:

# blog/apps.pyclass BlogConfig(AppConfig):    name = 'blog'    verbose_name = 'Company Blog'        def ready(self):        # Custom initialization        print('Blog app is ready!')        import blog.signals # settings.pyINSTALLED_APPS = [    'blog.apps.BlogConfig',  # Use custom config]

Order Matters

Important: Order trong INSTALLED_APPS có thể quan trọng:

INSTALLED_APPS = [    # 1. Third-party apps that override Django    'django_extensions',        # 2. Django built-in apps    'django.contrib.admin',    'django.contrib.auth',        # 3. Other third-party apps    'rest_framework',    'django_filters',        # 4. Your apps    'blog',    'shop',]

Why order matters:

Template override (first match wins)
Static files override
Admin customization
Signal registration

Common Mistakes

# ❌ Quên đăng ký appINSTALLED_APPS = [    'django.contrib.admin',    # Missing 'blog',  ← Models won't work!] # ❌ Typo in app nameINSTALLED_APPS = [    'bllog',  # Should be 'blog'] # ❌ Wrong pathINSTALLED_APPS = [    'mysite.blog',  # Wrong if blog is at root level] # ✅ CorrectINSTALLED_APPS = [    'blog',    # or    'blog.apps.BlogConfig',]

App Structure

Standard App Structure

blog/                          # App root directory│├── __init__.py               # Empty: marks directory as Python package├── admin.py                  # Admin interface configuration├── apps.py                   # App configuration├── models.py                 # Database models├── views.py                  # View functions/classes├── urls.py                   # URL patterns (create manually)├── tests.py                  # Test cases│├── migrations/               # Database migrations│   ├── __init__.py│   └── 0001_initial.py      # First migration (auto-generated)│├── templates/               # HTML templates (create manually)│   └── blog/                # App-specific templates│       ├── post_list.html│       └── post_detail.html│├── static/                  # Static files (create manually)│   └── blog/                # App-specific static files│       ├── css/│       ├── js/│       └── images/│└── templatetags/            # Custom template tags (create manually)    ├── __init__.py    └── blog_tags.py

Core Files Explained

1. init.py

# blog/__init__.py # Usually empty, but can contain: # Set default app configdefault_app_config = 'blog.apps.BlogConfig' # Import for conveniencefrom .models import Postfrom .views import PostListView # Package metadata__version__ = '1.0.0'__author__ = 'Your Name'

2. models.py

# blog/models.pyfrom django.db import modelsfrom django.contrib.auth.models import User class Post(models.Model):    """Blog post model."""    title = models.CharField(max_length=200)    slug = models.SlugField(unique=True)    author = models.ForeignKey(User, on_delete=models.CASCADE)    content = models.TextField()    created = models.DateTimeField(auto_now_add=True)    updated = models.DateTimeField(auto_now=True)    published = models.BooleanField(default=False)        class Meta:        ordering = ['-created']        verbose_name = 'Blog Post'        verbose_name_plural = 'Blog Posts'        def __str__(self):        return self.title        def get_absolute_url(self):        from django.urls import reverse        return reverse('blog:post_detail', args=[self.slug]) class Comment(models.Model):    """Comment model."""    post = models.ForeignKey(Post, on_delete=models.CASCADE,                            related_name='comments')    author = models.CharField(max_length=100)    content = models.TextField()    created = models.DateTimeField(auto_now_add=True)        def __str__(self):        return f'Comment by {self.author} on {self.post}'

3. views.py

# blog/views.pyfrom django.shortcuts import render, get_object_or_404from django.views.generic import ListView, DetailViewfrom .models import Post # Function-based viewdef post_list(request):    """List all published posts."""    posts = Post.objects.filter(published=True)    context = {'posts': posts}    return render(request, 'blog/post_list.html', context) def post_detail(request, slug):    """Display single post."""    post = get_object_or_404(Post, slug=slug, published=True)    comments = post.comments.all()    context = {'post': post, 'comments': comments}    return render(request, 'blog/post_detail.html', context) # Class-based viewsclass PostListView(ListView):    """List view for posts."""    model = Post    template_name = 'blog/post_list.html'    context_object_name = 'posts'    paginate_by = 10        def get_queryset(self):        return Post.objects.filter(published=True) class PostDetailView(DetailView):    """Detail view for post."""    model = Post    template_name = 'blog/post_detail.html'    context_object_name = 'post'    slug_field = 'slug'

4. urls.py (Create Manually)

# blog/urls.pyfrom django.urls import pathfrom . import views app_name = 'blog'  # Namespace urlpatterns = [    path('', views.PostListView.as_view(), name='post_list'),    path('<slug:slug>/', views.PostDetailView.as_view(),          name='post_detail'),]

Connect to project URLs:

# mysite/urls.pyfrom django.contrib import adminfrom django.urls import path, include urlpatterns = [    path('admin/', admin.site.urls),    path('blog/', include('blog.urls')),  # Include blog URLs]

5. admin.py

# blog/admin.pyfrom django.contrib import adminfrom .models import Post, Comment @admin.register(Post)class PostAdmin(admin.ModelAdmin):    """Admin interface for Post model."""    list_display = ['title', 'author', 'published', 'created']    list_filter = ['published', 'created', 'author']    search_fields = ['title', 'content']    prepopulated_fields = {'slug': ('title',)}    date_hierarchy = 'created'    ordering = ['-created'] @admin.register(Comment)class CommentAdmin(admin.ModelAdmin):    """Admin interface for Comment model."""    list_display = ['author', 'post', 'created']    list_filter = ['created']    search_fields = ['author', 'content']

6. tests.py

# blog/tests.pyfrom django.test import TestCasefrom django.contrib.auth.models import Userfrom .models import Post class PostModelTest(TestCase):    """Test Post model."""        def setUp(self):        """Set up test data."""        self.user = User.objects.create_user(            username='testuser',            password='testpass123'        )        self.post = Post.objects.create(            title='Test Post',            slug='test-post',            author=self.user,            content='Test content',            published=True        )        def test_post_creation(self):        """Test post is created correctly."""        self.assertEqual(self.post.title, 'Test Post')        self.assertEqual(str(self.post), 'Test Post')        def test_get_absolute_url(self):        """Test post URL."""        url = self.post.get_absolute_url()        self.assertEqual(url, '/blog/test-post/')

Extended App Structure (Advanced)

blog/├── __init__.py├── admin.py├── apps.py├── models.py├── views.py├── urls.py├── forms.py                 # Django forms├── serializers.py           # DRF serializers├── filters.py               # django-filter├── signals.py               # Django signals├── tasks.py                 # Celery tasks├── utils.py                 # Utility functions├── constants.py             # Constants├── exceptions.py            # Custom exceptions│├── management/              # Custom management commands│   ├── __init__.py│   └── commands/│       ├── __init__.py│       └── import_posts.py│├── migrations/│   ├── __init__.py│   └── 0001_initial.py│├── templates/│   └── blog/│       ├── base.html│       ├── post_list.html│       ├── post_detail.html│       └── includes/│           └── post_card.html│├── static/│   └── blog/│       ├── css/│       │   └── style.css│       ├── js/│       │   └── main.js│       └── images/│├── templatetags/│   ├── __init__.py│   └── blog_tags.py│└── tests/                   # Test package    ├── __init__.py    ├── test_models.py    ├── test_views.py    ├── test_forms.py    └── test_api.py

Bài Tập

Bài 1: Tạo Blog App

Tasks:

Tạo Django project mới tên "myblog"
Tạo app "posts"
Đăng ký app trong INSTALLED_APPS
Verify với python manage.py check

Expected Structure:

myblog/├── manage.py├── myblog/│   ├── settings.py  # INSTALLED_APPS += ['posts']│   └── ...└── posts/    ├── __init__.py    ├── models.py    └── ...

Bài 2: Multiple Apps

Task: Tạo e-commerce project với các apps:

products (sản phẩm)
cart (giỏ hàng)
orders (đơn hàng)

Requirements:

# settings.pyINSTALLED_APPS = [    'django.contrib.admin',    # ... other Django apps    'products',    'cart',    'orders',]

Bài 3: App Structure

Tasks:

Trong app "posts", tạo thêm:
- templates/posts/
- static/posts/
- urls.py
List tất cả files và explain công dụng

Bài 4: Models và Admin

Task: Tạo model Post với fields:

title (CharField)
content (TextField)
created_at (DateTimeField)

Đăng ký trong admin.py

# posts/models.pyfrom django.db import models class Post(models.Model):    title = models.CharField(max_length=200)    content = models.TextField()    created_at = models.DateTimeField(auto_now_add=True)        def __str__(self):        return self.title # posts/admin.pyfrom django.contrib import adminfrom .models import Post admin.site.register(Post)

Run migrations và test trong admin!

Tài Liệu Tham Khảo

Previous: Bài 02: Django Installation và Setup | Next: Bài 03 Part 2: Reusable Apps

#project-structure

Django Apps