Feature/modular architecture

.dockerignore

@@ -0,0 +1,8 @@
+env/
+venv/
+__pycache__/
+*.pyc
+.git/
+.github/
+.env
+.venv/

.flake8

@@ -0,0 +1,10 @@
+[flake8]
+exclude = 
+    .venv,
+    venv,
+    .venv/
+    venv\Scripts\pywin32_postinstall.py
+    __pycache__,
+    build,
+    dist
+max-line-length = 88

.github/workflows/ci-cd.yml

@@ -0,0 +1,74 @@
+name: CI/CD - OC Lettings Django
+
+on:
+  push:
+    branches: [ feature/modular-architecture ]
+  pull_request:
+    branches: [ feature/modular-architecture ]
+
+env:
+  PYTHON_VERSION: '3.11'
+  DJANGO_SETTINGS_MODULE: 'oc_lettings_site.settings'
+  FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+
+jobs:
+  lint-test:
+    runs-on: ubuntu-latest
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Set up Python
+      uses: actions/setup-python@v5
+      with:
+        python-version: ${{ env.PYTHON_VERSION }}
+
+    - name: Install dependencies
+      run: |
+        python -m pip install --upgrade pip
+        pip install -r requirements.txt
+        pip install pytest pytest-django pytest-cov flake8
+
+    - name: Lint with flake8
+      run: flake8 .
+
+    - name: Apply migrations
+      run: python manage.py migrate --noinput
+
+    - name: Run tests
+      env:
+        SECRET_KEY: "test-secret-key"
+        SENTRY_DSN: ""
+      run: |
+        pytest --cov=oc_lettings_site --cov=lettings --cov=profiles \
+               --cov-report=term-missing
+
+  docker-build:
+    needs: lint-test
+    runs-on: ubuntu-latest
+    if: github.event_name == 'push'
+
+    steps:
+    - name: Checkout repository
+      uses: actions/checkout@v4
+
+    - name: Set up Docker Buildx
+      uses: docker/setup-buildx-action@v3
+
+    - name: Login to DockerHub
+      uses: docker/login-action@v3
+      with:
+        username: ${{ secrets.DOCKERHUB_USERNAME }}
+        password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+    - name: Build and push Docker image
+      uses: docker/build-push-action@v6
+      with:
+        context: .
+        push: true
+        tags: |
+          ${{ secrets.DOCKERHUB_USERNAME }}/oc-lettings:latest
+          ${{ secrets.DOCKERHUB_USERNAME }}/oc-lettings:${{ github.sha }}
+        cache-from: type=gha
+        cache-to: type=gha,mode=max

.gitignore

@@ -1,3 +1,13 @@
 **/__pycache__
 *.pyc
+env
+.env
+.media
+env/
+venv/
+*.venv/
+*.idea
+*.coverage
 venv
+*.venv
+*.idea/

.readthedocs.yaml

@@ -0,0 +1,13 @@
+version: 2
+
+build:
+  os: ubuntu-22.04
+  tools:
+    python: "3.12"
+
+python:
+  install:
+    - requirements: requirements.txt
+
+sphinx:
+  configuration: doc/source/conf.py

Dockerfile

@@ -0,0 +1,20 @@
+FROM python:3.11-slim
+
+ENV PYTHONUNBUFFERED=1 \
+    PYTHONDONTWRITEBYTECODE=1 \
+    DJANGO_SETTINGS_MODULE=oc_lettings_site.settings \
+    SECRET_KEY=build-secret-key-not-for-production
+
+WORKDIR /app
+
+COPY requirements.txt .
+RUN pip install --no-cache-dir --upgrade pip && \
+    pip install --no-cache-dir -r requirements.txt
+
+COPY . .
+
+COPY test_db.sqlite3 /app/test_db.sqlite3
+
+EXPOSE 8000
+
+CMD ["sh", "-c", "echo '=== contenu /app/static ===' && ls /app/static/ && python manage.py collectstatic --noinput && gunicorn oc_lettings_site.wsgi:application --bind 0.0.0.0:8000"]

