Project

General

Profile

Actions

Feature #1249

closed
성양 서임

Feature #1226: [MDGU] 학사관리 시스템 v1 개발 (8주, 2026-11-05 시작)

Feature #1234: [MDGU-01] 공통 기반·설계 (우섭)

[MDGU-01-01] 저장소·Django 골격·앱 스텁·설정 분리

Feature #1249: [MDGU-01-01] 저장소·Django 골격·앱 스텁·설정 분리

Added by 성용 양 19 days ago. Updated 13 days ago.

Status:
Closed
Priority:
Normal
Assignee:
Start date:
11/05/2026
Due date:
11/06/2026
% Done:

100%

Estimated time:

Description

목적

다른 팀원들이 2주차부터 같은 파일을 건드리지 않고 작업할 수 있도록, 프로젝트 골격과 앱 스텁을 한 번에 만들고 인계합니다.

쉬운 설명

모든 팀원이 같은 뼈대 위에서 일하도록 Django 프로젝트와 앱 폴더(내용은 비어 있는 껍데기)를 만듭니다. 이 일감이 끝나야 다른 사람이 자기 앱을 시작할 수 있습니다.

기술 스택

Python 3.12, venv, Django 5.2 LTS, PostgreSQL 18, psycopg[binary], python-dotenv, ruff, pytest(후보).

예상 결과(산출물)

모두가 clone 후 runserver를 띄울 수 있는 저장소. 앱 14개 + core 스텁이 settings에 등록된 상태.

개발 작업 상세

  1. 저장소(university-academic-system)의 기존 파일을 먼저 확인한다(기존 manage.py가 있으면 덮어쓰지 않는다).
  2. django-admin startproject config .로 골격을 만들고 settings를 base/local/production으로 나눈다.
  3. .env.example(비밀값 없음)을 만들고 settings가 환경변수를 읽게 한다. .gitignore에 .env*를 넣는다.
  4. 앱 스텁을 만든다: accounts, security, academics, admissions, students, enrollment, grades, tuition, graduation, documents, files, imports, search, legacy_migration, core. INSTALLED_APPS에 한 번에 등록한다.
  5. accounts에 커스텀 User 모델 stub(AbstractUser 기반)을 첫 migrate 전에 만든다. AUTH_USER_MODEL을 지정한다.
  6. 로컬 PostgreSQL 18 연결, check·migrate·runserver를 확인한다.
  7. ruff·pytest 설정 파일과 requirements를 만든다.

완료 기준

  • python manage.py check와 migrate가 통과한다.
  • 14개 앱이 import 오류 없이 로드된다.
  • 비밀값이 저장소에 없다.

충돌 방지(소유 범위)

config/, core/, requirements, .env.example는 우섭 소유. 앱 스텁 폴더는 생성만 하고 이후 각 소유자에게 인계합니다. 이후 앱 추가 때 settings를 고치지 않아도 되도록 이 일감에서 일괄 등록합니다.

선행·후행·위험

선행: 없음 (바로 시작 가능)

후행: 01-02 ERD·모델 계약 초안(앱 간 FK 규칙)(우섭) / 01-03 파일 소유권·브랜치·PR 규칙 문서(CODEOWNERS)(우섭) / 01-04 공통 모델·기본 템플릿·레이아웃(우섭) / 03-01 승인 계정 ID/PW 로그인·세션·로그인 제한(서현) / 04-02 GitHub Actions CI(테스트·린트·마이그레이션 검사)(성용) / 05-01 조직 구조(단과대학·학과·전공·학위과정) 모델·관리 화면(우섭)

위험: 이 일감이 밀리면 2주차 작업 전체가 밀림.

결과 확인 방법

"완료 기준"의 각 항목을 화면 또는 명령으로 직접 확인합니다.

  1. python manage.py check와 migrate가 통과한다.
  2. 14개 앱이 import 오류 없이 로드된다.
  3. 비밀값이 저장소에 없다.
  4. pytest 설정·수집이 오류 없이 동작한다(테스트 0개의 종료 코드 5는 정상).
  5. 확인 결과(화면 캡처 또는 명령 출력 요약)를 일감 메모에 남긴다.

