오리엔테이션: 우리가 함께 만들 것

혹시 이런 경험 있으신가요? Cursor나 Claude에게 "게시판 만들어줘"라고 했더니 폴더가 수십 개 뚝딱 생겨났는데, 막상 뭔가 고치려 하면 어디를 건드려야 할지 몰라서 AI에게 또 물어보는 상황. "동작은 하는데 왜 동작하는지 모르겠어요"라는 그 막막함, 이 연재가 정확히 그 지점을 겨냥합니다.

이 연재를 끝까지 읽으면 뭐가 달라지나요? AI가 짜준 Django 코드를 그냥 복붙하는 게 아니라, "아, 이 줄이 이래서 여기 있구나"를 읽을 수 있게 됩니다. 지금 여러분이 보고 계신 이 사이트 테크창이 바로 완성본입니다. 연재를 완주하면 이 게시판과 동일한 구조의 앱을 직접 설명할 수 있게 됩니다.

🤖 AI가 짜준 코드

프롬프트: "Django로 간단한 게시판 만들어줘"

myboard/               ← 프로젝트 전체를 담는 큰 상자
├── manage.py          ← 프로젝트를 조종하는 리모컨
├── myboard/           ← 프로젝트 설정 모음 폴더
│   ├── settings.py    ← 앱 전체 환경설정 파일
│   ├── urls.py        ← 방문자를 각 페이지로 안내하는 안내판
│   └── wsgi.py        ← 서버와 앱을 연결하는 플러그
└── board/             ← 게시판 기능만 담당하는 작은 상자
    ├── models.py      ← 데이터 모양을 정의하는 설계도
    ├── views.py       ← 실제 로직을 처리하는 주방
    ├── urls.py        ← 게시판 내부 안내판
    └── templates/     ← 사용자에게 보여줄 HTML 파일들
        └── board/
            └── list.html

AI가 만들어준 폴더 구조입니다. 처음 보면 왜 폴더가 두 겹인지, urls.py가 왜 두 개인지 머리가 아프죠. 지금은 몰라도 됩니다. 이 연재 전체가 이 구조를 한 칸씩 뜯어보는 여정입니다.

🔍 한 줄씩 통역

프로젝트 = 건물, 앱 = 각 층

Django는 프로젝트(myboard/) 안에 앱(board/) 을 넣는 구조입니다. 건물 전체가 프로젝트라면, 게시판·회원·댓글 같은 기능 단위가 각각의 층(앱)입니다. 테크창도 이 구조로 되어 있어서, 기능을 추가할 때 새 층을 올리듯 앱을 하나 더 만들면 됩니다.

urls.py가 두 개인 이유

안내판이 건물 입구(myboard/urls.py)에 하나, 각 층 입구(board/urls.py)에 하나씩 있는 것과 같습니다. 입구 안내판은 "게시판은 2층"이라고만 알려주고, 2층 안내판이 "목록은 왼쪽, 작성은 오른쪽"을 세부 안내합니다. 역할을 나눠야 나중에 수정이 쉬워집니다.

views.py = 주방, templates = 음식이 담긴 그릇

views.py는 요청을 받아 데이터를 요리하는 주방입니다. 요리가 완성되면 templates/ 폴더 안의 HTML 그릇에 담아 손님(브라우저)에게 내보냅니다. 주방이 바뀌어도 그릇 디자인은 그대로고, 그릇이 바뀌어도 요리 레시피는 안 바뀝니다. 이 분리가 Django의 핵심 철학입니다.

⚠️ 자주 깨지는 지점

AI가 폴더를 만들어줬는데 바로 실행하면 이런 에러가 뜰 수 있습니다.

ModuleNotFoundError: No module named 'board'

원인: 앱 폴더를 만들었어도 settings.py의 INSTALLED_APPS에 'board'를 추가하지 않으면 Django가 그 앱의 존재를 아예 모릅니다. 새 층을 지었는데 건물 관리사무소 명부에 등록을 안 한 셈이죠.

해결: settings.py를 열고 INSTALLED_APPS 리스트에 'board', 한 줄을 추가하면 됩니다. 이 과정은 2편에서 직접 해봅니다.

🎮 직접 해보기

지금 이 페이지, 즉 테크창 게시판을 천천히 살펴보세요. 글 목록 페이지 → 글 상세 페이지 → 댓글 입력창 순서로 클릭해 보면서 "이게 어떤 파일에서 왔을까?"를 머릿속으로 상상해 보세요. 어떤 파일이 어떤 화면을 담당할 것 같은지 댓글이나 Q&A 게시판에 자유롭게 남겨 주세요. 정답·오답 없이 다 환영합니다. 막히거나 궁금한 점도 질문해 주시면 같이 풀어드립니다!

⏭️ 다음 편 예고

1편에서는 AI가 models.py에 써준 이 한 줄이 어떻게 데이터베이스 표 전체를 뚝딱 만들어내는지, 그 마법의 원리를 통역해 드립니다.

📚 시리즈: AI가 짜준 Django, 이제 알고 씁니다 · 0편 · 오리엔테이션
테크창 연구팀 | 인천대학교 창의인재개발학과 전공심화연구모임
본 칼럼은 AI 보조로 작성되었으며, 코드·예시는 학습용입니다.