@su-record/vibe 2.4.72 → 2.4.74

package/languages/python-django.md

@@ -1,30 +1,31 @@
-# 🐍 Python + Django 품질 규칙
+# Python + Django Quality Rules
 
-## 핵심 원칙 (core에서 상속)
+## Core Principles (inherited from core)
 
 ```markdown
-✅ 단일 책임 (SRP)
-✅ 중복 제거 (DRY)
-✅ 재사용성
-✅ 낮은 복잡도
-✅ 함수 ≤ 30줄
-✅ 중첩 ≤ 3단계
-✅ Cyclomatic complexity ≤ 10
+# Core Principles (inherited from core)
+Single Responsibility (SRP)
+No Duplication (DRY)
+Reusability
+Low Complexity
+Function <= 30 lines
+Nesting <= 3 levels
+Cyclomatic complexity <= 10
 ```
 
-## Django 특화 규칙
+## Django Specific Rules
 
-### 1. Model 설계
+### 1. Model Design
 
 ```python
-# ✅ models.py
+# Good: models.py
 from django.db import models
 from django.contrib.auth.models import AbstractUser
 from django.utils import timezone
 
 
 class BaseModel(models.Model):
-    """공통 필드를 가진 추상 모델"""
+    """Abstract model with common fields"""
     created_at = models.DateTimeField(auto_now_add=True)
     updated_at = models.DateTimeField(auto_now=True)
 
@@ -33,7 +34,7 @@ class BaseModel(models.Model):
 
 
 class User(AbstractUser):
-    """커스텀 사용자 모델"""
+    """Custom user model"""
     email = models.EmailField(unique=True)
     phone = models.CharField(max_length=20, blank=True)
     profile_image = models.ImageField(upload_to='profiles/', blank=True)
@@ -43,46 +44,46 @@ class User(AbstractUser):
 
     class Meta:
         db_table = 'users'
-        verbose_name = '사용자'
-        verbose_name_plural = '사용자들'
+        verbose_name = 'User'
+        verbose_name_plural = 'Users'
 
     def __str__(self):
         return self.email
 
 
 class Post(BaseModel):
-    """게시글 모델"""
+    """Post model"""
     author = models.ForeignKey(
         User,
         on_delete=models.CASCADE,
         related_name='posts',
-        verbose_name='작성자'
+        verbose_name='Author'
     )
-    title = models.CharField(max_length=200, verbose_name='제목')
-    content = models.TextField(verbose_name='내용')
-    is_published = models.BooleanField(default=False, verbose_name='게시 여부')
+    title = models.CharField(max_length=200, verbose_name='Title')
+    content = models.TextField(verbose_name='Content')
+    is_published = models.BooleanField(default=False, verbose_name='Published')
     published_at = models.DateTimeField(null=True, blank=True)
 
     class Meta:
         db_table = 'posts'
         ordering = ['-created_at']
-        verbose_name = '게시글'
-        verbose_name_plural = '게시글들'
+        verbose_name = 'Post'
+        verbose_name_plural = 'Posts'
 
     def __str__(self):
         return self.title
 
     def publish(self):
-        """게시글 발행"""
+        """Publish the post"""
         self.is_published = True
         self.published_at = timezone.now()
         self.save(update_fields=['is_published', 'published_at'])
 ```
 
-### 2. View (Class-Based Views 권장)
+### 2. View (Class-Based Views Recommended)
 
 ```python
-# ✅ views.py
+# Good: views.py
 from django.views.generic import ListView, DetailView, CreateView, UpdateView
 from django.contrib.auth.mixins import LoginRequiredMixin
 from django.urls import reverse_lazy
@@ -91,7 +92,7 @@ from .forms import PostForm
 
 
 class PostListView(ListView):
-    """게시글 목록 뷰"""
+    """Post list view"""
     model = Post
     template_name = 'posts/list.html'
     context_object_name = 'posts'
@@ -103,7 +104,7 @@ class PostListView(ListView):
 
 
 class PostDetailView(DetailView):
-    """게시글 상세 뷰"""
+    """Post detail view"""
     model = Post
     template_name = 'posts/detail.html'
     context_object_name = 'post'
@@ -113,7 +114,7 @@ class PostDetailView(DetailView):
 
 
 class PostCreateView(LoginRequiredMixin, CreateView):
-    """게시글 생성 뷰"""
+    """Post creation view"""
     model = Post
     form_class = PostForm
     template_name = 'posts/form.html'
@@ -127,13 +128,13 @@ class PostCreateView(LoginRequiredMixin, CreateView):
 ### 3. Django REST Framework
 
 ```python
