Try To do

error : no matches found: psycopg[binary]

잼이써요 — Sat, 17 Jan 2026 17:31:22 +0900

no matches found: psycopg[binary]

증상

uv add psycopg[binary]

command result : no matches found: psycopg[binary]

원인

psyconpg 로 시작하고 b,i,n,a,r,y 중 한 글자가 들어가는 파일을 찾으려고 시도 결과 오류 발생(당연)

해결 방법

uv add "psycopg[binary]"

console 환경에서 git 병합 후 push

잼이써요 — Sun, 11 Jan 2026 20:38:07 +0900

# 1. 로컬의 main 브랜치로 체크아웃
git checkout main

# 2. (필요시) 서버의 최신 main 내용을 가져옴
git pull origin main

# 3. dev 브랜치의 변경사항을 main에 병합 (Merge)
git merge dev

# 4. 병합된 main 브랜치를 GitHub 서버로 푸시
git push origin main

VS Code에서 ollama list 를 인식하지 못할 때

잼이써요 — Sat, 3 Jan 2026 14:55:02 +0900

(venv) PS C:\Project\sample> ollama list

ollama: The term 'ollama' is not recognized as a name of a cmdlet, function, script file, or executable program.

Check the spelling of the name, or if a path was included, verify that the path is correct and try again.

VS Code에서 ollama 설치 및 연결을 확인하기 위해 입력해본 ollama list 명령어가 정상적으로수행되지 않을 경우

환경변수를 체크해야 한다.

윈도우 검색창에 시스템 환경 변수 편집 검색 시 나오는 시스템 환경 변수 편집(제어판) 을 선택
시스템 속성 화면 하단에 환경 변수 선택
사용자 계정에 대한 사용자 변수 의 Path 선택 ( 없을 경우 새로 만들기)
1. 새로 만들기 :
  1. 변수 이름 : Path 입력
  2. 디렉터리 찾아보기로 이동
    > 위치 :C:\Users\사용자계정\AppData\Local\Programs\Ollama
2. 기존 수정 :
  1. Ollama 가 없다면 새로 만들기
    1. C:\Users\사용자계정\AppData\Local\Programs\Ollama 입력
  2. Ollama 가 있다면 위치 확인
    1. Ollama 위치가 VS Code 보다 위에 있는지 확인
      -> 저는 VS Code path 보다 아래 있었음.
    2. Ollama위치를 위로 이동 (VS Code 위로)
확인 후 VS Code 완전 종료 후 다시 실행

이제 ollama list 가 정상적으로 보일 것입니다.

Ollama Model 저장 경로 설정 방법

잼이써요 — Sat, 3 Jan 2026 14:12:32 +0900

AI를 이용해 Ollama 를 설치 진행 중이었다.

AI : Model 을 잘 관리하기 위해 별도 폴더 관리로 진행하는게 좋습니다.D:OllamaModels 폴더를 만드세요.

나 : 응 만들께 ( D:OllamaModels )

AI : 환경변수를 등록해 Ollama가 Models 위치를 확인하도록 설정합니다. ~ 환경변수 등록방법 ~

나 : 응 설정할께 (~ 환경변수 등록 방법 ~)

AI: 자 이제 모델을 실행하며 설정된 D:OllamaModels에 새로운 폴더가 생성되는 것을 확인합니다.

나 : 응 해볼께..

설정된 폴더 : 응 없어~

Windows 에 설치된 ollama 는 settings 에 Model 경로를 설정할 수 있다.

환경변수 이런거 하지말고 ollama 실행 후 settings 들어가서 Model 경로를 설정하자.

Django 마이그레이션 불일치 (Migration Mismatch) 에러 관련

잼이써요 — Wed, 31 Dec 2025 21:15:42 +0900

models.py를 작성 후 1차 마이그레이션을 진행한 뒤 테이블 명중 1글자를 소문자에서 대문자로 변경할 일이 생겼다.

변경 후 하던대로 진행했을 뿐인데.

python manage.py makemigrations appname
python manage.py migrate
python manage.py runserver

NO SUCH TABLE '내가 만든 테이블명' 에러가 발생.

이것, 저것 해보다가 최종 해결 방법은 간단했지만, 중간 과정이 고생스러워서 기록한다.

1. 발생 원인

Django 마이그레이션 시스템에서 발생하는 OperationalError는 **애플리케이션의 마이그레이션 상태(State)**와 실제 데이터베이스 스키마(Schema) 간의 **동기화 실패(Desynchronization)**로 인해 발생.

Django는 데이터베이스의 형상 관리를 위해 다음 세 가지 요소를 유기적으로 일치시키는데, 이 중 하나라도 어긋나면 에러가 발생.

