PySide6 실전 강좌 #1 프로젝트 설계 — 습관 트래커를 만들며 배우는 앱 구조

daily/
├── pyproject.toml
└── src/daily/
    ├── __main__.py        # 진입점: python -m daily
    ├── app.py             # QApplication 생성과 조립
    ├── ui/                # 화면: 위젯, 창, 모델(뷰용)
    │   └── main_window.py
    ├── core/              # 규칙: 습관·연속 기록 계산 등 Qt와 무관한 로직
    │   └── habits.py
    └── data/              # 저장: SQLite 접근 (2편에서 구현)
        └── repository.py

uv init daily --package
cd daily
uv add pyside6
uv add --dev pytest pytest-qt

# src/daily/ui/main_window.py
from PySide6.QtWidgets import (
    QHBoxLayout, QLabel, QMainWindow, QPushButton,
    QStackedWidget, QVBoxLayout, QWidget,
)


class MainWindow(QMainWindow):
    def __init__(self) -> None:
        super().__init__()
        self.setWindowTitle("데일리")
        self.resize(480, 640)

        # 화면 자리: 지금은 자리 표시 라벨, 다음 편부터 실제 화면으로 교체
        self.pages = QStackedWidget()
        self.pages.addWidget(QLabel("오늘"))     # index 0: 3편에서 구현
        self.pages.addWidget(QLabel("통계"))     # index 1: 4편에서 구현
        self.pages.addWidget(QLabel("설정"))     # index 2: 6편에서 구현

        nav = QVBoxLayout()
        for i, name in enumerate(["오늘", "통계", "설정"]):
            btn = QPushButton(name)
            btn.clicked.connect(lambda _=False, idx=i: self.pages.setCurrentIndex(idx))
            nav.addWidget(btn)
        nav.addStretch()

        root = QWidget()
        layout = QHBoxLayout(root)
        layout.addLayout(nav)
        layout.addWidget(self.pages, stretch=1)
        self.setCentralWidget(root)

# src/daily/app.py
import sys

from PySide6.QtWidgets import QApplication

from daily.ui.main_window import MainWindow


def main() -> int:
    app = QApplication(sys.argv)
    app.setApplicationName("daily")
    app.setOrganizationName("daily-app")   # 6편의 QSettings가 이 값을 씁니다
    window = MainWindow()
    window.show()
    return app.exec()

# src/daily/__main__.py
import sys

from daily.app import main

sys.exit(main())