Simple-Todo 是跨框架教學專案 (web.py/Uliweb/Bottle/Flask/Django),實作基本待辦事項 CRUD。本文記錄 Django 版本完整建立過程。
django-admin startproject simple_todo_site
cd simple_todo_site
python manage.py startapp simpletodo
# simple_todo_site/settings.py
import os
from pathlib import Path
BASE_DIR = Path(__file__).resolve().parent.parent
SECRET_KEY = 'dev-secret-key-change-in-production'
DEBUG = True
ALLOWED_HOSTS = ['*']
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'simpletodo', # 關鍵:註冊 app
]
MIDDLEWARE = [
'django.middleware.security.SecurityMiddleware',
'django.contrib.sessions.middleware.SessionMiddleware',
'django.middleware.common.CommonMiddleware',
'django.middleware.csrf.CsrfViewMiddleware',
'django.contrib.auth.middleware.AuthenticationMiddleware',
'django.contrib.messages.middleware.MessageMiddleware',
'django.middleware.clickjacking.XFrameOptionsMiddleware',
]
ROOT_URLCONF = 'simple_todo_site.urls'
TEMPLATES = [{
'BACKEND': 'django.template.backends.django.DjangoTemplates',
'DIRS': [BASE_DIR / 'templates'], # 專案級模板目錄
'APP_DIRS': True,
'OPTIONS': {
'context_processors': [
'django.template.context_processors.debug',
'django.template.context_processors.request',
'django.contrib.auth.context_processors.auth',
'django.contrib.messages.context_processors.messages',
],
},
}]
# 資料庫 (開發用 SQLite)
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.sqlite3',
'NAME': BASE_DIR / 'db.sqlite3',
}
}
# 靜態檔案
STATIC_URL = '/static/'
STATICFILES_DIRS = [BASE_DIR / 'static']
STATIC_ROOT = BASE_DIR / 'staticfiles'
# 媒體檔案
MEDIA_URL = '/media/'
MEDIA_ROOT = BASE_DIR / 'media'
from django.db import models
from django.contrib import admin
class Todo(models.Model):
title = models.CharField('標題', max_length=255)
finished = models.BooleanField('完成', default=False)
created_at = models.DateTimeField('建立時間', auto_now_add=True)
updated_at = models.DateTimeField('更新時間', auto_now=True)
class Meta:
ordering = ['-created_at']
verbose_name = '待辦事項'
verbose_name_plural = '待辦事項'
def __str__(self):
return self.title
# Admin 註冊
@admin.register(Todo)
class TodoAdmin(admin.ModelAdmin):
list_display = ('title', 'finished', 'created_at')
list_filter = ('finished', 'created_at')
search_fields = ('title',)
list_editable = ('finished',)
python manage.py makemigrations
python manage.py migrate
python manage.py runserver
# 瀏覽器開啟 https://127.0.0.1:8000/
# Admin: https://127.0.0.1:8000/admin/
from django.shortcuts import render, redirect, get_object_or_404
from django.views.decorators.http import require_http_methods
from .models import Todo
def todo_list(request):
todos = Todo.objects.all()
return render(request, 'simpletodo/list.html', {'todos': todos})
@require_http_methods(["POST"])
def todo_add(request):
title = request.POST.get('title', '').strip()
if title:
Todo.objects.create(title=title)
return redirect('todo_list')
@require_http_methods(["POST"])
def todo_toggle(request, pk):
todo = get_object_or_404(Todo, pk=pk)
todo.finished = not todo.finished
todo.save()
return redirect('todo_list')
@require_http_methods(["POST"])
def todo_delete(request, pk):
todo = get_object_or_404(Todo, pk=pk)
todo.delete()
return redirect('todo_list')
{% load static %}
Simple Todo
📝 Simple Todo
{% for todo in todos %}
-
{{ todo.title }}
{{ todo.created_at|date:"M d, H:i" }}
{% empty %}
- 暫無待辦事項
{% endfor %}
# simple_todo_site/urls.py
from django.contrib import admin
from django.urls import path
from simpletodo import views
urlpatterns = [
path('admin/', admin.site.urls),
path('', views.todo_list, name='todo_list'),
path('add/', views.todo_add, name='todo_add'),
path('toggle//', views.todo_toggle, name='todo_toggle'),
path('delete//', views.todo_delete, name='todo_delete'),
]
# 收集靜態檔案
python manage.py collectstatic
# 建立超級使用者
python manage.py createsuperuser
# 生產環境建議
# - 使用 PostgreSQL
# - 設定 DEBUG=False, ALLOWED_HOSTS
# - 使用 Gunicorn + Nginx
# - 配置 HTTPS、靜態檔案 CDN
@login_required 裝飾器,每用戶獨立待辦python manage.py test simpletodo完成此專案可掌握 Django MVT 架構、ORM、Admin、模板、表單、靜態檔案等核心開發流程。