Skip to content

Latest commit

 

History

History
164 lines (126 loc) · 4.42 KB

Readme-ja.md

File metadata and controls

164 lines (126 loc) · 4.42 KB

English | 日本語

Django Bookshelf

このリポジトリには、プログラミング言語II Pythonの最終課題である。

このプロジェクトは、Djangoを使用して構築された書籍管理システムであり、研究室や学習環境で使用することを目的としています。

📌 Features

  • Django 3.2.16で構築
  • django-bootstrap5を使用したスタイリング
  • カテゴリ管理用の管理パネルを含む
  • データベースの初期化不要（SQLiteを使用）
  • pip install -r requirements.txtで簡単にインストール
  • python manage.py runserverでローカルで実行

⚙️ Installation & Setup

前提条件

  • Python 3.x
  • pip (Python package manager)

セットアップ

  1. リポジトリをクローンする:

    git clone https://github.com/cuajarsaki/django-bookshelf.git
cd django-bookshelf]

  2. 依存関係をインストールする:

    pip install -r requirements.txt

  3. 開発サーバーを実行する:

    python manage.py runserver

  4. アプリケーションにアクセスする:

  • Open http://127.0.0.1:8000/ to view the book management system.
  • To access the admin panel, go to http://127.0.0.1:8000/admin
  • Admin credentials:
  • Username: admin
  • Password: test_1234

🖥️ 実行画面

image

🛠️ 構造

flowchart TD
    subgraph Client
        Browser[Web Browser]
    end

    subgraph URLs["URLs (book/urls.py)"]
        RootURL["/ (book_list)"]
        CreateURL["/create/ (create)"]
        UpdateURL["/update/:pk/ (book_update)"]
        DeleteURL["/delete/:pk/ (book_delete)"]
        DetailURL["/detail/:pk/ (book_detail)"]
    end

    subgraph Views["Views (book/views.py)"]
        ListV[BookListView]
        CreateV[BookCreateView]
        UpdateV[BookUpdateView]
        DeleteV[BookDeleteView]
        DetailV[BookDetailView]
    end

    subgraph Forms["Forms (book/forms.py)"]
        F1[BookForm]
        F2[BookForm2]
    end

    subgraph Models["Models (book/models.py)"]
        BookM[Book]
        CategoryM[Category]
    end

    subgraph Templates
        BaseT[base.html]
        ListT[book_list.html]
        FormT[book_form.html]
        Form2T[book_form2.html]
        DeleteT[book_confirm_delete.html]
        DetailT[book_detail.html]
    end

    subgraph Database
        DB[(SQLite DB)]
    end

    Browser -->|HTTP Request| URLs
    
    RootURL --> ListV
    CreateURL --> CreateV
    UpdateURL --> UpdateV
    DeleteURL --> DeleteV
    DetailURL --> DetailV
    
    ListV --> ListT
    CreateV --> FormT
    UpdateV --> Form2T
    DeleteV --> DeleteT
    DetailV --> DetailT
    
    CreateV -->|Uses| F1
    UpdateV -->|Uses| F2
    
    F1 -->|Validates| BookM
    F2 -->|Validates| BookM
    
    BookM -->|ForeignKey| CategoryM
    
    ListT -->|Extends| BaseT
    FormT -->|Extends| BaseT
    Form2T -->|Extends| BaseT
    DeleteT -->|Extends| BaseT
    DetailT -->|Extends| BaseT
    
    BookM <-->|CRUD| DB
    CategoryM <-->|CRUD| DB
    
    ListV -->|queryset| BookM
Loading

⚠️ データベース管理

  • このプロジェクトは、デフォルトのデータベースとしてSQLiteを使用しています。
  • データベースをリセットするには、プロジェクトディレクトリからdb.sqlite3ファイルを削除します。

🏗️ 技術スタック

  • Django 3.2.16
  • django-bootstrap-form
  • django-bootstrap5
  • dj-static
  • python-decouple

🤔考慮事項

このプロジェクトでDjangoをBottleの代わりに選んだ理由：

  1. Djangoはウェブアプリケーション向けの多くの組み込み機能を提供
  2. 高いセキュリティ対策
  3. 高いスケーラビリティ
  4. 良好なドキュメントとコミュニティサポート

さらに、カテゴリ管理機能は管理パネルを通じて簡単に編集できます。

🏫 この課題について

  • コース：プログラミング言語II（Python）
  • 年度：2023