Skip to content

README.md

Latest commit

 

History

History
181 lines (136 loc) · 5.29 KB

README.md

File metadata and controls

181 lines (136 loc) · 5.29 KB

FutDraft — Inazuma Eleven Draft Web

A web application built with Django 6 that lets users explore players and teams from the Inazuma Eleven universe, build custom draft lineups, and save them to their profile.

Table of Contents

Overview

FutDraft is a fan-made interactive web game inspired by the FIFA FUT Draft mechanic, themed around Inazuma Eleven. Users are presented with randomised player choices (filtered by position and power tier), select their squad, choose a formation, name their draft, and save it for later viewing.

Player and team data is fetched from the public REST API that our team also created and is synced into the local database:

https://inazumaeleven-api.onrender.com

GithubProject: https://github.com/Zpidero/InazumaEleven_API

Tech Stack

Layer Technology
Backend Django 6.0.3
Language Python 3.14
ASGI Server Uvicorn 0.41.0
Database SQLite (via Django ORM)
Image Handling Pillow 12.2.0
Frontend HTML + Tailwind CSS
Containerisation Docker + Docker Compose
Package Manager uv
Config management python-decouple
External API inazumaeleven-api.onrender.com

Project Structure

DjangoProject1/
├── DjangoProject1/             # Django project config
│   ├── settings.py
│   ├── urls.py
│   ├── asgi.py
│   └── wsgi.py
├── myapp/                      # Main application
│   ├── models.py               # Teams, Players, Lineup, Profile, Futdraft
│   ├── views.py                # All view logic
│   ├── urls.py                 # App URL patterns
│   ├── forms.py                # User registration form
│   ├── admin.py                # Django admin registration
│   ├── management/
│   │   └── commands/
│   │       ├── sync_players.py # Sync all players from API → DB
│   │       └── sync_teams.py   # Sync all teams + images from API → DB
│   └── migrations/
├── templates/
│   ├── base.html
│   ├── components/
│   └── myapp/
├── static/
│   ├── css/
│   └── images/
│       ├── elements/           # Element PNG icons (local)
│       └── teams/              # Local team shield fallback image

├── .env                        # Enviorment Variables
├── Dockerfile
├── docker-compose.yml
├── manage.py
└── pyproject.toml

Data Models

Players

Stores player data synced from the external API. Fields: name, nickname, position, element, archetype, team (FK), power, control, technique, pressure, physical, agility, intelligence, total, age_Group, school_Year, gender, role, image.

Teams

Stores team name and image URL (nullable). Populated by sync_teams.

Lineup

Represents a formation (e.g. 4-3-3): forwards, midfielders, defenders, goalKeeper.

Profile

One-to-one extension of Django's built-in User, storing a profile picture.

Futdraft

A saved draft: links a User, a Lineup, and a set of Players (ManyToMany). Stores player_order as JSON to preserve pick order.

Setup & Installation

Prerequisites

  • Python 3.14+
  • uv package manager

Local Setup

# 1. Clone the repository
git clone <repo-url>
cd DjangoProject1

# 2. Copy and configure environment variables
cp .env.example .env
# Edit .env and set SECRET_KEY

# 3. Install dependencies
uv sync

# 4. Apply migrations
uv run manage.py migrate

# 5. Sync data from API into DB (one time)
uv run manage.py sync_players
uv run manage.py sync_teams

# 6. Run the development server
uv run manage.py runserver

Running with Docker

# 1. Copy and configure environment variables
cp .env.example .env

# 2. Build and start
docker compose up --build

The app will be available at http://localhost:8000. Data sync runs automatically on container start.

To run manually inside the container:

docker compose exec django uv run manage.py sync_players
docker compose exec django uv run manage.py sync_teams

URL Routes

URL View Description
/ home Landing page
/game/ game_view Draft game (login required)
/players/ players_list Player browser (paginated, filterable, searchable)
/teams/ teams_list Team browser (paginated, searchable)
/player/<id>/ player_detail Player detail page
/teams/<n>/ team_detail Team detail + squad list
/random-players/ get_random_players JSON endpoint for the draft game
/save-draft/ save_draft Save a completed draft (POST, login required)
/my-drafts/ my_drafts View saved drafts (login required)
/register/ register_view User registration
/login/ login_view User login
/admin/ Django admin Full admin interface