Procfile

@@ -0,0 +1,2 @@
+web: gunicorn oc_lettings_site.wsgi
+release: python manage.py collectstatic --noinput

README.md

@@ -1,45 +1,52 @@
 ## Résumé
 
-Site web d'Orange County Lettings
+Site web d'Orange County Lettings (projet Django modulaires : applications `home`, `lettings`, `profiles`).
 
 ## Développement local
 
 ### Prérequis
 
-- Compte GitHub avec accès en lecture à ce repository
-- Git CLI
-- SQLite3 CLI
-- Interpréteur Python, version 3.6 ou supérieure
+- Compte GitHub avec accès en lecture à ce repository.
+- Git CLI.
+- SQLite3 CLI.
+- Interpréteur Python, version 3.11 ou supérieure.
+- (Optionnel) Docker Desktop si vous souhaitez utiliser l’exécution via conteneur.
 
-Dans le reste de la documentation sur le développement local, il est supposé que la commande `python` de votre OS shell exécute l'interpréteur Python ci-dessus (à moins qu'un environnement virtuel ne soit activé).
+Dans le reste de la documentation sur le développement local sans Docker, 
+il est supposé que la commande `python` de votre OS shell exécute l'interpréteur 
+Python ci-dessus (à moins qu'un environnement virtuel ne soit activé).
 
-### macOS / Linux
+### macOS / Linux (sans Docker)
 
 #### Cloner le repository
 
 - `cd /path/to/put/project/in`
-- `git clone https://github.com/OpenClassrooms-Student-Center/Python-OC-Lettings-FR.git`
+- `git clone <URL DE VOTRE FORK>`
+- `cd Python-OC-Lettings-FR`
 
 #### Créer l'environnement virtuel
 
-- `cd /path/to/Python-OC-Lettings-FR`
 - `python -m venv venv`
-- `apt-get install python3-venv` (Si l'étape précédente comporte des erreurs avec un paquet non trouvé sur Ubuntu)
-- Activer l'environnement `source venv/bin/activate`
-- Confirmer que la commande `python` exécute l'interpréteur Python dans l'environnement virtuel
-`which python`
-- Confirmer que la version de l'interpréteur Python est la version 3.6 ou supérieure `python --version`
-- Confirmer que la commande `pip` exécute l'exécutable pip dans l'environnement virtuel, `which pip`
-- Pour désactiver l'environnement, `deactivate`
+- `apt-get install python3-venv` (si l'étape précédente échoue avec un paquet non trouvé sur Ubuntu)
+- Activer l'environnement : `source venv/bin/activate`
+- Confirmer que la commande `python` exécute l'interpréteur Python dans l'environnement virtuel :  
+  `which python`
+- Confirmer que la version de l'interpréteur Python est la version 3.11 ou supérieure :  
+  `python --version`
+- Confirmer que la commande `pip` exécute l'exécutable pip dans l'environnement virtuel :  
+  `which pip`
+- Pour désactiver l'environnement : `deactivate`
 
 #### Exécuter le site
 
 - `cd /path/to/Python-OC-Lettings-FR`
 - `source venv/bin/activate`
 - `pip install --requirement requirements.txt`
+- `python manage.py migrate`
 - `python manage.py runserver`
 - Aller sur `http://localhost:8000` dans un navigateur.
-- Confirmer que le site fonctionne et qu'il est possible de naviguer (vous devriez voir plusieurs profils et locations).
+- Confirmer que le site fonctionne et qu'il est possible de naviguer 
+   (vous devriez voir plusieurs profils et locations via les applications`lettings` et `profiles`).
 
 #### Linting
 
@@ -57,21 +64,38 @@ Dans le reste de la documentation sur le développement local, il est supposé q
 
 - `cd /path/to/Python-OC-Lettings-FR`
 - Ouvrir une session shell `sqlite3`
-- Se connecter à la base de données `.open oc-lettings-site.sqlite3`
-- Afficher les tables dans la base de données `.tables`
-- Afficher les colonnes dans le tableau des profils, `pragma table_info(Python-OC-Lettings-FR_profile);`
-- Lancer une requête sur la table des profils, `select user_id, favorite_city from
-  Python-OC-Lettings-FR_profile where favorite_city like 'B%';`
+- Se connecter à la base de données :  
+  `.open test_db.sqlite3`
+- Afficher les tables dans la base de données :  
+  `.tables`
+- Afficher les colonnes dans la table des profils :  
+  `pragma table_info(oc_lettings_site_profile);`  *(adapter au nom réel de la table si différent)*
+- Lancer une requête sur la table des profils, par exemple :  
+  `select user_id, favorite_city from oc_lettings_site_profile where favorite_city like 'B%';`
 - `.quit` pour quitter
 
 #### Panel d'administration
 
 - Aller sur `http://localhost:8000/admin`
-- Connectez-vous avec l'utilisateur `admin`, mot de passe `Abc1234!`
+- Connectez-vous avec l'utilisateur `user`, mot de passe `Abc1234!` (ou les identifiants définis dans vos fixtures / données locales).
+
+### Exécution avec Docker (optionnel)
+
+Si vous utilisez Docker :
+
+- Construire l’image :  
+  `docker build -t oc-lettings:local .`
+- Lancer le conteneur :  
+  `docker run -p 8000:8000 -e SECRET_KEY="test_key" -e DEBUG=False oc-lettings:local`
+- Aller sur `http://localhost:8000` dans un navigateur.
+
+*(Adapter cette section si vous utilisez `docker-compose` et un volume pour la base SQLite.)*
 
 ### Windows
 
 Utilisation de PowerShell, comme ci-dessus sauf :
 
-- Pour activer l'environnement virtuel, `.\venv\Scripts\Activate.ps1` 
-- Remplacer `which <my-command>` par `(Get-Command <my-command>).Path`
+- Pour activer l'environnement virtuel :  
+  `.\venv\Scripts\Activate.ps1`
+- Remplacer `which <my-command>` par :  
+  `(Get-Command <my-command>).Path`

accounts/apps.py

@@ -0,0 +1,6 @@
+from django.apps import AppConfig
+
+
+class AccountsConfig(AppConfig):
+    default_auto_field = 'django.db.models.BigAutoField'
+    name = 'accounts'

accounts/forms.py

@@ -0,0 +1,15 @@
+from django import forms
+from django.contrib.auth.forms import UserCreationForm, AuthenticationForm
+from django.contrib.auth.models import User
+
+
+class SignupForm(UserCreationForm):
+    email = forms.EmailField(required=True)
+
+    class Meta:
+        model = User
+        fields = ("username", "email", "password1", "password2")
+
+
+class LoginForm(AuthenticationForm):
+    pass

accounts/templates/accounts/login.html

@@ -0,0 +1,28 @@
+{% extends "base.html" %}
+{% block title %}Connexion{% endblock %}
+
+{% block content %}
+<div class="container px-5 py-5">
+  <div class="row justify-content-center">
+    <div class="col-lg-5">
+      <h1 class="display-6 mb-4">Connexion</h1>
+      <form method="post">
+        {% csrf_token %}
+        {% for field in form %}
+          <div class="mb-3">
+            <label class="form-label">{{ field.label }}</label>
+            {{ field }}
+            {% if field.errors %}
+              <div class="text-danger small mt-1">{{ field.errors.0 }}</div>
+            {% endif %}
+          </div>
+        {% endfor %}
+        <button type="submit" class="btn btn-primary w-100">Se connecter</button>
+      </form>
+      <p class="mt-3 text-center">
+        Pas encore de compte ? <a href="{% url 'accounts:signup' %}">Inscription</a>
+      </p>
+    </div>
+  </div>
+</div>
+{% endblock %}