-# ✅ serializers.py
+# Good: serializers.py
 from rest_framework import serializers
 from .models import Post, User
 
 
 class UserSerializer(serializers.ModelSerializer):
-    """사용자 시리얼라이저"""
+    """User serializer"""
     class Meta:
         model = User
         fields = ['id', 'email', 'username', 'profile_image']
@@ -141,7 +142,7 @@ class UserSerializer(serializers.ModelSerializer):
 
 
 class PostSerializer(serializers.ModelSerializer):
-    """게시글 시리얼라이저"""
+    """Post serializer"""
     author = UserSerializer(read_only=True)
     author_id = serializers.PrimaryKeyRelatedField(
         queryset=User.objects.all(),
@@ -159,11 +160,11 @@ class PostSerializer(serializers.ModelSerializer):
 
     def validate_title(self, value):
         if len(value) < 5:
-            raise serializers.ValidationError('제목은 5자 이상이어야 합니다')
+            raise serializers.ValidationError('Title must be at least 5 characters')
         return value
 
 
-# ✅ views.py (DRF)
+# Good: views.py (DRF)
 from rest_framework import viewsets, permissions, status
 from rest_framework.decorators import action
 from rest_framework.response import Response
@@ -171,7 +172,7 @@ from django_filters.rest_framework import DjangoFilterBackend
 
 
 class PostViewSet(viewsets.ModelViewSet):
-    """게시글 ViewSet"""
+    """Post ViewSet"""
     queryset = Post.objects.all()
     serializer_class = PostSerializer
     permission_classes = [permissions.IsAuthenticatedOrReadOnly]
@@ -187,34 +188,34 @@ class PostViewSet(viewsets.ModelViewSet):
 
     @action(detail=True, methods=['post'])
     def publish(self, request, pk=None):
-        """게시글 발행 액션"""
+        """Publish post action"""
         post = self.get_object()
 
         if post.author != request.user:
             return Response(
-                {'error': '작성자만 발행할 수 있습니다'},
+                {'error': 'Only the author can publish'},
                 status=status.HTTP_403_FORBIDDEN
             )
 
         post.publish()
-        return Response({'status': '발행되었습니다'})
+        return Response({'status': 'Published'})
 ```
 
-### 4. Service 레이어 (Fat Model 방지)
+### 4. Service Layer (Prevent Fat Model)
 
 ```python
-# ✅ services/post_service.py
+# Good: services/post_service.py
 from django.db import transaction
 from django.core.exceptions import PermissionDenied
 from ..models import Post, User
 
 
 class PostService:
-    """게시글 관련 비즈니스 로직"""
+    """Post business logic"""
 
     @staticmethod
     def create_post(author: User, title: str, content: str) -> Post:
-        """게시글 생성"""
+        """Create post"""
         post = Post.objects.create(
             author=author,
             title=title,
@@ -224,9 +225,9 @@ class PostService:
 
     @staticmethod
     def publish_post(post: Post, user: User) -> Post:
-        """게시글 발행"""
+        """Publish post"""
         if post.author != user:
-            raise PermissionDenied('작성자만 발행할 수 있습니다')
+            raise PermissionDenied('Only the author can publish')
 
         post.publish()
         return post
@@ -234,7 +235,7 @@ class PostService:
     @staticmethod
     @transaction.atomic
     def bulk_publish(post_ids: list[int], user: User) -> int:
-        """여러 게시글 일괄 발행"""
+        """Bulk publish multiple posts"""
         posts = Post.objects.filter(
             id__in=post_ids,
             author=user,
@@ -248,24 +249,24 @@ class PostService:
         return count
 ```
 
-### 5. Form 및 Validation
+### 5. Form and Validation
 
 ```python
-# ✅ forms.py
+# Good: forms.py
 from django import forms
 from django.core.exceptions import ValidationError
 from .models import Post
 
 
 class PostForm(forms.ModelForm):
-    """게시글 폼"""
+    """Post form"""
     class Meta:
         model = Post
         fields = ['title', 'content', 'is_published']
         widgets = {
             'title': forms.TextInput(attrs={
                 'class': 'form-control',
-                'placeholder': '제목을 입력하세요'
+                'placeholder': 'Enter title'
             }),
             'content': forms.Textarea(attrs={
                 'class': 'form-control',
@@ -276,7 +277,7 @@ class PostForm(forms.ModelForm):
     def clean_title(self):
         title = self.cleaned_data.get('title')
         if len(title) < 5:
-            raise ValidationError('제목은 5자 이상이어야 합니다')
+            raise ValidationError('Title must be at least 5 characters')
         return title
 
     def clean(self):
@@ -285,20 +286,20 @@ class PostForm(forms.ModelForm):
         content = cleaned_data.get('content')
 
         if title and content and title in content:
-            raise ValidationError('본문에 제목이 포함되면 안 됩니다')
+            raise ValidationError('Content should not contain the title')
 
         return cleaned_data
 ```
 
-### 6. Custom Manager와 QuerySet
+### 6. Custom Manager and QuerySet
 
 ```python
-# ✅ managers.py
+# Good: managers.py
 from django.db import models
 
 
 class PostQuerySet(models.QuerySet):
-    """게시글 QuerySet"""
+    """Post QuerySet"""
 
     def published(self):
         return self.filter(is_published=True)
@@ -314,7 +315,7 @@ class PostQuerySet(models.QuerySet):
 
 
 class PostManager(models.Manager):
-    """게시글 Manager"""
+    """Post Manager"""
 
     def get_queryset(self):
         return PostQuerySet(self.model, using=self._db)
@@ -326,46 +327,46 @@ class PostManager(models.Manager):
         return self.get_queryset().by_author(user)
 
 
-# 모델에서 사용
+# Use in model
 class Post(BaseModel):
     # ... fields ...
     objects = PostManager()
 ```
 
-## 파일 구조
+## File Structure
 
-```
+```text
 app_name/
-├── migrations/          # DB 마이그레이션
+├── migrations/          # DB migrations
 ├── management/
-│   └── commands/        # 커스텀 명령어
-├── services/            # 비즈니스 로직
+│   └── commands/        # Custom commands
+├── services/            # Business logic
 ├── api/
-│   ├── serializers.py   # DRF 시리얼라이저
-│   ├── views.py         # DRF 뷰
-│   └── urls.py          # API 라우팅
-├── templates/           # HTML 템플릿
-├── static/              # 정적 파일
+│   ├── serializers.py   # DRF serializers
+│   ├── views.py         # DRF views
+│   └── urls.py          # API routing
+├── templates/           # HTML templates
+├── static/              # Static files
 ├── tests/
 │   ├── test_models.py
 │   ├── test_views.py
 │   └── test_services.py
-├── models.py            # 모델 (또는 models/ 디렉토리)
-├── views.py             # 뷰
-├── forms.py             # 폼
-├── managers.py          # 커스텀 매니저
-├── admin.py             # Admin 설정
-├── urls.py              # URL 라우팅
-└── apps.py              # 앱 설정
+├── models.py            # Models (or models/ directory)
+├── views.py             # Views
+├── forms.py             # Forms
+├── managers.py          # Custom managers
+├── admin.py             # Admin configuration
+├── urls.py              # URL routing
+└── apps.py              # App configuration
 ```
 
-## 체크리스트
+## Checklist
 
-- [ ] Model에 `__str__`, `Meta` 정의
-- [ ] CBV 사용 (권장)
-- [ ] Service 레이어로 비즈니스 로직 분리
-- [ ] select_related/prefetch_related로 N+1 방지
-- [ ] DRF Serializer로 입출력 검증
-- [ ] Custom Manager/QuerySet 활용
-- [ ] Type hints 사용 (Python 3.10+)
-- [ ] 한글 verbose_name 설정
+- [ ] Define `__str__`, `Meta` in Model
+- [ ] Use CBV (recommended)
+- [ ] Separate business logic with Service layer
+- [ ] Prevent N+1 with select_related/prefetch_related
+- [ ] Validate input/output with DRF Serializer
+- [ ] Use Custom Manager/QuerySet
+- [ ] Use Type hints (Python 3.10+)
+- [ ] Set verbose_name for fields