갱신 사항 (2026-11-04)

  • 완료: 공통 골격이 main에 병합됨(config.settings base/local/production, 앱 스텁 15개, .env.example, pyproject.toml, requirements*.txt). 실제 구성은 PostgreSQL 18, 환경변수 DB_NAME/DB_USER/DB_PASSWORD/DB_HOST/DB_PORT, .env.local 사용.
  • 테스트가 아직 없어 pytest는 collected 0 items(종료 코드 5)가 정상이다. 완료 기준의 pytest는 수집·설정 오류 없음으로 해석한다.

시작 전 준비

  1. 선행 일감의 결과물(문서·코드)을 먼저 읽고 약속된 이름·구조를 확인한다.
  2. 저장소를 최신으로 맞춘다: git switch main 후 git pull --ff-only origin main
  3. 저장소 README 8번과 팀 로컬 세팅 안내 순서대로 환경을 준비한다. 보통 py -3.12 -m venv .venv, 가상환경 켜기, python -m pip install -r requirements-dev.txt, Windows에 설치한 PostgreSQL 18에서 개인 로컬 DB(university_dev) 생성, .env.local 설정(DB_NAME, DB_USER, DB_PASSWORD, DB_HOST, DB_PORT), python manage.py check, python manage.py migrate 순서이다. 최초 실행에 makemigrations는 필요 없고, .env.local과 비밀번호는 공유·커밋하지 않는다.
  4. #1226의 폴더 소유 표에서 내가 고칠 수 있는 폴더를 확인한다.

작업 진행 순서

  1. 브랜치를 만든다: git switch -c feature/1249-<짧은영문설명>
  2. "개발 작업 상세"의 번호 순서대로 한 단계씩 구현하고, 단계마다 pytest로 확인한다.
  3. 모델을 바꾸면 python manage.py makemigrations, 그다음 python manage.py migrate를 실행한다.
  4. 화면은 python manage.py runserver로 실행해 직접 열어 보고 "완료 기준"과 하나씩 대조한다.
  5. git add, git commit, git push 후 PR을 만든다. PR 템플릿의 체크리스트를 채우고 폴더 소유자의 리뷰를 받는다.
  6. 병합 후 이 일감 메모에 PR 링크와 확인 결과를 적고 상태와 진행률을 갱신한다.

막힐 때 확인

패키지 설치 오류는 Python 3.12 사용 여부와 가상환경 재생성을 먼저 확인하세요. DB 연결 오류는 Windows에 설치한 PostgreSQL 18 서비스가 실행 중인지와 .env.local의 DB_* 값을 확인하세요.

그래도 해결되지 않으면 일감 메모에 "무엇을 했고, 어떤 오류가 났는지"를 붙여 담당 분류 소유자 또는 팀장에게 질문하세요.

용어 풀이

  • 마이그레이션: 모델(코드)의 변경을 DB 구조에 반영하는 변경 기록 파일과 그 적용 작업입니다. makemigrations로 만들고 migrate로 적용합니다.
  • pytest: Python 코드를 자동으로 검사해 주는 테스트 도구입니다. 테스트 파일은 tests/ 폴더에 둡니다.

Related issues 6 (6 open — 0 closed)

Precedes Feature #1252: [MDGU-01-04] 공통 모델·기본 템플릿·레이아웃Resolved우섭 심11/10/202611/11/2026

Actions
Precedes Feature #1259: [MDGU-03-01] 승인 계정 ID/PW 로그인·세션·로그인 제한Resolved서현 임11/12/202611/17/2026

Actions
Precedes Feature #1264: [MDGU-04-02] GitHub Actions CI(테스트·린트·마이그레이션 검사)Resolved성용 양11/17/202611/18/2026

Actions
Precedes Feature #1250: [MDGU-01-02] ERD·모델 계약 초안(앱 간 FK 규칙)Resolved우섭 심11/09/202611/11/2026

Actions
Precedes Feature #1251: [MDGU-01-03] 파일 소유권·브랜치·PR 규칙 문서(CODEOWNERS)Resolved우섭 심11/09/202611/09/2026

Actions
Precedes Feature #1269: [MDGU-05-01] 조직 구조(단과대학·학과·전공·학위과정) 모델·관리 화면Resolved우섭 심11/12/202611/13/2026

Actions
Actions

Also available in: PDF Atom