마이그레이션 파일 (Migration Files): 개발자가 작성한 모델 변경 사항을 코드로 정의한 명세서 (/migrations/*.py).
마이그레이션 기록 (Migration History): 데이터베이스 내 django_migrations 테이블에 저장된 적용 내역. (Django가 인지하는 현재 상태)
데이터베이스 스키마 (Database Schema): 실제 DBMS(SQLite, PostgreSQL 등)에 생성된 물리적인 테이블과 컬럼 구조.

2. 주요 에러 유형 및 발생 메커니즘

Case A. OperationalError: no such table

마이그레이션 기록상으로는 '적용 완료' 상태이나, 실제 물리 테이블이 존재하지 않는 경우.

상태 분석:
- Migration History: 해당 마이그레이션 파일이 적용(Applied)되었다고 기록됨.
- Actual Schema: 해당 테이블이 삭제되었거나 생성되지 않음.
발생 원인:
- 데이터베이스에 직접 접속(Shell, DB Tool 등)하여 SQL DROP TABLE 명령어로 테이블을 임의 삭제한 경우.
- migrate --fake 옵션을 사용하여 실제 테이블 생성 과정을 건너뛰고 기록만 남겼으나, 실제로는 테이블이 없었던 경우.

Case B. OperationalError: table "..." already exists

마이그레이션 기록상으로는 '미적용' 상태라 새로 생성을 시도했으나, 실제 물리 테이블이 이미 존재하는 경우입니다.

상태 분석:
- Migration History: 해당 마이그레이션 기록이 없거나 초기화됨 (Not Applied).
- Actual Schema: 과거에 생성된 테이블이 그대로 남아있음 (Zombie Table).
발생 원인:
- 가장 흔한 원인: 프로젝트 내 migrations 폴더의 파일들을 삭제(초기화)했으나, DB에 남아있는 실제 테이블을 삭제하지 않은 상태에서 다시 makemigrations 후 migrate를 시도할 때 발생.
- migrate --fake <app> zero 명령어로 기록(History)만 지우고, 실제 테이블(Schema)을 정리하지 않은 경우.

3. 근본적인 해결 전략: 동기화(Synchronization) 복구

세 가지 요소(파일, 기록, 스키마)의 상태를 다시 일치시키는 과정.

초기화 (Reset): 꼬여버린 마이그레이션 파일과 django_migrations 기록을 제거하여 상태를 '0(Zero)'로 초기화(__init__만 남기고 migrations 폴더 내 다른 파일 삭제).
잔재 제거 (Clean Up): 충돌을 유발하는 실제 DB 테이블을 DROP 하여 스키마 상태를 '0'으로 만듭니다.
재동기화 (Resync): 깨끗해진 상태에서 다시 설계도(Migration File)를 만들고, 이를 실행(Migrate)하여 기록과 스키마를 동시에 생성합니다.

나는 파이썬 기본 제공인 sqlite3 을 사용해 개발테스트 중이었기 때문에 철거 코드를 입력하여 처리했다.

1. shell 진입

python manage.py shell

2. 철거코드 입력

from django.db import connection

# 커서를 통해 직접 SQL 명령을 날려서 테이블을 날려버립니다.
with connection.cursor() as cursor:
    # 혹시 있을지 모르는 3가지 테이블을 모두 삭제 시도합니다.
    cursor.execute("DROP TABLE IF EXISTS gateways_gatewayconfig")
    cursor.execute("DROP TABLE IF EXISTS gateways_provider")
    cursor.execute("DROP TABLE IF EXISTS gateways_servicetype")

print("✅ 꼬인 테이블 삭제 완료! exit()를 입력해 나가세요.")

3. 나가기

exit()

pip install 을 사용해 설치했는데 인식하지 못할 때.

잼이써요 — Tue, 23 Dec 2025 23:25:24 +0900

Django 프로젝트를 진행하는 중에 pip install Pillow 로 프로그램 설치를 진행 후 마이그레이션을 진행하는데

[bash]

pip install Pillow
python manage.py makemigration appname

아래와 같은 오류가 발생했다.

SystemCheckError: System check identified some issues:

ERRORS:

posts.Post.thumbnail: (fields.E210) Cannot use ImageField because Pillow is not installed.

HINT: Get Pillow at https://pypi.org/project/Pillow/ or run command "python -m pip install Pillow".

pip 업그레이드 및 재 설치하여 해결했다.

# 1. pip 자체를 최신버전으로 업데이트
python -m pip install --upgrade pip

# 2. 혹시 모르니 Pillow 삭제
pip uninstall Pillow -y

# 3. 캐시 없이 다시 깨끗하게 설치
pip install Pillow --no-cache-dir

(한줄씩 명령어를 실행했다)

나는 Pillow 를 설치하면서 문제가 생겼기 때문에 Pillow 설치 확인 명령어로 확인했다.

python -c "import PIL; print('Pillow 설치 완료:', PIL.__version__)"

(정상 설치 확인)

Bonus Book 2. Django Admin 커스터마이징

잼이써요 — Tue, 9 Dec 2025 20:40:06 +0900

지금 관리자 페이지(/admin)에 들어가 보면 게시글 목록이 단순히 Post object (1), Post object (2) 처럼 나오거나, 검색 기능이 없어서 관리가 불편할 겁니다. 이곳을 엑셀처럼 보기 편하고, 검색도 되는 강력한 관리 도구로 바꿔봅시다

[Bonus Book 2] Django Admin 커스터마이징

boards/admin.py 파일을 열고 아래 코드로 내용을 채워주세요.

(기존에 있던 admin.site.register(Board) 등의 코드는 지우고 이 코드로 덮어쓰시면 됩니다.)

1. 코드 작성 (boards/admin.py)

from django.contrib import admin
from .models import Board, Post, Comment

# 1. 게시판(Board) 관리
@admin.register(Board)
class BoardAdmin(admin.ModelAdmin):
    list_display = ('code', 'title', 'description') # 목록에 보여줄 컬럼
    list_display_links = ('code', 'title')          # 클릭해서 수정할 수 있는 컬럼

# 2. 게시글(Post) 관리 - 여기가 제일 중요!
@admin.register(Post)
class PostAdmin(admin.ModelAdmin):
    # 목록에 보일 항목들 (제목, 작성자, 게시판, 조회수, 작성일)
    list_display = ('title', 'author', 'board', 'views', 'created_at')
    
    # 우측 필터 사이드바 (게시판별, 작성일별 필터링)
    list_filter = ('board', 'created_at')
    
    # 상단 검색창 (제목, 내용, 작성자 닉네임으로 검색)
    # author__nickname: author(User) 모델의 nickname 필드를 검색하겠다는 뜻
    search_fields = ('title', 'content', 'author__nickname', 'author__username')
    
    # 날짜 계층 구조 (상단에 연도-월-일 네비게이션 생김)
    date_hierarchy = 'created_at'
    
    # 페이지당 보여줄 개수
    list_per_page = 20

# 3. 댓글(Comment) 관리
@admin.register(Comment)
class CommentAdmin(admin.ModelAdmin):
    list_display = ('content_summary', 'post', 'author', 'created_at')
    search_fields = ('content', 'author__username')
    
    # 댓글 내용이 길 수 있으니 앞부분만 잘라서 보여주는 함수
    def content_summary(self, obj):
        return obj.content[:20] + "..." if len(obj.content) > 20 else obj.content
    content_summary.short_description = "댓글 내용"

2. 확인해 보기

서버가 켜져 있는지 확인하고, 브라우저에서 /admin 페이지를 새로고침합니다.
Boards 앱 밑에 Posts를 클릭해 보세요.
- 이제 제목, 작성자, 조회수가 표처럼 깔끔하게 나오나요?
- 오른쪽에 Filter 사이드바가 생겼나요?
- 맨 위에 **검색창(Search)**이 생겼나요?
검색창에 테스트로 작성했던 글의 제목이나 작성자를 검색해 보세요.

Bonus Book 1. 게시판 관리자(Staff) 권한 부여

잼이써요 — Tue, 9 Dec 2025 20:37:35 +0900

[Bonus Book 1] 게시판 관리자(Staff) 권한 부여

슈퍼유저(Superuser)는 너무 강력한 권한(모든 것 가능)을 가지므로, 평소에는 "게시판 관리자(Board Manager)" 권한만 가진 계정으로 활동하는 것이 보안상 안전합니다.

1. 모델 확인 (accounts/models.py)

우리가 Phase 1에서 User 모델을 만들 때, 미리 is_board_manager 라는 필드를 만들어 둔 것을 기억하시나요? 드디어 이것을 써먹을 때입니다.

혹시 기억이 안 나실까 봐 코드를 다시 확인해 봅니다. (수정할 필요는 없습니다. 눈으로만 확인하세요.)

# accounts/models.py
class User(AbstractUser):
    # 이 필드를 활용합니다!
    is_board_manager = models.BooleanField(default=False, verbose_name="게시판 관리자 여부")
    # ...

2.관리자 화면에 커스텀 필드 추가하기

accounts/admin.py 파일을 열고 아래 코드로 전체 내용을 교체해 주세요.

from django.contrib import admin
from django.contrib.auth.admin import UserAdmin
from .models import User

class CustomUserAdmin(UserAdmin):
    # [1] 목록 화면에서 보이는 컬럼 설정
    # (기본) 아이디, 이메일, 이름, 스태프여부 + (추가) 닉네임, 게시판관리자여부
    list_display = ('username', 'nickname', 'email', 'is_board_manager', 'is_staff', 'is_superuser')
    
    # [2] 수정 화면(상세)에서 보이는 필드 설정 (fieldsets)
    # 기존 UserAdmin의 설정 뒤에 '추가 정보' 섹션을 붙입니다.
    fieldsets = UserAdmin.fieldsets + (
        ('추가 정보', {'fields': ('nickname', 'avatar', 'is_board_manager')}),
    )

# User 모델을 우리가 만든 CustomUserAdmin 설정으로 등록
admin.site.register(User, CustomUserAdmin)

3. 권한 체크 로직 수정 (boards/views.py)

기존의 삭제 로직은 "작성자가 아니면 튕겨내라!" 였습니다.

이것을 "작성자가 아니고, 관리자도 아니면 튕겨내라!" 로 바꿔야 합니다.

boards/views.py에서 board_delete(게시글 삭제)와 comment_delete(댓글 삭제) 함수를 찾아 수정합니다.

1) 게시글 삭제 (board_delete) 수정

@login_required
def board_delete(request, board_code, pk):
    board = get_object_or_404(Board, code=board_code)
    post = get_object_or_404(Post, pk=pk, board=board)
    
    # [수정] 작성자 본인이거나, '게시판 관리자' 권한이 있는 경우 삭제 허용
    if request.user == post.author or request.user.is_board_manager or request.user.is_superuser:
        post.delete()
        return redirect('boards:board_list', board_code=board_code)
    else:
        # 권한 없는 사람이 시도하면 에러 페이지(403)를 띄우거나 뒤로 보냄
        # 여기서는 간단하게 상세 페이지로 돌려보냄
        return redirect('boards:board_detail', board_code=board_code, pk=pk)

2) 댓글 삭제 (comment_delete) 수정

@login_required
def comment_delete(request, board_code, pk, comment_pk):
    post = get_object_or_404(Post, board__code=board_code, pk=pk)
    comment = get_object_or_404(Comment, pk=comment_pk, post=post)

    # [수정] 작성자 본인 or 관리자 or 슈퍼유저 허용
    if request.user == comment.author or request.user.is_board_manager or request.user.is_superuser:
        comment.delete()
    
    return redirect('boards:board_detail', board_code=board_code, pk=pk)

4. 화면 수정 (boards/templates/boards/board_detail.html)

삭제 버튼도 마찬가지입니다. 지금은 "내 글"일 때만 삭제 버튼이 보입니다.

"내가 쓴 글이 아니더라도, 내가 관리자라면 삭제 버튼이 보여야" 합니다.

board_detail.html에서 게시글 삭제 버튼과 댓글 삭제 버튼의 if 조건을 수정하세요.

1) 게시글 삭제 버튼 부분

{% if post.author == user or user.is_board_manager or user.is_superuser %}
    <a href="{% url 'boards:board_edit' board.code post.pk %}" class="btn btn-secondary">수정</a>
    <a href="{% url 'boards:board_delete' board.code post.pk %}" class="btn btn-danger" onclick="return confirm('정말 삭제하시겠습니까?');">삭제</a>
{% endif %}

2) 댓글 삭제 버튼 부분 (반복문 안쪽)

{% if comment.author == user or user.is_board_manager or user.is_superuser %}
    <a href="{% url 'boards:comment_delete' board.code post.pk comment.pk %}" 
       class="text-danger small text-decoration-none ms-2"
       onclick="return confirm('댓글을 삭제하시겠습니까?')">삭제</a>
{% endif %}

5. 테스트 (관리자 권한 부여)

이제 일반 유저 계정 하나를 "게시판 매니저"로 승진시켜서 테스트해 봅시다.

슈퍼유저 로그인: /admin 페이지로 접속해서 로그인합니다.
유저 수정: Users 메뉴에서 테스트용 아이디(예: testuser)를 클릭합니다.
권한 부여: 스크롤을 내려서 게시판 관리자 여부 (is_board_manager) 체크박스에 체크하고 저장합니다.
삭제 테스트:
- 이제 그 testuser로 사이트에 로그인합니다.
- "다른 사람"이 쓴 글이나 댓글에 가봅니다.
- [삭제] 버튼이 보이나요?
- 버튼을 눌렀을 때 실제로 삭제가 되나요?

8. 디테일 업그레이드 ( 조회수 쿠키 & Humanize)

잼이써요 — Sun, 7 Dec 2025 22:18:57 +0900

[STEP 8] 디테일 업그레이드 (조회수 쿠키 & Humanize)

본 카테고리의 마지막 단계입니다.

조회수 중복 증가(F5 연타)를 방지하고, "방금 전", "5분 전" 같은 날짜 표시를 적용합니다.

1. 설정 추가 (config/settings.py)

config/settings.py 를 열어 날짜를 사람이 보기 편하게 바꿔주는 humanize 앱을 등록합니다.

INSTALLED_APPS = [
    # ... 기존 앱들 ...
    'django.contrib.staticfiles',
    'django.contrib.humanize', # [추가]
    # ...
]

# (참고) 언어 설정이 한국어여야 "방금 전"으로 나옵니다.
LANGUAGE_CODE = 'ko-kr'

⚠️ 중요: 서버가 실행 중이라면 설정 파일을 수정했으므로 서버를 재시작해 주세요.

2. 로직 수정 (boards/views.py)

쿠키(Cookie)를 사용하여 "오늘 하루 동안은 같은 글의 조회수를 1번만 증가"시키도록 로직을 변경합니다.

boards/views.py의 board_detail 함수를 수정하세요.

# [import 추가]
from django.utils import timezone
from datetime import datetime, timedelta, time

def board_detail(request, board_code, pk):
    board = get_object_or_404(Board, code=board_code)
    post = get_object_or_404(Post, pk=pk, board=board)
    
    # 1. 쿠키 이름 정의 (게시글마다 달라야 함)
    cookie_name = f'hitboard_{board_code}_{pk}'
    
    # 2. 응답 객체 미리 생성 (쿠키를 심기 위해)
    # select_related('author'): 댓글 작성자 정보를 한 번에 가져와서 DB 성능 최적화
    response = render(request, 'boards/board_detail.html', {
        'board': board,
        'post': post,
        'comments': post.comments.select_related('author').all(), 
        'form': CommentForm()
    })

    # 3. 쿠키 확인: 쿠키가 없을 때만 조회수 증가
    if request.COOKIES.get(cookie_name) is None:
        post.views += 1
        post.save()
        
        # 4. 쿠키 유효기간 설정 (오늘 밤 자정까지)
        tomorrow = datetime.now() + timedelta(days=1)
        midnight = datetime.combine(tomorrow, time.min)
        expires = (midnight - datetime.now()).total_seconds()
        
        # 쿠키 심기
        response.set_cookie(cookie_name, 'true', max_age=expires)
        
    return response

3. 화면 수정 1 - 메인 대시보드 (templates/home.html)

메인 화면(templates/home.html)의 게시글 목록에 작성 시간(naturaltime)을 추가합니다.

{% extends 'base.html' %}
{% load humanize %} {% block content %}
<div class="row mt-2">
    <div class="col-md-6 mb-4">
        <div class="card h-100">
            <div class="card-header bg-light">
                <i class="bi bi-clock"></i> <strong>자유게시판 최신글</strong>
            </div>
            <ul class="list-group list-group-flush">
                {% for post in free_posts %}
                <li class="list-group-item d-flex justify-content-between align-items-center">
                    <a href="{% url 'boards:board_detail' post.board.code post.pk %}" class="text-decoration-none text-dark text-truncate" style="max-width: 75%;">
                        {{ post.title }}
                        
                        <span class="small text-muted ms-1">
                             {{ post.created_at|naturaltime }}
                        </span>
                    </a>
                    <div class="small text-muted">
                        {{ post.author.username }}
                    </div>
                </li>
                {% empty %}
                <li class="list-group-item text-center text-muted small py-3">등록된 게시글이 없습니다.</li>
                {% endfor %}
            </ul>
        </div>
    </div>
</div>
{% endblock %}

naturaltime이 자동으로 해주는 것

{{ post.created_at|naturaltime }} 한 줄을 적으면, 내부적으로 이런 계산을 수행합니다.

현재 시간(Now)과 입력된 시간(Created_at)의 차이를 계산합니다.
그 차이에 따라 적절한 문자열을 리턴합니다.
- 몇 초 차이: "방금 전 (now)"
- 몇 분 차이: "3분 전 (3 minutes ago)"
- 몇 시간 차이: "2시간 전 (2 hours ago)"
- 하루 이상: "어제 (yesterday)", "3일 전", "1달 전"

4. 화면 수정 2 - 게시글 상세 (boards/board_detail.html)

게시글 상세 화면(boards/board_detail.html)에서 게시글과 댓글 작성 시간에도 적용합니다.

{% extends 'base.html' %}
{% load humanize %} {% block content %}
<span class="text-muted small ms-2">{{ post.created_at|naturaltime }}</span>
<span class="text-muted small ms-2">{{ comment.created_at|naturaltime }}</span>
{% endblock %}

5. 화면 수정 3 - 쪽지함 (accounts/message_list.html)

쪽지함 (accounts/message_list.html)의 쪽지 수신 시간에도 적용합니다.

{% extends 'base.html' %}
{% load humanize %} {% block content %}
<small class="text-muted">{{ msg.created_at|naturaltime }}</small>
{% endblock %}

6. 테스트

조회수 방지: 게시글 접속 후 F5를 눌러도 조회수가 그대로인지 확인합니다.
시간 표시: "방금 전", "5분 전" 등으로 예쁘게 나오는지 확인합니다.

7. 사용자 간 1:1 쪽지 기능(DM) 구현

잼이써요 — Sun, 7 Dec 2025 21:40:11 +0900

[STEP 7] 사용자 간 1:1 쪽지 기능 (DM) 구현하기

이번 단계에서는 이메일 스타일의 쪽지(Direct Message) 시스템을 구현해 보겠습니다.

단순한 텍스트 전송을 넘어, 제목(Title)이 있고 상대방이 읽었는지 확인할 수 있는 수신 확인(Read Check) 기능을 포함한 Direct Message 기능을 구현해보도록 하겠습니다.

1. 모델 수정 (accounts/models.py)

쪽지 데이터를 저장할 모델을 정의합니다. 누가(Sender), 누구에게(Receiver), 무엇을(Title, Content) 보냈는지 저장하며, read_at 필드를 통해 수신 확인 기능을 구현합니다.

accounts/models.py 하단에 Message 클래스를 추가합니다.

from django.db import models
from django.conf import settings # User 모델 참조

class Message(models.Model):
    # 보낸 사람, 받는 사람 (User 모델과 1:N 관계)
    sender = models.ForeignKey(settings.AUTH_USER_MODEL, related_name="sent_messages", on_delete=models.CASCADE, verbose_name="보낸 사람")
    receiver = models.ForeignKey(settings.AUTH_USER_MODEL, related_name="received_messages", on_delete=models.CASCADE, verbose_name="받는 사람")
    
    # 제목 및 내용
    title = models.CharField(max_length=200, verbose_name="제목")
    content = models.TextField(verbose_name="내용")
    
    # 시간 기록
    created_at = models.DateTimeField(auto_now_add=True, verbose_name="보낸 시간")
    read_at = models.DateTimeField(null=True, blank=True, verbose_name="읽은 시간") # 읽었을 때만 시간이 기록됨

    def __str__(self):
        return f"To {self.receiver}: {self.title}"
    
    class Meta:
        ordering = ['-created_at'] # 최신 쪽지가 맨 위에 오도록 정렬

2. DB 반영 (마이그레이션)

새로운 모델을 DB에 반영합니다.

[Bash]

python manage.py makemigrations

⚠️ 주의: 기존 데이터 처리 알림 만약 "It is impossible to add a non-nullable field 'title'..." 메시지가 뜬다면, 기존 데이터에 제목을 뭘로 채울지 묻는 것입니다.

Select an option: 1 입력 (일회성 기본값 제공)

>>> '제목 없음' 입력 (작은따옴표 필수!)

[Bash]

python manage.py migrate

3. 폼 작성 (accounts/forms.py)

쪽지 작성 시 사용할 폼을 만듭니다.

accounts/forms.py를 수정합니다.

# [import 추가] Message 모델 추가
from .models import User, Message 

# ... 기존 UserChangeForm ...

# [추가] 쪽지 작성 폼
class MessageForm(forms.ModelForm):
    class Meta:
        model = Message
        fields = ['title', 'content'] # 제목과 내용만 입력받음
        widgets = {
            'title': forms.TextInput(attrs={
                'class': 'form-control',
                'placeholder': '제목을 입력하세요.'
            }),
            'content': forms.Textarea(attrs={
                'class': 'form-control',
                'rows': 5,
                'placeholder': '내용을 입력하세요.'
            })
        }

4. URL 설정 (accounts/urls.py)

쪽지함(목록), 보내기, 상세 보기 3가지 URL을 등록합니다.

accounts/urls.py에 추가합니다.

urlpatterns = [
    # ... 기존 url들 ...
    
    # 1. 쪽지함 (받은/보낸 통합)
    path('messages/', views.message_list, name='message_list'),
    
    # 2. 쪽지 보내기 (receiver_pk: 받는 사람 ID)
    path('messages/send/<int:receiver_pk>/', views.message_send, name='message_send'),
    
    # 3. 쪽지 상세 보기 (message_pk: 쪽지 ID)
    path('messages/<int:message_pk>/', views.message_detail, name='message_detail'),
]

5. 로직 작성 (accounts/views.py)

쪽지 기능의 핵심 로직입니다.

특히 message_list에서 안 읽은 개수 계산과 message_detail에서 읽음 처리 로직을 눈여겨보세요.

accounts/views.py 하단에 추가합니다.

# [필수 import]
from django.shortcuts import render, get_object_or_404, redirect
from django.contrib.auth.decorators import login_required
from django.contrib.auth import get_user_model
from django.utils import timezone # 시간 기록용
from .models import Message
from .forms import MessageForm

# 1. 쪽지함 (목록)
@login_required
def message_list(request):
    # 받은 쪽지 & 보낸 쪽지 조회
    received_messages = Message.objects.filter(receiver=request.user)
    sent_messages = Message.objects.filter(sender=request.user)
    
    # [핵심] 안 읽은 쪽지 개수 계산 (read_at이 비어있는 것)
    unread_count = received_messages.filter(read_at__isnull=True).count()
    
    context = {
        'received_messages': received_messages,
        'sent_messages': sent_messages,
        'unread_count': unread_count, # 뱃지 표시용
    }
    return render(request, 'accounts/message_list.html', context)

# 2. 쪽지 보내기
@login_required
def message_send(request, receiver_pk):
    User = get_user_model()
    receiver = get_object_or_404(User, pk=receiver_pk)
    
    if request.method == 'POST':
        form = MessageForm(request.POST)
        if form.is_valid():
            message = form.save(commit=False)
            message.sender = request.user   # 보낸 사람: 나
            message.receiver = receiver     # 받는 사람: 지정된 유저
            message.save()
            return redirect('accounts:message_list')
    else:
        form = MessageForm()
        
    return render(request, 'accounts/message_send.html', {'form': form, 'receiver': receiver})

# 3. 쪽지 상세 보기 & 읽음 처리
@login_required
def message_detail(request, message_pk):
    message = get_object_or_404(Message, pk=message_pk)
    
    # [권한 체크] 당사자(보낸 사람, 받은 사람)가 아니면 접근 불가
    if request.user != message.sender and request.user != message.receiver:
        return redirect('accounts:message_list')

    # [읽음 처리] 받는 사람이 처음 열어본 경우에만 현재 시간 기록
    if request.user == message.receiver and not message.read_at:
        message.read_at = timezone.now()
        message.save()

    return render(request, 'accounts/message_detail.html', {'message': message})

6. 화면 작성 1 - 쪽지함 (accounts/message_list.html)

Bootstrap Tabs를 이용해 받은 편지함과 보낸 편지함을 구분합니다.

받은 편지함 탭에는 안 읽은 메시지가 있을 때 빨간 뱃지(N)를 띄워줍니다.

accounts/templates/accounts/message_list.html 생성 후 아래 코드를 작성합니다.

{% extends 'base.html' %}

{% block content %}
<div class="container mt-4">
    <h3 class="mb-4"><i class="bi bi-envelope"></i> 내 쪽지함</h3>

    <ul class="nav nav-tabs" id="messageTab" role="tablist">
        <li class="nav-item" role="presentation">
            <button class="nav-link active" id="received-tab" data-bs-toggle="tab" data-bs-target="#received" type="button" role="tab" aria-controls="received" aria-selected="true">
                받은 쪽지 
                {% if unread_count > 0 %}
                    <span class="badge bg-danger rounded-pill">{{ unread_count }}</span>
                {% endif %}
            </button>
        </li>
        <li class="nav-item" role="presentation">
            <button class="nav-link" id="sent-tab" data-bs-toggle="tab" data-bs-target="#sent" type="button" role="tab" aria-controls="sent" aria-selected="false">
                보낸 쪽지 
                </button>
        </li>
    </ul>

    <div class="tab-content p-3 border border-top-0 bg-white" id="messageTabContent">
        
        <div class="tab-pane fade show active" id="received" role="tabpanel" aria-labelledby="received-tab">
            <div class="list-group list-group-flush">
                {% for msg in received_messages %}
                <a href="{% url 'accounts:message_detail' msg.pk %}" class="list-group-item list-group-item-action">
                    <div class="d-flex justify-content-between">
                        <strong>
                            {% if not msg.read_at %}
                            <span class="badge bg-danger me-1">N</span> {% endif %}
                            {{ msg.title }}
                        </strong>
                        <small class="text-muted">{{ msg.created_at|date:"Y-m-d" }}</small>
                    </div>
                    <div class="small text-muted mt-1">
                        From: 
                        {% if msg.sender.avatar %}
                        <img src="{{ msg.sender.avatar.url }}" width="20" height="20" class="rounded-circle me-1">
                        {% endif %}
                        {{ msg.sender.nickname|default:msg.sender.username }}
                    </div>
                </a>
                {% empty %}
                <p class="text-center py-4 text-muted">받은 쪽지가 없습니다.</p>
                {% endfor %}
            </div>
        </div>

        <div class="tab-pane fade" id="sent" role="tabpanel" aria-labelledby="sent-tab">
             <div class="list-group list-group-flush">
                {% for msg in sent_messages %}
                <a href="{% url 'accounts:message_detail' msg.pk %}" class="list-group-item list-group-item-action">
                    <div class="d-flex justify-content-between">
                        <strong>{{ msg.title }}</strong>
                        <small class="text-muted">
                            {% if msg.read_at %}
                            <span class="text-success"><i class="bi bi-check-all"></i> 읽음</span>
                            {% else %}
                            <span class="text-secondary">읽지 않음</span>
                            {% endif %}
                        </small>
                    </div>
                    <div class="small text-muted mt-1">
                        To: 
                        {% if msg.receiver.avatar %}
                        <img src="{{ msg.receiver.avatar.url }}" width="20" height="20" class="rounded-circle me-1">
                        {% endif %}
                        {{ msg.receiver.nickname|default:msg.receiver.username }}
                    </div>
                </a>
                {% empty %}
                <p class="text-center py-4 text-muted">보낸 쪽지가 없습니다.</p>
                {% endfor %}
            </div>
        </div>
    </div>
</div>

<script src="https://cdn.jsdelivr.net/npm/bootstrap@5.3.0/dist/js/bootstrap.bundle.min.js"></script>
{% endblock %}

7. 화면 작성 2 - 쪽지 쓰기 (accounts/message_send.html)

제목과 내용을 입력받는 폼입니다. form.as_p 대신 수동으로 필드를 배치합니다.

accounts/templates/accounts/message_send.html 생성 후 아래 코드를 작성합니다.

{% extends 'base.html' %}

{% block content %}
<div class="row justify-content-center">
    <div class="col-md-6">
        <div class="card mt-4">
            <div class="card-header bg-primary text-white">
                <i class="bi bi-send"></i> 쪽지 보내기
            </div>
            <div class="card-body">
                <p>
                    받는 사람: 
                    <strong>
                        {% if receiver.avatar %}
                        <img src="{{ receiver.avatar.url }}" width="24" height="24" class="rounded-circle me-1">
                        {% endif %}
                        {{ receiver.nickname|default:receiver.username }}
                    </strong>
                </p>
                
                <form method="post">
                    {% csrf_token %}
                    
                    <div class="mb-3">
                        <label for="{{ form.title.id_for_label }}" class="form-label">제목</label>
                        {{ form.title }}
                    </div>

                    <div class="mb-3">
                        <label for="{{ form.content.id_for_label }}" class="form-label">내용</label>
                        {{ form.content }}
                    </div>
                    
                    <div class="d-grid gap-2">
                        <button type="submit" class="btn btn-primary">전송하기</button>
                        <a href="javascript:history.back()" class="btn btn-secondary">취소</a>
                    </div>
                </form>
            </div>
        </div>
    </div>
</div>
{% endblock %}

8. 화면 작성 3 - 쪽지 상세 (accounts/message_detail.html)

쪽지의 내용을 확인하고, 받은 쪽지라면 바로 답장할 수 있는 버튼을 제공합니다.

accounts/templates/accounts/message_detail.html 생성 후 아래 코드를 작성합니다.

{% extends 'base.html' %}

{% block content %}
<div class="row justify-content-center">
    <div class="col-md-8">
        <div class="card mt-4">
            <div class="card-header d-flex justify-content-between align-items-center">
                <h5 class="mb-0">{{ message.title }}</h5>
                <small class="text-muted">{{ message.created_at|date:"Y-m-d H:i" }}</small>
            </div>
            <div class="card-body">
                <div class="mb-3 p-3 bg-light rounded d-flex justify-content-between align-items-center">
                    <div>
                        <span class="text-secondary me-2">보낸 사람:</span>
                        {% if message.sender.avatar %}
                            <img src="{{ message.sender.avatar.url }}" width="24" height="24" class="rounded-circle">
                        {% endif %}
                        <strong>{{ message.sender.nickname|default:message.sender.username }}</strong>
                    </div>
                    
                    {% if user == message.sender %}
                        <div class="small">
                            {% if message.read_at %}
                                <span class="text-success"><i class="bi bi-check-all"></i> {{ message.read_at|date:"m/d H:i" }} 읽음</span>
                            {% else %}
                                <span class="text-muted">읽지 않음</span>
                            {% endif %}
                        </div>
                    {% endif %}
                </div>

                <div class="content mb-4" style="min-height: 150px;">
                    {{ message.content|linebreaks }}
                </div>

                <div class="d-flex justify-content-end gap-2">
                    <a href="{% url 'accounts:message_list' %}" class="btn btn-secondary">목록</a>
                    
                    {% if user == message.receiver %}
                        <a href="{% url 'accounts:message_send' message.sender.pk %}" class="btn btn-primary">답장</a>
                    {% endif %}
                </div>
            </div>
        </div>
    </div>
</div>
{% endblock %}

9. 네비게이션 및 게시판 연결

마지막으로 이 훌륭한 기능을 사용자가 쉽게 찾을 수 있도록 연결합니다.

1. 상단바 수정 (templates/base.html)

- 프로필 클릭 시 마이페이지 | 쪽지함 드롭다운 메뉴 추가

<li class="nav-item dropdown me-3">
    <a class="nav-link dropdown-toggle d-flex align-items-center gap-2" href="#" role="button" data-bs-toggle="dropdown" aria-expanded="false">
        <strong>{{ user.nickname|default:user.username }}</strong>
    </a>
    <ul class="dropdown-menu dropdown-menu-end">
        <li><a class="dropdown-item" href="{% url 'accounts:profile' %}"><i class="bi bi-person-gear"></i> 내 정보</a></li>
        <li><a class="dropdown-item" href="{% url 'accounts:message_list' %}"><i class="bi bi-envelope"></i> 쪽지함</a></li>
    </ul>
</li>

2. 게시판 상세 페이지 (board_detail.html)

- 작성자 클릭 시 '쪽지 보내기' 메뉴 추가

<span class="dropdown">
    <a href="#" class="text-decoration-none text-dark fw-bold dropdown-toggle" data-bs-toggle="dropdown">
        {{ post.author.nickname|default:post.author.username }}
    </a>
    <ul class="dropdown-menu">
        <li><a class="dropdown-item" href="{% url 'accounts:message_send' post.author.pk %}">쪽지 보내기</a></li>
    </ul>
</span>

10. 테스트 (기능 점검)

테스트를 위해 Chrome 시크릿 모드나 다른 브라우저를 켜서, 두 개의 아이디(보내는 사람/받는 사람)로
동시에 로그인해 두면 편합니다.)

쪽지 보내기 (게시판 연동):
- 게시글 상세 페이지에서 작성자 닉네임을 클릭합니다.
- 드롭다운 메뉴에서 **[쪽지 보내기]**를 누릅니다.
- 제목과 내용을 입력하고 전송합니다.
수신 확인 (받는 사람 입장):
- 받는 사람 아이디로 로그인합니다.
- 상단 메뉴바의 프로필을 클릭하고 **[쪽지함]**으로 이동합니다.
- [받은 쪽지] 탭에 **빨간색 뱃지(N)**가 떠 있는지, 안 읽은 쪽지 개수가 맞는지 확인합니다.
- 쪽지를 클릭해서 상세 내용을 읽습니다. (이 순간 '읽음' 처리가 됩니다.)
읽음 확인 (보낸 사람 입장):
- 다시 보낸 사람 아이디로 돌아옵니다.
- 쪽지함의 [보낸 쪽지] 탭으로 이동합니다.
- 방금 보낸 쪽지의 상태가 **"읽지 않음"**에서 **"읽음(체크 표시)"**으로 바뀌었는지 확인합니다.
답장 기능:
- 받은 쪽지 상세 페이지에서 [답장] 버튼을 눌러 바로 답장을 보내봅니다.