diff --git a/.gitignore b/.gitignore
index 2d5d515..5c125da 100644
--- a/.gitignore
+++ b/.gitignore
@@ -4,6 +4,7 @@ __pycache__
*:Zone.Identifier
+
# C extensions
*.so
diff --git a/Livrable/README.md b/Livrable/README.md
new file mode 100644
index 0000000..2c1a36d
--- /dev/null
+++ b/Livrable/README.md
@@ -0,0 +1,6 @@
+# Livrables
+
+Générer un pdf à partir de .md (Markdown):
+sudo apt install texlive-latex-recommended texlive-fonts-recommended
+sudo apt install pandoc
+pandoc [nom du fichier markdown].md -o [nom du fichier pdf à générer].pdf --toc -V geometry:margin=1in
\ No newline at end of file
diff --git a/diagrams/auth-diagram.puml b/Livrable/diagrams/auth-diagram.puml
similarity index 87%
rename from diagrams/auth-diagram.puml
rename to Livrable/diagrams/auth-diagram.puml
index 90b7398..21efd56 100644
--- a/diagrams/auth-diagram.puml
+++ b/Livrable/diagrams/auth-diagram.puml
@@ -1,6 +1,10 @@
@startuml
-title "Sequencial Diagram \n Authentification"
-
+title Sequencial Diagram\nAuthentification
+scale 0.5
+skinparam monochrome true
+skinparam shadowing false
+skinparam defaultFontName Arial
+skinparam linetype ortho
skinparam style strictuml
skinparam sequenceMessageAlign center
diff --git a/Livrable/diagrams/auth-diagram.svg b/Livrable/diagrams/auth-diagram.svg
new file mode 100644
index 0000000..2b10337
--- /dev/null
+++ b/Livrable/diagrams/auth-diagram.svg
@@ -0,0 +1,70 @@
+
\ No newline at end of file
diff --git a/Livrable/diagrams/bpmn-after-diagram.bpmn b/Livrable/diagrams/bpmn-after-diagram.bpmn
new file mode 100644
index 0000000..7fcc17e
--- /dev/null
+++ b/Livrable/diagrams/bpmn-after-diagram.bpmn
@@ -0,0 +1,646 @@
+
+
+
+
+
+
+
+
+
+
+
+ Activity_0dpaspu
+ Activity_0qeh398
+ Activity_093xwnx
+ Activity_0m61fnb
+ Activity_1dcz8s2
+ Activity_1fux38k
+ Activity_00eu04s
+ Activity_19f113s
+ Gateway_0khs5uj
+ Activity_165pyw1
+ Activity_0e0zkxc
+ Event_18yyuts
+ Activity_18bfk0c
+ Gateway_1qe14yf
+ Activity_127okf6
+ Activity_1dxkbqw
+ Gateway_12cbbt2
+ Gateway_1czvu7n
+ Activity_0p0v089
+ Activity_1xebvgp
+ Activity_03pdsld
+
+
+ Activity_0dpaspu
+ Activity_0qeh398
+ Activity_0m61fnb
+ Activity_1fux38k
+ Activity_00eu04s
+ Activity_165pyw1
+ Activity_0e0zkxc
+ Event_18yyuts
+ Gateway_12cbbt2
+ Gateway_1czvu7n
+ Activity_0p0v089
+ Activity_03pdsld
+
+
+ Activity_0dpaspu
+ Activity_0qeh398
+ Activity_0m61fnb
+ Activity_1fux38k
+ Activity_00eu04s
+ Activity_165pyw1
+ Activity_0e0zkxc
+ Event_18yyuts
+ Gateway_12cbbt2
+ Gateway_1czvu7n
+ Activity_0p0v089
+ Activity_03pdsld
+
+
+
+
+ Activity_093xwnx
+ Activity_1dcz8s2
+ Activity_19f113s
+ Gateway_0khs5uj
+ Activity_18bfk0c
+ Gateway_1qe14yf
+ Activity_127okf6
+ Activity_1dxkbqw
+ Activity_1xebvgp
+
+
+ Activity_093xwnx
+ Activity_1dcz8s2
+ Activity_19f113s
+ Gateway_0khs5uj
+ Activity_18bfk0c
+ Gateway_1qe14yf
+ Activity_127okf6
+ Activity_1dxkbqw
+ Activity_1xebvgp
+
+
+
+
+
+
+ Event_1h6yzyy
+ Gateway_0wp4z3s
+ Activity_1mywws0
+ Activity_0idlddy
+ Event_088sduf
+ Activity_0b9ngql
+ Activity_1gmbuql
+ Event_1he5joh
+
+
+ Event_1h6yzyy
+ Gateway_0wp4z3s
+ Activity_1mywws0
+ Activity_0idlddy
+ Event_088sduf
+ Activity_0b9ngql
+ Activity_1gmbuql
+ Event_1he5joh
+
+
+ Event_1h6yzyy
+ Gateway_0wp4z3s
+ Activity_1mywws0
+ Activity_0idlddy
+ Event_088sduf
+ Activity_0b9ngql
+ Activity_1gmbuql
+ Event_1he5joh
+
+
+
+
+
+
+
+ Flow_0tqrgl8
+ Flow_0gvuic6
+ Flow_0rlsafp
+
+
+ Flow_11qy4a3
+ Flow_0gvuic6
+
+
+ Flow_1thrgu2
+ Flow_1fkkjlf
+
+
+ Flow_18srkl3
+ Flow_1enud4a
+
+
+ Flow_0hk1oau
+ Flow_1a4wx38
+
+
+ Flow_1a4wx38
+ Flow_18srkl3
+
+
+ Flow_1cfvcd4
+
+
+ Flow_1veafjz
+ Flow_1s6mann
+ Flow_1fkkjlf
+ Flow_16jnbnx
+ Flow_0uxlsjr
+
+
+ Flow_0uxlsjr
+ Flow_1cfvcd4
+
+
+ Flow_0i50jsu
+ Flow_1veafjz
+
+
+ Flow_15lw4za
+ Flow_1s6mann
+
+
+ Flow_0mq6v4v
+ Flow_0i50jsu
+ Flow_15lw4za
+ Flow_1thrgu2
+ Flow_0v14q3e
+
+
+ Flow_0rlsafp
+ Flow_0gu13bk
+
+
+ Flow_0t5an5y
+ Flow_1vg43xc
+
+
+ Flow_1s0ets4
+ Flow_1p606x5
+
+
+
+ Flow_0g2g0ln
+ Flow_11qy4a3
+
+
+ Flow_1a9kmgh
+ Flow_0katfdb
+ Flow_0g2g0ln
+
+
+ Flow_0katfdb
+ Flow_0mq6v4v
+
+
+ Flow_1enud4a
+ Flow_1a9kmgh
+
+
+ Flow_1vg43xc
+ Flow_07fyk72
+
+
+ Flow_08cpx6d
+ Flow_0j008cs
+ Flow_0tqrgl8
+
+
+ Flow_0j008cs
+ Flow_07fyk72
+ Flow_0hk1oau
+ Flow_0t5an5y
+
+
+ Flow_1p606x5
+ Flow_108f4ql
+
+
+ Flow_108f4ql
+ Flow_08cpx6d
+
+
+ Flow_1f8vy1i
+
+
+
+
+ Flow_1f8vy1i
+ Flow_12txhya
+
+ DataObjectReference_1j3rxed
+
+
+
+ Flow_12txhya
+ Flow_1s0ets4
+
+
+ Flow_0gu13bk
+
+
+ Flow_0v14q3e
+ Flow_16jnbnx
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/Livrable/diagrams/bpmn-after-diagram.svg b/Livrable/diagrams/bpmn-after-diagram.svg
new file mode 100644
index 0000000..8b4107b
--- /dev/null
+++ b/Livrable/diagrams/bpmn-after-diagram.svg
@@ -0,0 +1,4 @@
+
+
+
+
\ No newline at end of file
diff --git a/Livrable/diagrams/bpmn-before-diagram.bpmn b/Livrable/diagrams/bpmn-before-diagram.bpmn
new file mode 100644
index 0000000..b720d7d
--- /dev/null
+++ b/Livrable/diagrams/bpmn-before-diagram.bpmn
@@ -0,0 +1,590 @@
+
+
+
+
+
+
+
+
+ Stocke l'historique d'impression avec les fichiers stl
+
+
+
+
+
+
+ Event_1g7jk24
+ Activity_02e9120
+ Activity_1rl57cf
+ Activity_0sxor2z
+ Activity_1riyu65
+ Gateway_1awjkog
+ Gateway_0ok16j5
+ Activity_1xcpqxg
+ Gateway_1bgpa7l
+ Event_113t3c3
+ Gateway_002zet6
+ Activity_03123sj
+
+
+ Event_1g7jk24
+ Activity_02e9120
+ Activity_1rl57cf
+ Activity_0sxor2z
+ Activity_1riyu65
+ Gateway_1awjkog
+ Gateway_0ok16j5
+ Activity_1xcpqxg
+ Gateway_1bgpa7l
+ Event_113t3c3
+ Gateway_002zet6
+ Activity_03123sj
+
+
+
+
+ Gateway_0yd61w6
+ Gateway_0ty28lf
+ Activity_1sbdp6r
+ Event_112zf02
+ Event_0s7mfu5
+ Activity_1sj5v2a
+ Activity_1rxh5wo
+ Gateway_0vcrxau
+ Event_16jwlwv
+ Event_02f503o
+ Gateway_19fnozy
+ Event_12h23ul
+ Activity_1jopk08
+ Event_17j4tcb
+ Activity_1kuksoq
+
+
+ Gateway_0yd61w6
+ Gateway_0ty28lf
+ Activity_1sbdp6r
+ Event_112zf02
+ Event_0s7mfu5
+ Activity_1sj5v2a
+ Activity_1rxh5wo
+ Gateway_0vcrxau
+ Event_16jwlwv
+ Event_02f503o
+ Gateway_19fnozy
+ Event_12h23ul
+ Activity_1jopk08
+ Event_17j4tcb
+ Activity_1kuksoq
+
+
+
+
+
+ Flow_1l54ezh
+
+
+ Flow_1l54ezh
+ Flow_0irrs2a
+
+ DataObjectReference_0ht5mdb
+
+
+
+
+
+ Flow_0irrs2a
+ Flow_0vojyl6
+
+ DataObjectReference_1mc76e4
+
+
+
+
+
+ Flow_0vojyl6
+ Flow_1vs9oiw
+
+ DataStoreReference_0o2nikv
+
+
+
+
+ Flow_1vs9oiw
+ Flow_12r2u93
+
+
+ Flow_12r2u93
+ Flow_05wg4rc
+ Flow_12m9k3r
+
+
+ Flow_05wg4rc
+ Flow_06ocrll
+ Flow_1d8ctse
+
+
+ Flow_0yh3euq
+ Flow_1d8ctse
+ Flow_0oqntxu
+
+
+ Flow_12m9k3r
+ Flow_0oqntxu
+ Flow_0ig3uqf
+
+
+ Flow_06ocrll
+ Flow_0labrkl
+
+
+ Flow_0labrkl
+ Flow_0yh3euq
+
+
+ Flow_0rwphor
+
+
+
+ Flow_0rwphor
+ Flow_0wdd5jh
+
+
+ Flow_0ig3uqf
+ Flow_0ynfn1g
+
+
+ Flow_0wdd5jh
+ Flow_09xxsc9
+ Flow_0xbjkzd
+
+
+ Flow_0xbjkzd
+ Flow_138zm0x
+ Flow_0j27l3a
+
+
+ Flow_0ynfn1g
+ Flow_1jhjqhw
+ Flow_1etiiob
+
+
+ Flow_1etiiob
+ Flow_1pkvgbt
+
+
+
+ Flow_1pkvgbt
+ Flow_1vhoqbl
+ Flow_1jhjqhw
+
+
+ Flow_1vhoqbl
+
+
+ Flow_0j27l3a
+ Flow_01icipk
+
+
+
+ Flow_138zm0x
+ Flow_0mlcyqz
+
+
+
+ Flow_01icipk
+ Flow_09xxsc9
+ Flow_0hawi0o
+
+
+ Flow_03m8ui3
+
+
+ Flow_0mlcyqz
+ Flow_1azu3lz
+
+
+ Flow_1azu3lz
+
+
+ Flow_0hawi0o
+ Flow_03m8ui3
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
diff --git a/Livrable/diagrams/bpmn-before-diagram.svg b/Livrable/diagrams/bpmn-before-diagram.svg
new file mode 100644
index 0000000..c875a52
--- /dev/null
+++ b/Livrable/diagrams/bpmn-before-diagram.svg
@@ -0,0 +1,4 @@
+
+
+
+
\ No newline at end of file
diff --git a/Livrable/diagrams/db-diagram.png b/Livrable/diagrams/db-diagram.png
new file mode 100644
index 0000000..3a553f2
Binary files /dev/null and b/Livrable/diagrams/db-diagram.png differ
diff --git a/Livrable/diagrams/db-diagram.puml b/Livrable/diagrams/db-diagram.puml
new file mode 100644
index 0000000..c851d82
--- /dev/null
+++ b/Livrable/diagrams/db-diagram.puml
@@ -0,0 +1,140 @@
+@startuml
+title UML Diagram\nDatabase Printech
+scale 1.4
+hide circle
+skinparam linetype ortho
+skinparam shadowing false
+skinparam roundcorner 10
+skinparam nodesep 80
+skinparam ranksep 80
+skinparam monochrome true
+skinparam backgroundColor white
+skinparam defaultFontName Segoe UI, Arial, sans-serif
+skinparam style strictuml
+
+package "User Environment" #DDDDDD {
+
+ enum UserRole <> {
+ ADHERENT
+ ROBOTECH
+ AUTOTECH
+ DRONE
+ BUREAU
+ }
+
+ enum RequestStatus <> {
+ SUBMITTED
+ AWAITING_PAYMENT
+ PENDING
+ PRINTING
+ AWAITING_PICKUP
+ PICKED_UP
+ FAILED
+ CANCELED
+ }
+
+ enum OperationType <> {
+ CASH
+ CARD
+ PAYMENT
+ REFUND
+ }
+
+ entity "User" as user {
+ *id : UUID <>
+ --
+ *username : varchar(150) <>
+ *email : varchar(254) <>
+ credit : integer = 0
+ role : UserRole = ADHERENT
+ profile_picture : varchar(100)
+ }
+
+ entity "File" as file {
+ *id : UUID <>
+ --
+ filament_id : Bigint <>
+ *path : varchar(100)
+ number_of_printing : integer = 1 {>= 0}
+ para_slicer : jsonb
+ }
+
+ entity "Request" as request {
+ *id : UUID <>
+ --
+ *user_id : UUID <>
+ file_id : UUID <>
+ printer_id : varchar(25) <>
+ price : integer = 0 {>= 0}
+ comment : text
+ *created_at : DateTime
+ status : RequestStatus = SUBMITTED
+ }
+
+ entity "Operation" as operation {
+ *id : UUID <>
+ --
+ *beneficiary_id : UUID <>
+ *agent_id : UUID <>
+ request_id : UUID <>
+ *operation_type : OperationType
+ *amount : integer = 0
+ comment : text
+ *created_at : DateTime
+ }
+}
+
+package "Material Assets" #DDDDDD {
+ entity "Printer" as printer {
+ *name : varchar(25) <>
+ --
+ status : PrinterStatus = DOWN
+ }
+
+ entity "Filament" as filament {
+ *id : Bigint <>
+ --
+ color : varchar(7) = '#ffffff'
+ *color_name : text
+ *type : FilamentType
+ quantity : integer = 0 {>= 0}
+ price : integer = 0 {>= 0}
+ }
+
+ enum FilamentType <> {
+ PLA
+ PETG
+ }
+
+ enum PrinterName <> {
+ CREALITY_K1C
+ SNAPMAKER_U1
+ PRUSA_MK3
+ }
+
+ enum PrinterStatus <> {
+ UP
+ DOWN
+ USED
+ }
+}
+
+' Relationships
+user ||--o{ request : "places"
+
+user ||--o{ operation : "agent"
+
+file ||--o{ request : "is printed in"
+filament ||-r-o{ file : "used by"
+printer ||-r-o{ request : "processes"
+request ||--o{ operation : "paid/refunded by"
+
+' Enum dependencies
+user ..> UserRole : uses
+request ..> RequestStatus : uses
+operation ..> OperationType : uses
+printer .u.> PrinterStatus : uses
+printer .l.> PrinterName : uses
+filament .l.> FilamentType : uses
+
+@enduml
\ No newline at end of file
diff --git a/Livrable/diagrams/db-diagram.svg b/Livrable/diagrams/db-diagram.svg
new file mode 100644
index 0000000..6548c25
--- /dev/null
+++ b/Livrable/diagrams/db-diagram.svg
@@ -0,0 +1,3 @@
+
+
\ No newline at end of file
diff --git a/Livrable/output.pdf b/Livrable/output.pdf
new file mode 100644
index 0000000..31506d1
Binary files /dev/null and b/Livrable/output.pdf differ
diff --git a/Livrable/output.tex b/Livrable/output.tex
new file mode 100644
index 0000000..c821340
--- /dev/null
+++ b/Livrable/output.tex
@@ -0,0 +1,964 @@
+\newpage
+
+\hypertarget{introduction}{%
+\section{1. Introduction}\label{introduction}}
+
+Depuis cette année, l'association INTech du campus rencontrait des
+difficultés de gestion des impressions 3D faites par les membres. En
+effet, depuis cette année, INTech offre aux membres du campus la
+possibilité d'imprimer leur modèle 3D en devenant adhérents suivant le
+processus décrit dans la figure 1.
+
+Le processus commence lorsqu'un étudiant trouve un modèle 3D, le renomme
+à son nom (au format \texttt{NOM-PRENOM.stl}) et remplit un Google Form
+pour s'enregistrer dans un tableur, avant de lancer l'impression. Si
+l'étudiant n'est pas présent à la fin du travail et que l'imprimante est
+requise pour une autre tâche, un opérateur de l'association retire la
+pièce et la stocke au local jusqu'au retour de l'étudiant qui vient
+ensuite la récupérer. À la fin du mois, la phase de facturation
+s'enclenche : l'opérateur consulte le tableur Google Sheets pour
+calculer le montant total dû, crée un lien de paiement sur
+\textbf{HelloAsso} et envoie la facture à l'étudiant. Si ce dernier paie
+dans les 7 jours, l'opérateur valide la transaction dans sa
+comptabilité, ce qui valide le succès du processus ; en revanche, s'il
+ne règle pas sa dette après plusieurs relances de 7 jours et que le
+plafond maximal d'avertissements est atteint, l'étudiant est inscrit sur
+liste noire, ce qui entraîne l'échec de la procédure.
+
+Actuellement, le système de gestion possède des problèmes. Les adhérents
+doivent télécharger et paramétrer un logiciel appelé slicer qui permet
+de transformer un modèle 3D en série d'instructions pour les imprimantes
+3D, appelé G-code. On demande ensuite aux adhérents de charger le G-code
+sur les imprimantes, de lancer les impressions et ensuite de remplir un
+Google Form avec le nom de leur fichier, le poids de l'impression et
+d'autres paramètres.
+
+Ce système implique beaucoup d'étapes manuelles qui peuvent mener à des
+erreurs et rendre la fraude facile. Il faut aussi former tout le monde
+qui devient adhérent à l'utilisation des imprimantes.
+
+\begin{figure}
+\centering
+\includesvg{diagrams/bpmn-before-diagram.svg}
+\caption{Diagramme BPMN du fonctionnement pré-PrIntech}
+\end{figure}
+
+Intervient alors le projet PrINTech consistant au développement d'une
+application web dynamique qui permette une gestion des impressions 3D de
+manière automatique.
+
+Contrairement à la solution existante, ce projet a une vision plus long
+terme et facilite l'expansion à plus d'imprimantes ou de personnes et
+permet de réduire la charge de travail du bureau.
+
+\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
+
+\newpage
+
+\hypertarget{terminologie}{%
+\subsection{1.1. Terminologie}\label{terminologie}}
+
+Pour faciliter la lecture de ce rapport, cette section regroupe et
+définit les termes techniques, les acronymes et les notions spécifiques
+au domaine de l'impression 3D et du développement web abordés dans ce
+document.
+
+\hypertarget{impression-3d-et-matuxe9riaux}{%
+\subsubsection{Impression 3D et
+Matériaux}\label{impression-3d-et-matuxe9riaux}}
+
+\begin{itemize}
+\tightlist
+\item
+ \textbf{Fichier STL (\texttt{.stl})} : Format de fichier standard en
+ impression 3D (Stéréolithographie). Il représente la géométrie de la
+ surface d'un objet 3D sous forme de triangles.
+\item
+ \textbf{Slicer (Trancheur)} : Logiciel qui découpe un modèle 3D
+ virtuel en fines couches horizontales et génère les instructions
+ nécessaires à l'imprimante.
+\item
+ \textbf{G-code} : Langage de programmation numérique universel utilisé
+ pour piloter les machines-outils et les imprimantes 3D.
+\item
+ \textbf{Filament} : Le fil de plastique en bobine qui sert de
+ ``matière première'' à l'imprimante 3D pour fabriquer les objets.
+\item
+ \textbf{PETG} : Un type de plastique très résistant (le même que celui
+ des bouteilles d'eau, mais modifié), souvent utilisé pour des pièces
+ qui doivent supporter des chocs ou rester en extérieur.
+\item
+ \textbf{PLA (Acide Polylactique)} : Plastique d'origine végétale
+ couramment utilisé en impression 3D.
+\item
+ \textbf{Supports} : Structures temporaires imprimées en même temps que
+ le modèle.
+\end{itemize}
+
+\hypertarget{technologies-web-architecture}{%
+\subsubsection{Technologies Web \&
+Architecture}\label{technologies-web-architecture}}
+
+\begin{itemize}
+\tightlist
+\item
+ \textbf{Angular} : Framework côté client (Frontend) utilisé pour
+ concevoir une interface utilisateur dynamique.
+\item
+ \textbf{Django} : Framework de haut niveau basé sur Python, utilisé
+ pour le développement de la logique métier (Backend).
+\item
+ \textbf{API REST} : Style d'architecture logicielle permettant au
+ Frontend et au Backend de communiquer via le protocole HTTP.
+\item
+ \textbf{PostgreSQL} : Système de gestion de base de données
+ relationnelle open-source.
+\item
+ \textbf{Docker \& Conteneurisation} : Technologie permettant d'isoler
+ une application et ses dépendances dans un environnement virtuel
+ appelé ``conteneur''.
+\item
+ \textbf{Nginx \& Gunicorn} : Duo de production où Nginx sert de
+ serveur proxy inverse et Gunicorn de serveur d'application WSGI pour
+ exécuter le code Python.
+\end{itemize}
+
+\hypertarget{outils-de-duxe9veloppement-tests}{%
+\subsubsection{Outils de Développement \&
+Tests}\label{outils-de-duxe9veloppement-tests}}
+
+\begin{itemize}
+\tightlist
+\item
+ \textbf{Git / Git Flow} : Git est le système de contrôle de version ;
+ Git Flow est la méthodologie qui structure la collaboration (branches
+ \texttt{main}, \texttt{develop}, \texttt{features/}).
+\item
+ \textbf{PR (Pull Request)} : Demande formelle de fusion de code
+ soumise par un développeur pour relecture et validation.
+\item
+ \textbf{uv} : Gestionnaire de paquets et d'environnements Python
+ extrêmement rapide écrit en Rust.
+\item
+ \textbf{Playwright} : Framework de test de bout en bout (E2E)
+ permettant de simuler le comportement d'un utilisateur réel.
+\end{itemize}
+
+\newpage
+
+\hypertarget{cahier-des-charges}{%
+\section{2. Cahier des charges}\label{cahier-des-charges}}
+
+À la suite des rapports et des échanges menés avec le bureau et les
+membres actifs de l'association INTech, une analyse approfondie des
+besoins opérationnels a été réalisée. Le constat est simple : le volume
+croissant de demandes d'impression 3D sur le campus sature le modèle de
+gestion actuel, basé sur des processus manuels et des outils tiers
+(Google Forms, tableurs Sheets).
+
+\hypertarget{description-du-sujet}{%
+\subsection{2.1. Description du sujet}\label{description-du-sujet}}
+
+Notre projet consiste en la réalisation d'une Application Web dynamique.
+C'est-à-dire que le site doit être capable d'intéragir avec une base de
+donnée qu'on doit aussi implémenter. Ce site web permettra alors
+l'identification sécurisé des étudiants voulant imprimer des modèles 3D
+avec un système de gestion d'utilisateurs, de requêtes, et de gestion de
+queues. Cette plateforme aura pour objectifs principaux :
+
+\begin{itemize}
+\tightlist
+\item
+ \textbf{L'authentification sécurisée} des étudiants du campus
+ souhaitant utiliser les services d'impression 3D.
+\item
+ \textbf{La gestion des utilisateurs} en distinguant les rôles
+ (adhérents, bureau, membre d'un projet) et leurs droits associés.
+\item
+ \textbf{Le traitement des requêtes} afin de centraliser, suivre et
+ historiser toutes les demandes de fabrication soumises par les élèves.
+\item
+ \textbf{La gestion des crédits et de la tarification} afin de
+ permettre de payer chaque impression
+\item
+ \textbf{Espace administrateur} Interface d'administration pour une
+ gestion complète
+\end{itemize}
+
+\newpage
+
+\hypertarget{liste-des-fonctionnalituxe9s-de-lapplication}{%
+\subsection{2.2. Liste des fonctionnalités de
+l'application}\label{liste-des-fonctionnalituxe9s-de-lapplication}}
+
+Afin de répondre au sujet, l'application doit intégrer les
+fonctionnalités suivantes, classées par priorité de développement :
+
+\begin{longtable}[]{@{}
+ >{\raggedright\arraybackslash}p{(\columnwidth - 6\tabcolsep) * \real{0.0870}}
+ >{\raggedright\arraybackslash}p{(\columnwidth - 6\tabcolsep) * \real{0.3261}}
+ >{\raggedright\arraybackslash}p{(\columnwidth - 6\tabcolsep) * \real{0.4783}}
+ >{\centering\arraybackslash}p{(\columnwidth - 6\tabcolsep) * \real{0.1087}}@{}}
+\toprule\noalign{}
+\begin{minipage}[b]{\linewidth}\raggedright
+ID
+\end{minipage} & \begin{minipage}[b]{\linewidth}\raggedright
+Fonctionnalité de l'application
+\end{minipage} & \begin{minipage}[b]{\linewidth}\raggedright
+Description technique
+\end{minipage} & \begin{minipage}[b]{\linewidth}\centering
+Priorité
+\end{minipage} \\
+\midrule\noalign{}
+\endhead
+\bottomrule\noalign{}
+\endlastfoot
+\textbf{F01} & \textbf{Authentification} & Connexion et déconnexion. &
+Haute \\
+\textbf{F02} & \textbf{Gestion des profils} & Affichage et modification
+des informations utilisateurs. & Basse \\
+\textbf{F03} & \textbf{Gestion des impressions} & Flux complet
+d'impression 3D, du dépôt STL à la mise en file. & Haute \\
+\textbf{F03-1} & \textbf{Déposer un STL} & Upload d'un fichier STL. &
+Haute \\
+\textbf{F03-2} & \textbf{Slicer automatique} & Convertir le modèle en
+G-code via un slicer. & Moyenne \\
+\textbf{F03-3} & \textbf{Estimation du coût} & Calculer le prix
+d'impression à partir des paramètres. & Basse \\
+\textbf{F03-4} & \textbf{Position dans la file} & Afficher la place du
+travail dans la file. & Basse \\
+\textbf{F03-5} & \textbf{Priorité projets INTech} & Chaque utilisateur à
+un rôle (adhérents, bureau, membre d'un projet) pour priiser les
+impressions. & Basse \\
+\textbf{F03-6} & \textbf{Crédit restant} & Afficher le crédit restant
+d'un utilisateur. & Basse \\
+\textbf{F03-7} & \textbf{Quantité d'impressions} & Indiquer le nombre
+d'exemplaires à imprimer. & Basse \\
+\textbf{F04} & \textbf{Espace administrateur} & Interface
+d'administration pour une gestion complète. & Moyenne \\
+\textbf{F04-1} & \textbf{Gestion des utilisateurs} & Créer, modifier et
+supprimer les utilisateurs. & Haute \\
+\textbf{F04-2} & \textbf{Gestion des travaux} & Créer, modifier et
+supprimer la file de travaux. & Moyenne \\
+\textbf{F04-3} & \textbf{Reprise des erreurs} & Déclarer un travail en
+erreur et le remettre en file. & Moyenne \\
+\textbf{F04-4} & \textbf{Gestion crédit} & Gestion des crédits des
+utilisateurs dont la recharge de crédits. & Haute \\
+\textbf{F05} & \textbf{Intégrations} & SSO et notifications externes. &
+Pour aller plus loin \\
+\textbf{F05-1} & \textbf{Intégration CAS} & Inscription et connexion via
+le CAS de l'école. & Pour aller plus loin \\
+\textbf{F05-2} & \textbf{Intégration Discord} & Utiliser des webhooks
+pour les notifications. & Pour aller plus loin \\
+\textbf{F05-3} & \textbf{Intégration HelloAsso} & Créditer les comptes
+via HelloAsso. & Pour aller plus loin \\
+\textbf{F06} & \textbf{Impression technique} & Options avancées
+d'impression. & Pour aller plus loin \\
+\textbf{F06-1} & \textbf{Utilisation de supports} & Détecter quand
+l'utilisation de supports est nécessaire. & Pour aller plus loin \\
+\textbf{F06-2} & \textbf{Paramétrage du slicer} & Permettre l'upload
+d'un JSON de paramètres. & Pour aller plus loin \\
+\textbf{F06-3} & \textbf{Choix des matériaux} & Choisir un plastique
+autre que le PLA. & Pour aller plus loin \\
+\textbf{F07} & \textbf{Gestion des filaments} & Administration des
+filaments et du stock. & Pour aller plus loin \\
+\textbf{F07-1} & \textbf{Activation des filaments} & Activer et
+désactiver des filaments. & Pour aller plus loin \\
+\textbf{F07-2} & \textbf{Gestion des filament} & Gérer la quantité de
+filament restant. & Pour aller plus loin \\
+\textbf{F07-3} & \textbf{Gestion de consommation} & Rapport sur
+quantités, crédits et montant imprimé. & Pour aller plus loin \\
+\end{longtable}
+
+\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
+
+\newpage
+
+\hypertarget{conception}{%
+\section{3. Conception}\label{conception}}
+
+\hypertarget{base-de-donnuxe9es}{%
+\subsection{3.1. Base de données}\label{base-de-donnuxe9es}}
+
+Comme l'illustre ce schema, lorsqu'un User (caractérisé par un rôle
+applicatif et un solde de crédits) souhaite fabriquer un objet, il émet
+une demande d'impression (Request). Celle-ci encapsule un fichier
+numérique (File) contenant le modèle 3D et ses paramètres de découpage
+en format JSON (para\_slicer), lui-même associé à un consommable précis
+(Filament) défini par son type (PLA ou PETG) et sa couleur. La demande
+est ensuite affectée à une machine (Printer) identifiée par son modèle
+et son état de disponibilité. Enfin, pour éradiquer les risques de
+fraude et automatiser la comptabilité, chaque transaction (recharge de
+compte par carte/espèces ou débit/remboursement lié à une impression)
+est tracée par l'entité Operation. Cette table lie un agent du bureau à
+un utilisateur bénéficiaire tout en restant historiquement connectée à
+la Request d'origine.
+
+\begin{figure}
+\centering
+\includesvg{diagrams/db-diagram.svg}
+\caption{Schema de base de données}
+\end{figure}
+
+\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
+
+\newpage
+
+\hypertarget{suxe9quence-de-lauthentification}{%
+\subsection{3.2. Séquence de
+l'Authentification}\label{suxe9quence-de-lauthentification}}
+
+Pour sécuriser l'accès aux ressources de la plateforme et garantir que
+chaque étudiant interagit uniquement avec ses propres données, le projet
+implémente un flux d'authentification basé sur des jetons d'accès (JWT)
+via la librairie Django REST Framework SimpleJWT. Ce mécanisme élimine
+les failles de sécurité de l'ancien système et permet une communication
+fluide entre le Frontend Angular et l'API Backend.
+
+Le diagramme de séquence suivant détaille les phases d'inscription, de
+connexion et de renouvellement des jetons :
+
+\begin{figure}
+\centering
+\includesvg{diagrams/auth-diagram.svg}
+\caption{Schema de l'authentification}
+\end{figure}
+
+\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
+
+\newpage
+
+\hypertarget{processus-dimpression-3d-avec-printech}{%
+\subsection{3.3. Processus d'impression 3D avec
+PrIntech}\label{processus-dimpression-3d-avec-printech}}
+
+\hypertarget{description-du-processus-dimpression-3d}{%
+\subsubsection{Description du processus d'impression
+3D}\label{description-du-processus-dimpression-3d}}
+
+Le processus débute lorsqu'un étudiant dépose un modèle 3D sur la
+plateforme (\textbf{F03-1 : Déposer un STL}). Une fois la requête
+enregistrée dans l'interface d'administration (\textbf{F04-2 : Gestion
+des travaux}), le système évalue automatiquement les ressources
+nécessaires. Il vérifie d'une part la quantité de matière disponible
+(\textbf{F07-2 : Gestion des filaments}) et d'autre part le montant
+estimé de l'impression (\textbf{F03-3 : Estimation du coût}) par rapport
+aux ressources financières de l'utilisateur (\textbf{F03-6 : Crédit
+restant}). Si le plastique est manquant ou indisponible, la demande est
+arrêtée. Si l'utilisateur ne dispose pas de fonds suffisants,
+l'application le redirige vers le module externe afin de renflouer son
+compte (\textbf{F05-3 : Intégration HelloAsso}).
+
+Dès que ces vérifications sont validées, le travail rejoint la file
+d'attente informatique et l'opérateur lui attribue une machine
+disponible (\textbf{F04-2 : Gestion des travaux}), tout en prenant en
+compte le rôle de l'utilisateur (\textbf{F03-5 : Priorité projets
+INTech}). L'application procède alors au prélèvement des fonds requis
+sur le compte de l'étudiant (\textbf{F04-4 : Gestion crédit}), met à
+jour le statut informatique de l'imprimante, et l'opérateur lance
+physiquement la fabrication de la pièce (\textbf{F03 : Gestion des
+impressions}). À la fin du cycle, deux situations peuvent se présenter :
+* \textbf{En cas de succès :} l'opérateur valide la fin de la tâche
+(\textbf{F04-2 : Gestion des travaux}), l'imprimante repasse
+informatiquement à l'état disponible, le stock de plastique restant est
+ajusté (\textbf{F07-2 : Gestion des filaments}) et une alerte
+automatisée est envoyée à l'étudiant (\textbf{F05-2 : Intégration
+Discord}) pour qu'il vienne récupérer sa pièce. * \textbf{En cas d'échec
+:} l'opérateur déclare l'avarie sur l'interface (\textbf{F04-3 : Reprise
+des erreurs}), libérant immédiatement la machine. Le système réajuste
+alors automatiquement le solde de l'étudiant (\textbf{F04-4 : Gestion
+crédit}) tout en envoyant une notification pour l'avertir du problème
+(\textbf{F05-2 : Intégration Discord}).
+
+\begin{figure}
+\centering
+\includesvg{diagrams/bpmn-after-diagram.svg}
+\caption{Diagramme BPMN du fonctionnement post-PrIntech}
+\end{figure}
+
+\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
+
+\newpage
+
+\hypertarget{ruxe9alisation-et-choix-techniques}{%
+\section{4. Réalisation et choix
+techniques}\label{ruxe9alisation-et-choix-techniques}}
+
+\hypertarget{choix-des-technologies}{%
+\subsection{4.1. Choix des technologies}\label{choix-des-technologies}}
+
+Les technologies pour développer une Application Web sont nombreuses.
+Pour faire la sélection des technologies, nous avons d'abord examiné
+lesquelles étaient capables de répondre à notre cahier des charges, puis
+ensuite sur les technologies auxquelles les membres de notre équipe
+avaient déjà de l'expérience. Sur la base de ces critères, nous avons
+sélectionné le stack suivant. D'abord pour le frontend :
+
+\begin{itemize}
+\tightlist
+\item
+ \textbf{Angular} : Pour la réalisation de l'interface utilisateur.
+ Angular s'appuie sur l'architecture de composants et sur le langage
+ \textbf{TypeScript}. Ce choix apporte un typage fort, une structure
+ rigoureuse.
+\end{itemize}
+
+Ensuite pour le backend :
+
+\begin{itemize}
+\item
+ \textbf{Django (Python)} : Utilisé pour développer le cœur logique du
+ backend et l'API REST (via \emph{Django REST Framework}).
+\item
+ \textbf{uv} : Afin de gérer nos librairies et versions de python, on a
+ utilisé uv. C'est un équivalent de poetry mais en plus optimisé car
+ implémenté en Rust. On doit alors préciser avant chaque commande ``uv
+ run'' afin que le processus passe bien par uv.
+\item
+ \textbf{Swagger (OpenAPI)} : Intégré à notre backend pour la
+ documentation et le test de l'API REST. Swagger génère automatiquement
+ une interface web interactive à partir des routes de notre application
+ Django. Cela permet aux développeurs frontend de comprendre
+ instantanément les points de terminaison (\emph{endpoints}), les
+ paramètres attendus et les réponses de l'API, facilitant ainsi
+ grandement la communication et l'intégration entre le frontend et le
+ backend.
+\item
+ \textbf{PostgreSQL} : Ce système de gestion de base de données
+ relationnelle (SGBDR) open-source a été retenu pour sa robustesse, sa
+ conformité ACID et sa gestion fine des transactions financières
+ (crédits, remboursements, opérations). Sa capacité à indexer
+ efficacement les données structurées garantit des performances
+ optimales lors de la montée en charge du système et du suivi des files
+ d'attente de travaux.
+\item
+ \textbf{Klipper} : comme firmware des imprimantes. Ce firmware
+ communautaire vient remplacer celui du constructeur
+\item
+ \textbf{Moonraker} : expose les API JSON-RPC de Klipper avec une API
+ REST
+\item
+ \textbf{FDM Monster} Cet orchestrateur open-source centralise la
+ gestion d'une flotte d'imprimantes 3D. Connecté aux différentes
+ instances Moonraker, il permet de piloter le parc, de centraliser le
+ contrôle des machines et de gérer globalement les files d'attente
+ d'impression.
+\end{itemize}
+
+\hypertarget{tests-validation-et-qualituxe9-logicielle}{%
+\subsubsection{Tests, Validation et Qualité
+Logicielle}\label{tests-validation-et-qualituxe9-logicielle}}
+
+\begin{itemize}
+\tightlist
+\item
+ \textbf{Tests natifs Django (TestCase)} : Intégrés directement au
+ backend, le framework de test unitaire et d'intégration natif de
+ Django permet de sécuriser l'intégrité de la base de données lors des
+ transactions critiques. Ils valident de manière isolée les calculs de
+ prix, l'exactitude des débits et remboursements de crédits, le respect
+ des rôles utilisateurs pour la gestion des priorités, ainsi que les
+ transitions de statut des requêtes d'impression (du dépôt initial
+ jusqu'à la mise en file).
+\item
+ \textbf{Playwright} : Framework moderne retenu pour l'automatisation
+ des tests de bout en bout (\emph{End-to-End}). Complémentaire aux
+ tests Django, Playwright nous permet de simuler le parcours complet
+ d'un utilisateur sur un navigateur réel de manière isolée.
+\end{itemize}
+
+\hypertarget{conteneurisation-et-infrastructure}{%
+\subsubsection{Conteneurisation et
+Infrastructure}\label{conteneurisation-et-infrastructure}}
+
+\begin{itemize}
+\tightlist
+\item
+ \textbf{Docker \& Docker Compose} : Afin de partitionner logiquement
+ les différentes couches applicatives (Frontend, Backend, Base de
+ données), nous avons conteneurisé chaque service. Technologie
+ incontournable dans le milieu professionnel, Docker garantit que
+ l'application s'exécute de manière strictement identique sur les
+ machines de développement des développeurs et sur le serveur de
+ production, simplifiant ainsi drastiquement la configuration de
+ l'infrastructure.
+\item
+ \textbf{Nginx \& Gunicorn} : Pour le déploiement en production,
+ \textbf{Gunicorn} fait office de serveur d'application WSGI, chargé
+ d'exécuter le code Python/Django en gérant efficacement les requêtes
+ concurrentes via un système de processus de travail (\emph{workers}).
+ Il est placé derrière \textbf{Nginx}, configuré comme un proxy inverse
+ (\emph{reverse proxy}). Nginx assure la sécurité globale, gère les
+ certificats SSL/TLS (HTTPS), sert directement les fichiers statiques
+ et médias lourds (comme les fichiers STL stockés), et distribue la
+ charge vers l'application backend.
+\end{itemize}
+
+\hypertarget{outils-de-duxe9veloppement-et-de-collaboration}{%
+\subsubsection{Outils de développement et de
+collaboration}\label{outils-de-duxe9veloppement-et-de-collaboration}}
+
+\begin{itemize}
+\tightlist
+\item
+ \textbf{Visual Studio Code (VS Code)} : Choisi comme environnement de
+ développement intégré (IDE) principal par l'équipe. Il offre une
+ intégration native de Git, et des extensions pour Python/Django et
+ Angular.
+\item
+ \textbf{Git \& GitFlow} : Pour la gestion de version, nous utilisons
+ \textbf{Git} hébergé sur \textbf{GitHub}. Afin d'organiser le travail
+ collaboratif de l'équipe sans bloquer la production, nous appliquons
+ la méthodologie \textbf{GitFlow}. Cette approche structure notre dépôt
+ en plusieurs branches strictes : \texttt{main} pour les versions
+ stables, \texttt{develop} pour centraliser les fonctionnalités prêtes,
+ et des branches \texttt{feature/} isolées pour chaque développeur.
+\item
+ \textbf{Discord \& Webhooks GitHub} : Discord est notre outil central
+ de communication d'équipe. Pour automatiser notre suivi de projet,
+ nous y avons configuré des \textbf{webhooks GitHub}. À chaque fois
+ qu'un développeur pousse du code (\emph{push}), ouvre une demande de
+ fusion (\emph{pull request}) , une notification automatique est
+ envoyée dans un salon dédié sur Discord. Cela permet un suivi de
+ l'avancement facile.
+\end{itemize}
+
+\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
+
+\newpage
+
+\hypertarget{ruxe9alisation}{%
+\subsection{4.2. Réalisation}\label{ruxe9alisation}}
+
+Pour la conteneurisation, il a fallu créer les conteneurs. Pour se
+faire, il faut configurer un fichier ``docker-compose.yaml'' afin qu'il
+créer un conteneur PostgreSQL configuré sur le bon port après la
+commande.
+
+Enfin pour la mise en commun du code, on a utilisé Git, et plus
+particulièrement git flow qui permet de produire simplement un cadre de
+travail professionnel (avec les branches main, develop,
+features/\ldots{} etc.) et des commandes qui facilitent son utilisation.
+
+Afin de valider l'expérience utilisateur et de documenter le rendu final
+de notre application PrIntech, cette section présente les principales
+interfaces développées. Les captures d'écran sont structurées selon les
+deux grands espaces de la plateforme : l'espace adhérent (client) et
+l'espace d'administration (opérateur).
+
+\hypertarget{espace-utilisateur-et-authentification}{%
+\subsubsection{4.2.1. Espace Utilisateur et
+Authentification}\label{espace-utilisateur-et-authentification}}
+
+Cet espace regroupe les écrans accessibles par les étudiants du campus
+pour gérer leur compte et soumettre leurs impressions.
+
+\begin{itemize}
+\item
+ \textbf{Interface de Connexion}
+ \includegraphics{screenshots/login.png}\\
+ Cette interface épurée permet l'authentification sécurisée des
+ utilisateurs (Fonctionnalité \textbf{F01}).
+\item
+ \textbf{Page d'Accueil} \includegraphics{screenshots/home.png}\\
+ Le tableau de bord principal de l'étudiant. Il offre une vue
+ d'ensemble claire sur ses activités courantes, son solde mis en valeur
+ (Fonctionnalité \textbf{F03-6 : Crédit restant}).
+\item
+ \textbf{Dépôt d'une demande d'impression}
+ \includegraphics{screenshots/request.png}\\
+ Formulaire intuitif dédié au dépôt des fichiers 3D (Fonctionnalité
+ \textbf{F03-1 : Déposer un STL}). L'étudiant peut y téléverser son
+ modèle, spécifier la quantité d'exemplaires souhaitée (\textbf{F03-7})
+ ainsi que le choix des matériaux avant l'envoi au serveur.
+\item
+ \textbf{Historique des travaux}
+ \includegraphics{screenshots/historique.png}\\
+ Cette vue liste l'intégralité des commandes passées par l'étudiant.
+ (\textbf{F03-4 : Position dans la file}).
+\end{itemize}
+
+\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
+
+\hypertarget{espace-administration-et-gestion-des-opuxe9rations}{%
+\subsubsection{4.2.2. Espace Administration et Gestion des
+Opérations}\label{espace-administration-et-gestion-des-opuxe9rations}}
+
+Réservé aux membres du bureau et aux opérateurs de l'association INTech
+(Fonctionnalité \textbf{F04}), cet espace permet un pilotage complet du
+service et du parc matériel.
+
+\begin{itemize}
+\item
+ \textbf{Gestion de la file des travaux}
+ \includegraphics{screenshots/admin-requests.png}\\
+ Interface maîtresse de l'opérateur (Fonctionnalité \textbf{F04-2 :
+ Gestion des travaux}). Elle centralise les fichiers \texttt{.stl}
+ soumis, permet d'assigner manuellement ou automatiquement une
+ imprimante libre et d'appliquer la tarification calculée.
+\item
+ \textbf{Suivi du parc d'imprimantes}
+ \includegraphics{screenshots/admin-printers.png}\\
+ Écran de supervision du statut des machines connectées.
+ L'administrateur peut visualiser instantanément quelles machines sont
+ disponibles (\texttt{UP}), occupées (\texttt{USED}) ou hors service
+ (\texttt{DOWN}).
+\item
+ \textbf{Gestion des stocks de consommables}
+ \includegraphics{screenshots/admin-filaments.png}\\
+ Vue dédiée au contrôle des stocks de plastique (Fonctionnalité
+ \textbf{F07 : Gestion des filaments}). Elle permet d'enregistrer les
+ nouvelles bobines, de surveiller la quantité de matière restante en
+ grammes (\textbf{F07-2}).
+\item
+ \textbf{Suivi financier et des transactions}
+ \includegraphics{screenshots/admin-operations.png}\\
+ Historique financier de la plateforme (Fonctionnalité \textbf{F04-4 :
+ Gestion crédit}). Cet écran liste de manière chronologique tous les
+ débits, les rechargements HelloAsso fructueux ainsi que les
+ remboursements automatiques émis suite à une erreur d'impression.
+\item
+ \textbf{Administration des comptes utilisateurs}
+ \includegraphics{screenshots/admin-users.png}\\
+ Interface de modération des profils (Fonctionnalité \textbf{F04-1}).
+ Elle permet également de modifier les rôles (adhérents, bureau, membre
+ projet) (\textbf{F03-5}). ---
+\end{itemize}
+
+\newpage
+
+\hypertarget{validation-et-tests}{%
+\section{5. Validation et tests}\label{validation-et-tests}}
+
+Pour garantir la robustesse de l'application PrINTech, nous avons mis en
+place une stratégie de tests automatisés. L'effort principal a été
+concentré sur la validation fonctionnelle du backend (Django), complété
+par des mécanismes de tests d'intégration et d'interface (Playwright).
+
+\hypertarget{tests-backend-django}{%
+\subsection{5.1. Tests Backend (Django)}\label{tests-backend-django}}
+
+Le backend constituant le cœur logique et financier de notre application
+(notamment avec la gestion du crédit des utilisateurs), nous avons conçu
+une suite de nombreux tests unitaires et d'intégration rigoureuse à
+l'aide du framework de test de \emph{Django REST Framework}
+(\texttt{APITestCase}). Les tests se trouvent dans le fichier
+\texttt{PrINTech-Back/back/apps/api/tests.py}
+
+\hypertarget{exemples}{%
+\subsubsection{5.1.1. Exemples:}\label{exemples}}
+
+Une attention particulière a été portée à la sécurité et à l'étanchéité
+des droits entre les utilisateurs réguliers et les administrateurs du
+bureau INTech. \textbf{Accès aux ressources critiques} : Nous testons
+systématiquement qu'un utilisateur standard reçoit une erreur
+\texttt{HTTP\_403\_FORBIDDEN} lorsqu'il tente de modifier l'état d'une
+imprimante (endpoint \texttt{admin-detail}), alors qu'un jeton
+d'administrateur valide la requête avec un statut
+\texttt{HTTP\_200\_OK}.
+
+\textbf{Calcul automatique de la consommation} : Les tests valident que
+l'API calcule correctement le poids total de plastique consommé en
+multipliant le nombre d'impressions demandées par le poids unitaire de
+la pièce.
+
+\textbf{Débit du solde utilisateur} : Nous nous assurons qu'à la
+soumission d'un fichier STL valide, le crédit de l'étudiant est
+immédiatement débité au prorata de la quantité et du type de filament
+choisi (ex: passage d'une balance initiale de 100 unités à une valeur
+calculée résiduelle).
+
+\textbf{Isolation des requêtes} : Nos cas de tests
+(\texttt{test\_user\_can\_only\_see\_their\_own\_requests}) certifient
+qu'un utilisateur connecté ne peut en aucun cas interroger ou lister les
+fichiers et demandes d'un autre étudiant, prévenant ainsi toute fuite de
+données.
+
+\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
+
+\hypertarget{tests-dinterface-playwright-et-validation-frontend}{%
+\subsection{5.2. Tests d'Interface (Playwright) et Validation
+Frontend}\label{tests-dinterface-playwright-et-validation-frontend}}
+
+Pour la partie émergée de l'iceberg (le Frontend), l'objectif initial
+intégrait le déploiement de tests de bout en bout (E2E) via l'outil
+\textbf{Playwright}.
+
+Cependant, comme évoqué dans notre bilan de projet (Section 6.1.3), le
+retard accumulé sur l'apprentissage d'Angular et la complexité de
+l'interfaçage asynchrone ont limité la couverture finale de ces tests
+E2E.
+
+\newpage
+
+\hypertarget{bilan-du-projet}{%
+\section{6. Bilan du projet}\label{bilan-du-projet}}
+
+\hypertarget{plannings}{%
+\subsection{6.1. Plannings}\label{plannings}}
+
+On a eu de nombreux retards sur le projet, notamment à cause de la
+participation de certains membres de notre équipe à la coupe de France
+de Robotique dans le cadre du GATE. On a également sous-estimé la
+difficulté d'apprentissage des technologies utilisés (Angular et
+Django). On était pas tous capable de faire à la fois du frontend et du
+backend ce qui a crée des complications. De plus Arnaud qui était censé
+implémenté la communication avec les imprimantes n'a pas réussi ce qui a
+fortement limité le projet.
+
+\hypertarget{planning-pruxe9visionnel}{%
+\subsubsection{6.1.1. Planning
+prévisionnel}\label{planning-pruxe9visionnel}}
+
+\begin{figure}
+\centering
+\includegraphics{planning-previsionnel.pdf}
+\caption{Planning prévisionnel du projet PrIntech}
+\end{figure}
+
+\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
+
+\newpage
+
+\hypertarget{planning-final}{%
+\subsubsection{6.1.2. Planning final}\label{planning-final}}
+
+\begin{figure}
+\centering
+\includegraphics{planning-final.pdf}
+\caption{Planning final du projet PrIntech}
+\end{figure}
+
+\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
+
+\newpage
+
+\hypertarget{commentaires}{%
+\subsubsection{6.1.3. Commentaires}\label{commentaires}}
+
+\begin{itemize}
+\item
+ \textbf{Choix du planning prévisionnel} :
+
+ \begin{itemize}
+ \tightlist
+ \item
+ Angular est appris en parallele du projet. Le dev front ne commence
+ qu'en fevrier.
+ \item
+ Django est maitrise -\textgreater{} execution rapide. La partie
+ Moonraker/Klipper est la plus incertaine.
+ \item
+ la phase 3 est la plus longue a cause de l'apprentissage en cours.
+ \end{itemize}
+\item
+ \textbf{Comparaison au planning réel} :
+
+ \begin{itemize}
+ \tightlist
+ \item
+ le projet a accumulé du retard notamment en raison d'autres dates
+ importantes comme les projets Gate ou bien les partiels mais aussi
+ car on a sous-estimé la complexité de certaines taches que nous
+ verrons plus bas.
+ \item
+ en réponse, on a ré-évalué le périmètre de notre projet afin d'en
+ inclure à la date du rendu que les fonctionnalités nécessaires au vu
+ du cahier des charges (Pas de tests e2e pour l'instant)
+ \item
+ Ce retard n'est pas une fatalité puisque compte tenu de l'utilité du
+ projet, celui-ci sera poursuivi à bien au-delà de la date de rendu.
+ \end{itemize}
+\end{itemize}
+
+\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
+
+\newpage
+
+\hypertarget{plan-de-charges}{%
+\subsection{6.2. Plan de charges}\label{plan-de-charges}}
+
+L'écart le plus marquant entre notre planification et la réalité réside
+dans la courbe d'apprentissage des technologies choisies (Angular et
+Django), qui s'est révélée bien plus longue et abrupte que prévu.
+N'ayant pas de compétences approfondies préalables sur ces frameworks,
+l'assimilation de concepts a pris plus de temps que prévu.
+
+\hypertarget{plan-de-charges-pruxe9visionnel-et-final}{%
+\subsubsection{6.2.1. Plan de charges prévisionnel et
+final}\label{plan-de-charges-pruxe9visionnel-et-final}}
+
+\begin{figure}
+\centering
+\includegraphics{planChargeSuiviActivites.png}
+\caption{Plan de Charge}
+\end{figure}
+
+\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
+
+\newpage
+
+\hypertarget{commentaires-1}{%
+\subsubsection{6.2.3. Commentaires}\label{commentaires-1}}
+
+Nous avons bien utilisé le temps imparti. Celui-ci nous a permis de nous
+former non seulement sur les technologies auxquelles nous étions
+assignées mais aussi à comprendre l'ensemble du code que ce soit le
+front ou le back.
+
+Nous sommes ainsi parvenu à rendre notre profil beaucoup plus attractif
+avec une compréhension plus fine des abstractions des différentes
+technologies mais aussi une vision beaucoup moins étroite de notre champ
+d'action.
+
+Pour indication, Célian ne connaissait pas Django au démarrage du
+projet, Adam démarrait sur Angular et Yanis était surtout focalisé sur
+Django; maintenant, nous sommes tous en mesure de comprendre le code de
+l'autre et de le corriger à travers un système de PR (Pull Request) sur
+Git.
+
+\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
+
+\newpage
+
+\hypertarget{difficultuxe9s-rencontruxe9es}{%
+\subsection{6.3. Difficultés
+rencontrées}\label{difficultuxe9s-rencontruxe9es}}
+
+Notre projet, malgré un produit final assez satisfaisant, a été le
+théâtres de certaines difficultés qui nous ont poussé à modifier notre
+champ d'action :
+
+\begin{itemize}
+\item
+ La mise en commun du travail a été plus nébuleuse que prévu (notamment
+ après l'instauration de PR qui ont empêchés le bon fonctionnement de
+ certaines commandes de git flow)
+\item
+ les retards accumulés qui on sappé l'efficacité du projet malgré un
+ démarrage rapide
+\item
+ l'utilisation des APIs des imprimantes 3D : Notre objectif initial
+ était de relier directement les imprimantes 3D à l'application grâce
+ au logiciel FDM Monster. Cependant, cette configuration s'est révélée
+ difficile en raison des systèmes propriétaires des machines. De plus,
+ comme les imprimantes sont très sollicitées, nous avons temporairement
+ configuré le site pour qu'un administrateur lance chaque impression
+ manuellement. Nous continuons néanmoins à travailler sur
+ l'automatisation de ce processus.
+\end{itemize}
+
+\hypertarget{fonctionalituxe9s-ruxe9alisuxe9-ou-pas}{%
+\subsubsection{6.3.1 Fonctionalités réalisé ou
+pas}\label{fonctionalituxe9s-ruxe9alisuxe9-ou-pas}}
+
+\begin{longtable}[]{@{}
+ >{\raggedright\arraybackslash}p{(\columnwidth - 8\tabcolsep) * \real{0.1818}}
+ >{\raggedright\arraybackslash}p{(\columnwidth - 8\tabcolsep) * \real{0.1818}}
+ >{\raggedright\arraybackslash}p{(\columnwidth - 8\tabcolsep) * \real{0.1818}}
+ >{\centering\arraybackslash}p{(\columnwidth - 8\tabcolsep) * \real{0.2273}}
+ >{\centering\arraybackslash}p{(\columnwidth - 8\tabcolsep) * \real{0.2273}}@{}}
+\toprule\noalign{}
+\begin{minipage}[b]{\linewidth}\raggedright
+ID
+\end{minipage} & \begin{minipage}[b]{\linewidth}\raggedright
+Fonctionnalité de l'application
+\end{minipage} & \begin{minipage}[b]{\linewidth}\raggedright
+Description technique
+\end{minipage} & \begin{minipage}[b]{\linewidth}\centering
+Priorité
+\end{minipage} & \begin{minipage}[b]{\linewidth}\centering
+Statut
+\end{minipage} \\
+\midrule\noalign{}
+\endhead
+\bottomrule\noalign{}
+\endlastfoot
+\textbf{F01} & \textbf{Authentification} & Connexion et déconnexion. &
+Haute & \textbf{Réalisé} \\
+\textbf{F02} & \textbf{Gestion des profils} & Affichage et modification
+des informations utilisateurs. & Basse & \textbf{Réalisé} \\
+\textbf{F03} & \textbf{Gestion des impressions} & Flux complet
+d'impression 3D, du dépôt STL à la mise en file. & Haute &
+\textbf{Réalisé} \\
+\textbf{F03-1} & \textbf{Déposer un STL} & Upload d'un fichier STL. &
+Haute & \textbf{Réalisé} \\
+\textbf{F03-2} & \textbf{Slicer automatique} & Convertir le modèle en
+G-code via un slicer. & Moyenne & \textbf{Non réalisé} \\
+\textbf{F03-3} & \textbf{Estimation du coût} & Calculer le prix
+d'impression à partir des paramètres. & Basse & \textbf{Non réalisé} \\
+\textbf{F03-4} & \textbf{Position dans la file} & Afficher la place du
+travail dans la file. & Basse & \textbf{Non réalisé} \\
+\textbf{F03-5} & \textbf{Priorité projets INTech} & Rôle dédié pour
+prioriser les impressions. & Basse & \textbf{Réalisé} \\
+\textbf{F03-6} & \textbf{Crédit restant} & Afficher le crédit restant
+d'un utilisateur. & Basse & \textbf{Réalisé} \\
+\textbf{F03-7} & \textbf{Quantité d'impressions} & Indiquer le nombre
+d'exemplaires à imprimer. & Basse & \textbf{Réalisé} \\
+\textbf{F04} & \textbf{Espace administrateur} & Interface
+d'administration pour une gestion complète. & Moyenne &
+\textbf{Réalisé} \\
+\textbf{F04-1} & \textbf{Gestion des utilisateurs} & Créer, modifier et
+supprimer les utilisateurs. & Haute & \textbf{Réalisé} \\
+\textbf{F04-2} & \textbf{Gestion des travaux} & Créer, modifier et
+supprimer la file de travaux. & Moyenne & \textbf{Réalisé} \\
+\textbf{F04-3} & \textbf{Reprise des erreurs} & Déclarer un travail en
+erreur et le remettre en file. & Moyenne & \textbf{Non réalisé} \\
+\textbf{F04-4} & \textbf{Gestion crédit} & Gestion des crédits des
+utilisateurs (recharge). & Haute & \textbf{Réalisé} \\
+\textbf{F05} & \textbf{Intégrations} & SSO et notifications externes. &
+Optionnelle & \textbf{Non réalisé} \\
+\textbf{F05-1} & \textbf{Intégration CAS} & Inscription et connexion via
+le CAS de l'école. & Optionnelle & \textbf{Non réalisé} \\
+\textbf{F05-2} & \textbf{Intégration Discord} & Utiliser des webhooks
+pour les notifications. & Optionnelle & \textbf{Non réalisé} \\
+\textbf{F05-3} & \textbf{Intégration HelloAsso} & Créditer les comptes
+via HelloAsso. & Optionnelle & \textbf{Non réalisé} \\
+\textbf{F06} & \textbf{Impression technique} & Options avancées
+d'impression. & Optionnelle & \textbf{Non réalisé} \\
+\textbf{F06-1} & \textbf{Utilisation de supports} & Détecter la
+nécessité de supports. & Optionnelle & \textbf{Non réalisé} \\
+\textbf{F06-2} & \textbf{Paramétrage du slicer} & Permettre l'upload
+d'un JSON de paramètres. & Optionnelle & \textbf{Non réalisé} \\
+\textbf{F06-3} & \textbf{Choix des matériaux} & Choisir un plastique
+autre que le PLA. & Optionnelle & \textbf{Réalisé} \\
+\textbf{F07} & \textbf{Gestion des filaments} & Administration des
+filaments et du stock. & Optionnelle & \textbf{Réalisé} \\
+\textbf{F07-1} & \textbf{Activation des filaments} & Activer et
+désactiver des filaments. & Optionnelle & \textbf{Non réalisé} \\
+\textbf{F07-2} & \textbf{Gestion du filament} & Gérer la quantité de
+filament restant. & Optionnelle & \textbf{Réalisé} \\
+\textbf{F07-3} & \textbf{Gestion de consommation} & Rapport sur
+quantités, crédits et montant. & Optionnelle & \textbf{réalisé} \\
+\end{longtable}
+
+\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
+
+\newpage
+
+\hypertarget{conclusion-et-perspective}{%
+\section{7. Conclusion et perspective}\label{conclusion-et-perspective}}
+
+Malgré des difficultés, notre projet a produit une Application Web
+fonctionnelle selon les critères que nous nous étions imposés en
+préambule avec le cahier des charges.
+
+Tout du moins, nous souhaiterions peaufiner ce projet au-delà du rendu
+final, que ce soit par la continuation de celui-ci par un autre groupe
+de projet informatique, ou bien par la maintenance de celui-ci par
+l'Association Intech elle-même. Il faudra donc le déployer ce qu'on a
+pas encore pu faire. On pense utilisé une machine virtuelle fournie par
+l'association Minet. À terme il pourra être réellement utilisé par
+l'association.
+
+Ce projet est un projet enrichissant pour un étudiant ingénieur dans le
+développement informatique à travers l'utilisation d'outils et de
+technologies professionnels qui s'intègre pleinement dans le cadre de
+nos études et du campus avec Intech.
+
+Ce projet, au-delà de la réalisation purement technique, est aussi une
+expérience d'équipe avec tout ses avantages et ses défauts qu'on a
+expérimenté (comme les retards et la mise en commun du code). Cela en
+fait donc une force pour tous nos futurs projets en groupe.
+
+\begin{center}\rule{0.5\linewidth}{0.5pt}\end{center}
diff --git a/Livrable/plan-de-charge-previsionnel.pdf b/Livrable/plan-de-charge-previsionnel.pdf
new file mode 100644
index 0000000..0a979ad
Binary files /dev/null and b/Livrable/plan-de-charge-previsionnel.pdf differ
diff --git a/Livrable/planChargeSuiviActivites.ods b/Livrable/planChargeSuiviActivites.ods
new file mode 100644
index 0000000..89e8d63
Binary files /dev/null and b/Livrable/planChargeSuiviActivites.ods differ
diff --git a/Livrable/planChargeSuiviActivites.pdf b/Livrable/planChargeSuiviActivites.pdf
new file mode 100644
index 0000000..a6cc0d5
Binary files /dev/null and b/Livrable/planChargeSuiviActivites.pdf differ
diff --git a/Livrable/planChargeSuiviActivites.png b/Livrable/planChargeSuiviActivites.png
new file mode 100644
index 0000000..ff5d070
Binary files /dev/null and b/Livrable/planChargeSuiviActivites.png differ
diff --git a/Livrable/planning-final.pdf b/Livrable/planning-final.pdf
new file mode 100644
index 0000000..8978945
Binary files /dev/null and b/Livrable/planning-final.pdf differ
diff --git a/Livrable/planning-previsionnel.pdf b/Livrable/planning-previsionnel.pdf
new file mode 100644
index 0000000..e391978
Binary files /dev/null and b/Livrable/planning-previsionnel.pdf differ
diff --git a/Livrable/rapport-final.md b/Livrable/rapport-final.md
new file mode 100644
index 0000000..82cd0f1
--- /dev/null
+++ b/Livrable/rapport-final.md
@@ -0,0 +1,430 @@
+---
+title: "Rapport de Projet : PrINTech"
+subtitle: "Encadrant : Mohamed SELLAMI | Version : 3.0"
+subject: "Livrable 3"
+author: |
+ `\begin{tabular}{cc}
+ Adam ALLOU & Arnaud COSTERMANS \\
+ \footnotesize adam.allou@telecom-sudparis.eu & \footnotesize arnaud.costermans@telecom-sudparis.eu \\
+ & \\
+ Célian GIAUME & Yanis BELLOT \\
+ \footnotesize celian.giaume@telecom-sudparis.eu & \footnotesize yanis.bellot@telecom-sudparis.eu
+ \end{tabular}`{=latex}
+date: "06 Juin 2026"
+toc: true
+toc-title: "Sommaire du Rapport Final"
+
+---
+
+\newpage
+
+# 1. Introduction
+
+Depuis cette année, l'association INTech du campus rencontre des difficultés pour gérer les impressions 3D réalisées par ses membres. En effet, INTech offre désormais aux étudiants de l'école la possibilité d'imprimer leurs modèles 3D en devenant adhérents, selon le processus décrit dans la figure 1.
+
+Le processus commence lorsqu'un étudiant trouve un modèle 3D, renomme le fichier à son nom (au format `NOM-PRENOM.stl`), puis remplit un Google Form pour s'enregistrer dans un tableur avant de lancer l'impression. Si l'étudiant n'est pas présent à la fin du travail et que l'imprimante est requise pour une autre tâche, un opérateur de l'association retire la pièce et la stocke au local en attendant son retour. À la fin du mois, la phase de facturation s'enclenche : l'opérateur consulte le tableur Google Sheets pour calculer le montant total dû, crée un lien de paiement sur **HelloAsso** et envoie la facture à l'étudiant. Si ce dernier règle sa facture sous 7 jours, l'opérateur valide la transaction dans sa comptabilité, ce qui marque le succès du processus. En revanche, s'il ne règle pas sa dette après plusieurs relances hebdomadaires et que le plafond maximal d'avertissements est atteint, l'étudiant est inscrit sur liste noire, ce qui entraîne l'échec de la procédure.
+
+Actuellement, ce système de gestion présente plusieurs limites. Les adhérents doivent télécharger et paramétrer un logiciel de découpe (*slicer*) qui permet de transformer un modèle 3D en une série d'instructions pour les imprimantes, appelée G-code. On demande ensuite aux adhérents de charger ce G-code sur les imprimantes, de lancer les impressions, puis de remplir un Google Form en y renseignant le nom de leur fichier, le poids de l'impression et d'autres paramètres techniques.
+
+
+
+
+Ce fonctionnement implique de nombreuses étapes manuelles susceptibles d'engendrer des erreurs et de faciliter la fraude. De plus, il impose de former chaque nouvel adhérent à l'utilisation physique des machines.
+
+C'est dans ce contexte qu'intervient le projet PrINTech, qui consiste à développer une application web dynamique afin d'automatiser la gestion des impressions 3D. Contrairement à la solution existante, ce projet s'inscrit dans une vision à long terme : il facilite le passage à l'échelle (intégration de nouvelles imprimantes ou augmentation du nombre d'utilisateurs) et permet de réduire considérablement la charge de travail du bureau de l'association.
+
+---
+
+\newpage
+## 1.1. Terminologie
+
+Pour faciliter la lecture de ce rapport, cette section regroupe et définit les termes techniques, les acronymes et les notions spécifiques au domaine de l'impression 3D et du développement web abordés dans ce document.
+
+### Impression 3D et Matériaux
+* **Fichier STL (`.stl`)** : Format de fichier standard en impression 3D (Stéréolithographie) représentant la géométrie de la surface d'un objet 3D sous forme de triangles.
+* **Slicer (Trancheur)** : Logiciel qui découpe un modèle 3D virtuel en fines couches horizontales et génère les instructions nécessaires à l'imprimante.
+* **G-code** : Langage de programmation numérique universel utilisé pour piloter les machines-outils et les imprimantes 3D.
+* **Filament** : Fil de plastique en bobine servant de matière première à l'imprimante 3D pour fabriquer les objets.
+* **PETG** : Type de plastique très résistant (similaire à celui des bouteilles d'eau, mais modifié), souvent utilisé pour des pièces devant supporter des chocs ou une exposition extérieure.
+* **PLA (Acide Polylactique)** : Plastique d'origine végétale couramment utilisé en impression 3D.
+* **Supports** : Structures temporaires imprimées en même temps que le modèle pour soutenir les parties dans le vide.
+
+### Technologies Web & Architecture
+* **Angular** : Framework côté client (Frontend) utilisé pour concevoir une interface utilisateur dynamique.
+* **Django** : Framework de haut niveau basé sur Python, utilisé pour le développement de la logique métier (Backend).
+* **API REST** : Style d'architecture logicielle permettant au Frontend et au Backend de communiquer via le protocole HTTP.
+* **PostgreSQL** : Système de gestion de base de données relationnelle open-source.
+* **Docker & Conteneurisation** : Technologie permettant d'isoler une application et ses dépendances dans un environnement virtuel appelé "conteneur".
+* **Nginx & Gunicorn** : Duo de production où Nginx sert de serveur proxy inverse et Gunicorn de serveur d'application WSGI pour exécuter le code Python.
+
+### Outils de Développement & Tests
+* **Git / Git Flow** : Git est le système de contrôle de version ; Git Flow est la méthodologie qui structure la collaboration (branches `main`, `develop`, `features/`).
+* **PR (Pull Request)** : Demande formelle de fusion de code soumise par un développeur pour relecture et validation.
+* **uv** : Gestionnaire de paquets et d'environnements Python extrêmement rapide, écrit en Rust.
+* **Playwright** : Framework de test de bout en bout (E2E) permettant de simuler le comportement d'un utilisateur réel.
+
+\newpage
+# 2. Cahier des charges
+
+À la suite des rapports et des échanges menés avec le bureau et les membres actifs de l'association INTech, une analysis approfondie des besoins opérationnels a été réalisée. Le constat est simple : le volume croissant de demandes d'impression 3D sur le campus sature le modèle de gestion actuel, basé sur des processus manuels et des outils tiers (Google Forms, tableurs Sheets).
+
+## 2.1. Description du sujet
+
+Notre projet consiste en la réalisation d'une application web dynamique. Le site doit être capable d'interagir avec une base de données qu'il nous incombe d'implémenter. Cette plateforme permettra l'identification sécurisée des étudiants souhaitant imprimer des modèles 3D grâce à un système de gestion des utilisateurs, des requêtes et des files d'attente.
+
+Cette plateforme aura pour objectifs principaux :
+
+* **L'authentification sécurisée** des étudiants du campus souhaitant utiliser les services d'impression 3D.
+* **La gestion des utilisateurs** en distinguant les rôles (adhérents, bureau, membres d'un projet) et leurs droits associés.
+* **Le traitement des requêtes** afin de centraliser, suivre et historiser toutes les demandes de fabrication soumises par les élèves.
+* **La gestion des crédits et de la tarification** afin de permettre le paiement de chaque impression.
+* **Un espace administrateur** offrant une interface de gestion complète pour le bureau.
+
+\newpage
+
+## 2.2. Liste des fonctionnalités de l'application
+Afin de répondre au sujet, l'application doit intégrer les fonctionnalités suivantes, classées par priorité de développement :
+
+| ID | Fonctionnalité de l'application | Description technique | Priorité |
+| :--- |:--------------| :--------------------- | :---: |
+| **F01** | **Authentification** | Connexion et déconnexion. | Haute |
+| **F02** | **Gestion des profils** | Affichage et modification des informations utilisateurs. | Basse |
+| **F03** | **Gestion des impressions** | Flux complet d'impression 3D, du dépôt STL à la mise en file. | Haute |
+| **F03-1** | **Déposer un STL** | Upload d'un fichier STL. | Haute |
+| **F03-2** | **Slicer automatique** | Convertir le modèle en G-code via un slicer. | Moyenne |
+| **F03-3** | **Estimation du coût** | Calculer le prix d'impression à partir des paramètres. | Basse |
+| **F03-4** | **Position dans la file** | Afficher la place du travail dans la file. | Basse |
+| **F03-5** | **Priorité projets INTech** | Chaque utilisateur a un rôle (adhérent, bureau, membre d'un projet) pour prioriser les impressions. | Basse |
+| **F03-6** | **Crédit restant** | Afficher le crédit restant d'un utilisateur. | Basse |
+| **F03-7** | **Quantité d'impressions** | Indiquer le nombre d'exemplaires à imprimer. | Basse |
+| **F04** | **Espace administrateur** | Interface d'administration pour une gestion complète. | Moyenne |
+| **F04-1** | **Gestion des utilisateurs** | Créer, modifier et supprimer les utilisateurs. | Haute |
+| **F04-2** | **Gestion des travaux** | Créer, modifier et supprimer la file de travaux. | Moyenne |
+| **F04-3** | **Reprise des erreurs** | Déclarer un travail en erreur et le remettre en file. | Moyenne |
+| **F04-4** | **Gestion crédit** | Gestion des crédits des utilisateurs, incluant la recharge. | Haute |
+| **F05** | **Intégrations** | SSO et notifications externes. | Optionnelle |
+| **F05-1** | **Intégration CAS** | Inscription et connexion via le CAS de l'école. | Optionnelle |
+| **F05-2** | **Intégration Discord** | Utiliser des webhooks pour les notifications. | Optionnelle |
+| **F05-3** | **Intégration HelloAsso** | Créditer les comptes via HelloAsso. | Optionnelle |
+| **F06** | **Impression technique** | Options avancées d'impression. | Optionnelle |
+| **F06-1** | **Utilisation de supports** | Détecter quand l'utilisation de supports est nécessaire. | Optionnelle |
+| **F06-2** | **Paramétrage du slicer** | Permettre l'upload d'un JSON de paramètres. | Optionnelle |
+| **F06-3** | **Choix des matériaux** | Choisir un plastique autre que le PLA. | Optionnelle |
+| **F07** | **Gestion des filaments** | Administration des filaments et du stock. | Optionnelle |
+| **F07-1** | **Activation des filaments** | Activer et désactiver des filaments. | Optionnelle |
+| **F07-2** | **Gestion du filament** | Gérer la quantité de filament restant. | Optionnelle |
+| **F07-3** | **Gestion de consommation** | Rapport sur les quantités, crédits et montants imprimés. | Optionnelle |
+
+---
+
+\newpage
+
+# 3. Conception
+
+## 3.1. Base de données
+
+Comme l'illustre ce schéma, lorsqu'un utilisateur (caractérisé par un rôle applicatif et un solde de crédits) souhaite fabriquer un objet, il émet une demande d'impression (*Request*). Celle-ci encapsule un fichier numérique (*File*) contenant le modèle 3D et ses paramètres de découpage au format JSON (*para_slicer*), lui-même associé à un consommable précis (*Filament*) défini par son type (PLA ou PETG) et sa couleur. La demande est ensuite affectée à une machine (*Printer*) identifiée par son modèle et son état de disponibilité. Enfin, pour éradiquer les risques de fraude et automatiser la comptabilité, chaque transaction (recharge de compte par carte/espèces ou débit/remboursement lié à une impression) est tracée par l'entité *Operation*. Cette table lie un agent du bureau à un utilisateur bénéficiaire tout en restant historiquement connectée à la *Request* d'origine.
+
+
+
+---
+
+\newpage
+
+## 3.2. Exemple de schéma: Séquence de l'Authentification
+
+Pour sécuriser l'accès aux ressources de la plateforme et garantir que chaque étudiant interagit uniquement avec ses propres données, le projet implémente un flux d'authentification basé sur des jetons d'accès (JWT) via la bibliothèque Django REST Framework SimpleJWT représenté dans le schéma ci-dessous. Ce mécanisme élimine les failles de sécurité de l'ancien système et permet une communication fluide entre le Frontend Angular et l'API Backend.
+
+
+
+
+---
+
+\newpage
+
+## 3.3. Processus d'impression 3D avec PrIntech
+
+### Description du processus d'impression 3D
+
+Le processus débute lorsqu'un étudiant dépose un modèle 3D sur la plateforme (**F03-1 : Déposer un STL**). Une fois la requête enregistrée dans l'interface d'administration (**F04-2 : Gestion des travaux**), le système évalue automatiquement les ressources nécessaires. Il vérifie d'une part la quantité de matière disponible (**F07-2 : Gestion du filament**) et d'autre part le montant estimé de l'impression (**F03-3 : Estimation du coût**) par rapport aux ressources financières de l'utilisateur (**F03-6 : Crédit restant**). Si le plastique est manquant ou indisponible, la demande est suspendue. Si l'utilisateur ne dispose pas de fonds suffisants, l'application le redirige vers le module externe afin de renflouer son compte (**F05-3 : Intégration HelloAsso**).
+
+Dès que ces vérifications sont validées, le travail rejoint la file d'attente informatique et l'opérateur lui attribue une machine disponible (**F04-2 : Gestion des travaux**), tout en prenant en compte le rôle de l'utilisateur pour la gestion des priorités (**F03-5 : Priorité projets INTech**). L'application procède alors au prélèvement des fonds requis sur le compte de l'étudiant (**F04-4 : Gestion crédit**), met à jour le statut informatique de l'imprimante, et l'opérateur lance physiquement la fabrication de la pièce (**F03 : Gestion des impressions**). À la fin du cycle, deux situations peuvent se présenter :
+* **En cas de succès :** l'opérateur valide la fin de la tâche (**F04-2 : Gestion des travaux**), l'imprimante repasse informatiquement à l'état disponible, le stock de plastique restant est ajusté (**F07-2 : Gestion du filament**) et une alerte automatisée est envoyée à l'étudiant (**F05-2 : Intégration Discord**) pour l'inviter à récupérer sa pièce.
+* **En cas d'échec :** l'opérateur déclare l'avarie sur l'interface (**F04-3 : Reprise des erreurs**), libérant immédiatement la machine. Le système réajuste alors automatiquement le solde de l'étudiant (**F04-4 : Gestion crédit**) tout en envoyant une notification Discord pour l'avertir du problème (**F05-2 : Intégration Discord**).
+
+
+
+---
+
+\newpage
+
+# 4. Réalisation et choix techniques
+
+## 4.1. Choix des technologies
+
+Les technologies disponibles pour développer une application web sont nombreuses. Pour effectuer notre sélection, nous avons d'abord examiné les outils capables de répondre à notre cahier des charges, avant de nous appuyer sur les technologies avec lesquelles les membres de notre équipe avaient déjà de l'expérience. Sur la base de ces critères, nous avons sélectionné la pile technique (*stack*) suivante.
+
+Pour le frontend :
+- **Angular** : Pour la réalisation de l'interface utilisateur. Angular s'appuie sur une architecture en composants et sur le langage **TypeScript**, apportant un typage fort et une structure rigoureuse.
+
+Pour le backend :
+- **Django (Python)** : Utilisé pour développer le cœur de la logique métier et l'API REST (via *Django REST Framework*).
+- **uv** : Afin de gérer nos bibliothèques et nos versions de Python, nous avons utilisé `uv`. C'est un équivalent de Poetry, mais optimisé car implémenté en Rust. Il est nécessaire de préfixer nos commandes par `uv run` afin que le processus s'exécute dans l'environnement dédié.
+- **Swagger (OpenAPI)** : Intégré à notre backend pour la documentation et le test de l'API REST. Swagger génère automatiquement une interface web interactive à partir des routes Django. Cela permet aux développeurs frontend de comprendre instantanément les points de terminaison (*endpoints*), les paramètres attendus et les réponses de l'API, facilitant grandement la communication et l'intégration.
+- **PostgreSQL** : Ce système de gestion de base de données relationnelle (SGBDR) open-source a été retenu pour sa robustesse, sa conformité ACID et sa gestion fine des transactions financières (crédits, remboursements, opérations). Sa capacité à indexer efficacement les données structurées garantit des performances optimales lors de la montée en charge du système et du suivi des files d'attente.
+- **Klipper** : Firmware communautaire utilisé pour remplacer le micrologiciel constructeur des imprimantes.
+- **Moonraker** : Outil qui expose les API JSON-RPC de Klipper sous forme d'API REST.
+- **FDM Monster** : Cet orchestrateur open-source centralise la gestion d'une flotte d'imprimantes 3D. Connecté aux différentes instances Moonraker, il permet de piloter le parc, de centraliser le contrôle des machines et de gérer globalement les files d'attente d'impression.
+
+### Tests, Validation et Qualité Logicielle
+- **Tests natifs Django (TestCase)** : Intégrés directement au backend, le framework de test unitaire et d'intégration natif de Django permet de sécuriser l'intégrité de la base de données lors des transactions critiques. Ils valident de manière isolée les calculs de prix, l'exactitude des débits et remboursements, le respect des rôles pour la gestion des priorités, ainsi que les transitions de statut des requêtes d'impression (du dépôt initial jusqu'à la mise en file).
+- **Playwright** : Framework moderne retenu pour l'automatisation des tests de bout en bout (*End-to-End*). Complémentaire aux tests Django, Playwright nous permet de simuler le parcours complet d'un utilisateur sur un navigateur réel de manière isolée.
+
+### Conteneurisation et Infrastructure
+- **Docker & Docker Compose** : Afin de partitionner logiquement les différentes couches applicatives (Frontend, Backend, Base de données), nous avons conteneurisé chaque service. Technologie incontournable en milieu professionnel, Docker garantit que l'application s'exécute de manière strictement identique sur les machines de développement et sur le serveur de production, simplifiant ainsi la configuration de l'infrastructure.
+- **Nginx & Gunicorn** : Pour le déploiement en production, **Gunicorn** fait office de serveur d'application WSGI, chargé d'exécuter le code Python/Django en gérant efficacement les requêtes concurrentes via un système de processus de travail (*workers*). Il est placé derrière **Nginx**, configuré comme un proxy inverse (*reverse proxy*). Nginx assure la sécurité globale, gère les certificats SSL/TLS (HTTPS), sert directement les fichiers statiques ou médias lourds (comme les fichiers STL stockés) et distribue la charge vers le backend.
+
+### Outils de développement et de collaboration
+* **Visual Studio Code (VS Code)** : Choisi comme environnement de développement intégré (IDE) principal par l'équipe.
+* **Git & GitFlow** : Pour la gestion de version, nous utilisons **Git** hébergé sur **GitHub**. Afin d'organiser le travail collaboratif sans bloquer la production, nous appliquons la méthodologie **GitFlow** (branches `main`, `develop`, et `feature/` isolées).
+* **Discord & Webhooks GitHub** : Discord est notre outil de communication principal. À chaque fois qu'un développeur pousse du code (*push*) ou ouvre une demande de fusion (*pull request*), une notification automatique est envoyée dans un salon dédié sur Discord, facilitant le suivi de l'avancement.
+
+---
+
+\newpage
+
+## 4.2. Réalisation
+
+Pour la conteneurisation, il a fallu configurer un fichier `docker-compose.yaml` afin de déployer un conteneur PostgreSQL configuré sur le bon port. Enfin, pour la mise en commun du code, l'utilisation de Git Flow a permis de définir un cadre de travail professionnel clair.
+
+Afin de valider l'expérience utilisateur et de documenter le rendu final de notre application PrINTech, cette section presents les principales interfaces développées, divisées entre l'espace adhérent (client) et l'espace d'administration (opérateur).
+
+\newpage
+
+### 4.2.1. Espace Étudiant et Demandes d'Impression
+
+* **Interface de Connexion** : Cette interface épurée permet l'authentification sécurisée des utilisateurs (Fonctionnalité **F01**).
+ 
+
+* **Page d'Accueil** : Le tableau de bord principal de l'étudiant. Il offre une vue d'ensemble claire sur ses activités courantes et met en valeur son solde (Fonctionnalité **F03-6 : Crédit restant**).
+ 
+
+* **Dépôt d'une demande d'impression** : Formulaire intuitif dédié au dépôt des fichiers 3D (Fonctionnalité **F03-1 : Déposer un STL**). L'étudiant peut y téléverser son modèle, spécifier la quantité d'exemplaires souhaitée (**F03-7**) ainsi que le choix des matériaux avant l'envoi au serveur.
+ 
+
+* **Historique des travaux** : Cette vue liste l'intégralité des commandes passées par l'étudiant reprenant la date de dépôt, le type de projet et leur statut en direct (Fonctionnalité **F03-4 : Position dans la file**).
+ 
+
+* **Profil** : Permet l'affichage et modification des informations utilisateurs: photo de profil, mot de passe (Fonctionnalité **F02 : Gestion des profils**).
+ 
+
+---
+
+\newpage
+
+### 4.2.2. Espace Administration et Gestion des Opérations
+
+Réservé aux membres du bureau et aux opérateurs de l'association INTech (Fonctionnalité **F04**), cet espace permet un pilotage complet du service et du parc matériel.
+
+* **Gestion de la file des travaux** : Interface maîtresse de l'opérateur (Fonctionnalité **F04-2 : Gestion des travaux**). Elle centralise les fichiers `.stl` soumis, permet d'assigner manuellement ou automatiquement une imprimante libre et d'appliquer la tarification calculée.
+ 
+
+\newpage
+
+* **Suivi du parc d'imprimantes** : Écran de supervision du statut des machines connectées. L'administrateur peut visualiser instantanément quelles machines sont disponibles (`UP`), occupées (`USED`) ou hors service (`DOWN`).
+ 
+
+* **Gestion des stocks de consommables** : Vue dédiée au contrôle des stocks de plastique (Fonctionnalité **F07 : Gestion des filaments**). Elle permet d'enregistrer les nouvelles bobines et de surveiller la quantité de matière restante en grammes (**F07-2**).
+ 
+
+* **Suivi financier et des transactions** : Historique financier de la plateforme (Fonctionnalité **F04-4 : Gestion crédit**). Cet écran liste de manière chronologique tous les débits, les rechargements HelloAsso fructueux ainsi que les remboursements automatiques émis suite à une erreur d'impression.
+ 
+
+* **Administration des comptes utilisateurs** : Interface de modération des profils (Fonctionnalité **F04-1**). Elle permet également de modifier les rôles (adhérents, bureau, membres d'un projet) (**F03-5**).
+ 
+
+ ---
+
+\newpage
+
+# 5. Validation et tests
+
+
+Pour garantir la robustesse de l'application PrINTech, nous avons mis en place une stratégie de tests automatisés. L'effort principal a été concentré sur la validation fonctionnelle du backend (Django), complété par des mécanismes de tests d'intégration et d'interface (Playwright).
+
+## 5.1. Tests Backend (Django)
+
+Le backend constituant le cœur logique et financier de notre application, nous avons conçu une suite rigoureuse de tests unitaires et d'intégration à l'aide du framework de test de *Django REST Framework* (`APITestCase`). Les tests se trouvent dans le fichier `PrINTech-Back/back/apps/api/tests.py` et couvrent les fonctionnalités clés du système :
+
+### 5.1.1. Fonctionnalités validées par les tests automatiques :
+
+* **F01 (Authentification) & Sécurisation des routes** :
+ * Nous validons la génération et le rejet des requêtes selon la validité des jetons d'accès JWT (`test_missing_token`, `test_unauthenticated_cannot_upload`).
+ * L'étanchéité des droits est testée systématiquement : un utilisateur standard reçoit une erreur `HTTP_403_FORBIDDEN` lorsqu'il tente d'accéder aux routes d'administration (`test_regular_user_cannot_access_admin_user_endpoints`, `test_user_cannot_access_admin_endpoint`, `test_admin_access`).
+
+* **F02 (Gestion des profils)** :
+ * Les tests vérifient les contraintes de modification de profil, comme le changement sécurisé de mot de passe (`test_change_password_wrong_old_password`), ainsi que la gestion stricte de la photo de profil (`test_upload_profile_picture`, `test_delete_profile_picture_when_none_exists`).
+ * L'isolation des requêtes est certifiée par le test `test_no_access_other_user_request` : un utilisateur connecté ne peut en aucun cas interroger, modifier ou lister les demandes d'un autre étudiant, prévenant toute fuite de données.
+
+* **F03 (Gestion des impressions) & F03-7 (Quantité)** :
+ * Le flux complet de soumission est validé par `test_create_request`.
+ * Bien que les tests d'interface automatisés n'aient pas pu valider le calcul de consommation frontend, la logique backend est blindée : l'API calcule et valide le coût total ainsi que la cohérence des paramètres avant toute mise en file.
+
+* **F03-5 (Priorité projets INTech)** :
+ * Le test critique `test_admin_request_list_priority_sorting` certifie que l'API trie et ordonne automatiquement les demandes en attente selon la hiérarchie stricte des rôles : `BUREAU` (0) > `ROBOTECH` (1) > `ADHERENT` (2).
+ * Le test `test_default_role_is_adherent` assure qu'un nouvel utilisateur est assigné par défaut au rôle le plus restrictif.
+
+* **F03-6 (Crédit restant) & F04-4 (Gestion crédit)** :
+ * Les scénarios de paiement et de remboursement sont entièrement automatisés. `test_pay_request_success` valide le débit immédiat du crédit de l'étudiant au prorata du prix fixé, tandis que `test_cancel_request_with_refund` s'assure du recrédit automatique du solde en cas d'annulation.
+ * Les garde-fous contre la fraude sont vérifiés par `test_user_cannot_update_credit_manually` (un utilisateur ne peut pas modifier son solde lui-même) et `test_pay_request_insufficient_funds` (blocage de la transaction si le solde est insuffisant).
+
+* **F04-1 (Gestion des utilisateurs) & F04-2 (Gestion des travaux)** :
+ * Les privilèges des opérateurs du bureau sont testés pour la modification des rôles applicatifs (`test_admin_can_modify_user_role`) et le changement d'état manuel des imprimantes (`test_admin_update_printer_status`).
+ * La cohérence des transitions d'états de la file d'attente est gérée par `test_staff_change_status_auto` et `test_staff_must_set_price_for_awaiting_payment`, forçant l'attribution d'un prix avant le passage au paiement.
+
+* **F07-2 (Gestion du filament)** :
+ * L'administration des consommables est sécurisée par les tests `test_admin_create_filament` et `test_admin_can_update_quantity`, garantissant la mise à jour fiable des stocks de plastique en base de données.
+---
+
+## 5.2. Tests d'Interface (Playwright) et Validation Frontend
+
+Pour la partie émergée de l'iceberg (le Frontend), l'objectif initial intégrait le déploiement de tests de bout en bout (E2E) via l'outil **Playwright**.
+
+Cependant, comme évoqué dans notre bilan de projet (Section 6.1.3), le retard accumulé sur l'apprentissage d'Angular et la complexité de l'interfaçage asynchrone ont limité la couverture finale de ces tests E2E.
+
+## 5.2. Tests Manuels et Validation Fonctionnelle
+
+Pour pallier la couverture limitée des tests automatisés sur Playwright consécutive aux retards de développement, l'équipe a mis en place une **campagne rigoureuse de tests manuels**. Structurée autour d'un cahier de recette, cette approche a permis de confronter l'interface Angular aux règles métiers implémentées sur le backend Django.
+
+### 5.2.1. Scénarios validés et cahier de recette
+Les tests ont été exécutés de bout en bout en simulant les deux rôles applicatifs clés de la plateforme :
+
+* **Parcours Étudiant (Interface Client)** :
+ * **F01 (Authentification)** : Validation de la connexion, de la déconnexion et de la persistance du jeton JWT.
+ * **F03-1 & F03-7 (Dépôt et Quantité)** : Téléversement réussi de fichiers `.stl` et spécification du nombre d'exemplaires.
+ * **F03-6 (Crédit restant)** : Vérification de l'affichage dynamique du solde de l'étudiant et du blocage de l'interface en cas de fonds insuffisants.
+ * **F06-3 (Matériaux)** : Sélection et transmission correcte du type de consommable (PLA / PETG).
+
+* **Parcours Bureau / Opérateur (Espace Administration)** :
+ * **F04-1 & F03-5 (Utilisateurs et Priorités)** : Modification des rôles (adhérents, bureau, projets) et vérification de l'impact visuel sur la hiérarchie des comptes.
+ * **F04-2 (Gestion des travaux)** : Assignation manuelle d'une imprimante à un travail de la file et mise à jour de son statut (`UP`, `USED`, `DOWN`).
+ * **F04-4 (Gestion crédit)** : Simulation de rechargements de comptes et de débits manuels.
+ * **F07-2 & F07-3 (Consommation)** : Décrémentation manuelle des stocks de filament en grammes et génération des rapports de consommation.
+
+### 5.2.2. Bilan de la validation manuelle
+Bien que cette méthode soit plus chronophage qu'une suite de tests E2E automatisée, elle s'est avérée indispensable pour assurer la livraison.
+\newpage
+
+# 6. Bilan du projet
+
+## 6.1. Plannings
+
+Le projet a accumulé d'importants retards, notamment en raison de la participation de certains membres de l'équipe à la Coupe de France de Robotique dans le cadre du projet GATE. Nous avons également sous-estimé la courbe d'apprentissage des technologies utilisées (Angular et Django). Le fait que tous les membres ne soient pas polyvalents sur le Frontend et le Backend a créé des complications de répartition. De plus, la communication avec les imprimantes (confiée à Arnaud) n'a pas pu être finalisée, ce qui a temporairement limité le périmètre d'automatisation du projet.
+
+### 6.1.1. Planning prévisionnel
+
+
+
+---
+
+\newpage
+
+### 6.1.2. Planning final
+
+
+
+---
+
+\newpage
+
+### 6.1.3. Commentaires
+
+- **Choix du planning prévisionnel** :
+ - Angular étant appris en parallèle du projet, le développement Front n'a débuté qu'en février.
+ - Django étant mieux maîtrisé, son exécution a été plus rapide. La partie Moonraker/Klipper représentait la plus grande incertitude technique.
+ - La phase 3 a été la plus longue en raison de l'apprentissage en cours.
+
+- **Comparaison au planning réel** :
+ - Le projet a accumulé du retard en raison d'échéances académiques conflictuelles (projets GATE, partiels) et d'une sous-estimation de la complexité de certaines tâches.
+ - En réponse, nous avons réévalué le périmètre de notre projet afin de nous concentrer sur les fonctionnalités indispensables requises par le cahier des charges (les tests E2E ayant été mis de côté pour le moment).
+ - Ce retard n'est pas une fatalité : compte tenu de l'utilité concrète du projet, le développement sera poursuivi bien au-delà de la date de rendu académique.
+
+---
+
+\newpage
+
+## 6.2. Plan de charges
+
+L'écart le plus marquant entre notre planification et la réalité réside dans la courbe d'apprentissage d'Angular et de Django, qui s'est révélée beaucoup plus longue et abrupte que prévu. N'ayant pas de compétences approfondies préalables sur ces frameworks, l'assimilation des concepts clés a nécessité un investissement temporel important.
+
+### 6.2.1. Plan de charges prévisionnel et final
+
+
+
+---
+
+\newpage
+
+### 6.2.3. Commentaires
+
+Nous avons optimisé le temps imparti. Celui-ci nous a permis de nous former non seulement sur les technologies auxquelles nous étions affectés, mais aussi de comprendre l'ensemble du code (Front et Back).
+
+Nous sommes ainsi parvenus à valoriser nos compétences grâce à une compréhension plus fine des abstractions techniques. Alors que Célian ne connaissait pas Django au démarrage du projet, qu'Adam débutait sur Angular et que Yanis était focalisé sur le Backend, nous sommes aujourd'hui tous en mesure de comprendre et de corriger le code de nos pairs à travers le système de Pull Requests sur Git.
+
+---
+
+\newpage
+
+## 6.3. Difficultés rencontrées
+
+Malgré un produit final assez satisfaisant, le projet a été jalonné de difficultés qui nous ont poussés à adapter notre champ d'action :
+
+- La mise en commun du travail a été plus complexe que prévu, notamment lors de l'instauration des PR qui ont parfois perturbé le flux Git Flow classique.
+- Les retards accumulés ont entamé l'efficacité globale de l'équipe malgré un démarrage rapide.
+- **L'exploitation des API des imprimantes 3D** : Notre objectif initial était de relier directement les imprimantes à l'application via le logiciel FDM Monster. Cependant, cette configuration s'est révélée difficile en raison des systèmes propriétaires des machines. De plus, les machines étant hautement sollicitées sur le campus, nous avons temporairement configuré la plateforme pour qu'un administrateur valide et lance chaque impression manuellement. Nous continuons néanmoins à travailler sur l'automatisation complète de ce processus.
+
+### 6.3.1 Fonctionnalités réalisées ou non
+
+| ID | Fonctionnalité de l'application | Description technique | Priorité | Statut |
+| :--- | :--- | :--- | :---: | :---: |
+| **F01** | **Authentification** | Connexion et déconnexion. | Haute | **Réalisé** |
+| **F02** | **Gestion des profils** | Affichage et modification des informations utilisateurs. | Basse | **Réalisé** |
+| **F03** | **Gestion des impressions** | Flux complet d'impression 3D, du dépôt STL à la mise en file. | Haute | **Réalisé** |
+| **F03-1** | **Déposer un STL** | Upload d'un fichier STL. | Haute | **Réalisé** |
+| **F03-2** | **Slicer automatique** | Convertir le modèle en G-code via un slicer. | Moyenne | **Non réalisé** |
+| **F03-3** | **Estimation du coût** | Calculer le prix d'impression à partir des paramètres. | Basse | **Non réalisé** |
+| **F03-4** | **Position dans la file** | Afficher la place du travail dans la file. | Basse | **Non réalisé** |
+| **F03-5** | **Priorité projets INTech** | Rôle dédié pour prioriser les impressions. | Basse | **Réalisé** |
+| **F03-6** | **Crédit restant** | Afficher le crédit restant d'un utilisateur. | Basse | **Réalisé** |
+| **F03-7** | **Quantité d'impressions** | Indiquer le nombre d'exemplaires à imprimer. | Basse | **Réalisé** |
+| **F04** | **Espace administrateur** | Interface d'administration pour une gestion complète. | Moyenne | **Réalisé** |
+| **F04-1** | **Gestion des utilisateurs** | Créer, modifier et supprimer les utilisateurs. | Haute | **Réalisé** |
+| **F04-2** | **Gestion des travaux** | Créer, modifier et supprimer la file de travaux. | Moyenne | **Réalisé** |
+| **F04-3** | **Reprise des erreurs** | Déclarer un travail en erreur et le remettre en file. | Moyenne | **Non réalisé** |
+| **F04-4** | **Gestion crédit** | Gestion des crédits des utilisateurs (recharge). | Haute | **Réalisé** |
+| **F05** | **Intégrations** | SSO et notifications externes. | Optionnelle | **Non réalisé** |
+| **F05-1** | **Intégration CAS** | Inscription et connexion via le CAS de l'école. | Optionnelle | **Non réalisé** |
+| **F05-2** | **Intégration Discord** | Utiliser des webhooks pour les notifications. | Optionnelle | **Non réalisé** |
+| **F05-3** | **Intégration HelloAsso** | Créditer les comptes via HelloAsso. | Optionnelle | **Non réalisé** |
+| **F06** | **Impression technique** | Options avancées d'impression. | Optionnelle | **Non réalisé** |
+| **F06-1** | **Utilisation de supports** | Détecter la nécessité de supports. | Optionnelle | **Non réalisé** |
+| **F06-2** | **Paramétrage du slicer** | Permettre l'upload d'un JSON de paramètres. | Optionnelle | **Non réalisé** |
+| **F06-3** | **Choix des matériaux** | Choisir un plastique autre que le PLA. | Optionnelle | **Réalisé** |
+| **F07** | **Gestion des filaments** | Administration des filaments et du stock. | Optionnelle | **Réalisé** |
+| **F07-1** | **Activation des filaments** | Activer et désactiver des filaments. | Optionnelle | **Non réalisé** |
+| **F07-2** | **Gestion du filament** | Gérer la quantité de filament restant. | Optionnelle | **Réalisé** |
+| **F07-3** | **Gestion de consommation** | Rapport sur quantités, crédits et montants. | Optionnelle | **Réalisé** |
+
+---
+
+\newpage
+
+# 7. Conclusion et perspectives
+
+Malgré les obstacles rencontrés, notre projet a abouti à une application web fonctionnelle, conforme aux critères essentiels fixés par notre cahier des charges.
+
+À long terme, nous souhaiterions peaufiner ce projet au-delà du cadre du livrable académique, que ce soit par la reprise du code par un autre groupe de projet informatique, ou directement par la maintenance applicative assurée par l'association INTech elle-même. La prochaine étape majeure consistera à déployer l'application en production, par exemple sur une machine virtuelle fournie par l'association MiNET, afin qu'elle devienne l'outil quotidien de l'association.
+
+Sur le plan personnel, ce projet s'est révélé extrêmement enrichissant pour de futurs ingénieurs. Il nous a permis de manipuler des technologies et des outils professionnels tout en répondant à un besoin concret du campus. Cette expérience précieuse pour des futurs projet surtout dans le web. Enfin, au-delà de la technique, cette expérience nous a confrontés aux réalités de la gestion de projet en équipe (gestion des retards, coordination du code), ce qui constituera un atout indéniable pour nos futurs projets professionnels.
+
+---
\ No newline at end of file
diff --git a/Livrable/rapport-final.pdf b/Livrable/rapport-final.pdf
new file mode 100644
index 0000000..e9c270d
Binary files /dev/null and b/Livrable/rapport-final.pdf differ
diff --git a/Livrable/rapport.pdf b/Livrable/rapport.pdf
new file mode 100644
index 0000000..64228c7
Binary files /dev/null and b/Livrable/rapport.pdf differ
diff --git a/Livrable/screenshots/admin-filaments.png b/Livrable/screenshots/admin-filaments.png
new file mode 100644
index 0000000..1a1a1ff
Binary files /dev/null and b/Livrable/screenshots/admin-filaments.png differ
diff --git a/Livrable/screenshots/admin-operations.png b/Livrable/screenshots/admin-operations.png
new file mode 100644
index 0000000..616d370
Binary files /dev/null and b/Livrable/screenshots/admin-operations.png differ
diff --git a/Livrable/screenshots/admin-printers.png b/Livrable/screenshots/admin-printers.png
new file mode 100644
index 0000000..2ec0109
Binary files /dev/null and b/Livrable/screenshots/admin-printers.png differ
diff --git a/Livrable/screenshots/admin-requests.png b/Livrable/screenshots/admin-requests.png
new file mode 100644
index 0000000..261e7a8
Binary files /dev/null and b/Livrable/screenshots/admin-requests.png differ
diff --git a/Livrable/screenshots/admin-users.png b/Livrable/screenshots/admin-users.png
new file mode 100644
index 0000000..8a25293
Binary files /dev/null and b/Livrable/screenshots/admin-users.png differ
diff --git a/Livrable/screenshots/historique.png b/Livrable/screenshots/historique.png
new file mode 100644
index 0000000..8737495
Binary files /dev/null and b/Livrable/screenshots/historique.png differ
diff --git a/Livrable/screenshots/home.png b/Livrable/screenshots/home.png
new file mode 100644
index 0000000..fa96edd
Binary files /dev/null and b/Livrable/screenshots/home.png differ
diff --git a/Livrable/screenshots/login.png b/Livrable/screenshots/login.png
new file mode 100644
index 0000000..e86c100
Binary files /dev/null and b/Livrable/screenshots/login.png differ
diff --git a/Livrable/screenshots/profile.png b/Livrable/screenshots/profile.png
new file mode 100644
index 0000000..1dcbf92
Binary files /dev/null and b/Livrable/screenshots/profile.png differ
diff --git a/Livrable/screenshots/request.png b/Livrable/screenshots/request.png
new file mode 100644
index 0000000..f405412
Binary files /dev/null and b/Livrable/screenshots/request.png differ
diff --git a/PrINTech-Back/.gitignore b/PrINTech-Back/.gitignore
new file mode 100644
index 0000000..213e1d2
--- /dev/null
+++ b/PrINTech-Back/.gitignore
@@ -0,0 +1,5 @@
+back/media/
+
+.venv/
+env/
+__pycache__/
\ No newline at end of file
diff --git a/PrINTech-Back/back/__init__.py b/PrINTech-Back/back/__init__.py
index e69de29..a663c73 100644
--- a/PrINTech-Back/back/__init__.py
+++ b/PrINTech-Back/back/__init__.py
@@ -0,0 +1 @@
+default_app_config = 'back.apps.api.ApiConfig'
\ No newline at end of file
diff --git a/PrINTech-Back/back/apps/api/admin.py b/PrINTech-Back/back/apps/api/admin.py
index 8c38f3f..7ecee33 100644
--- a/PrINTech-Back/back/apps/api/admin.py
+++ b/PrINTech-Back/back/apps/api/admin.py
@@ -1,3 +1,5 @@
from django.contrib import admin
-
+from .models import Operation,User
# Register your models here.
+admin.site.register(User)
+admin.site.register(Operation)
\ No newline at end of file
diff --git a/PrINTech-Back/back/apps/api/apps.py b/PrINTech-Back/back/apps/api/apps.py
index a97d5a5..918e62a 100644
--- a/PrINTech-Back/back/apps/api/apps.py
+++ b/PrINTech-Back/back/apps/api/apps.py
@@ -1,6 +1,19 @@
from django.apps import AppConfig
+from django.db.models.signals import post_migrate
+def create_default_printers(sender, **kwargs):
+ from .models import Printer
+
+ # Add all printers to the database if they don't exist
+ for printer_name in Printer.Name.values:
+ Printer.objects.get_or_create(
+ name=printer_name,
+ defaults={'status': Printer.Status.DOWN}
+ )
class ApiConfig(AppConfig):
default_auto_field = 'django.db.models.BigAutoField'
name = 'back.apps.api'
+
+ def ready(self):
+ post_migrate.connect(create_default_printers, sender=self)
\ No newline at end of file
diff --git a/PrINTech-Back/back/apps/api/migrations/0001_initial.py b/PrINTech-Back/back/apps/api/migrations/0001_initial.py
index 7145403..c61fb9c 100644
--- a/PrINTech-Back/back/apps/api/migrations/0001_initial.py
+++ b/PrINTech-Back/back/apps/api/migrations/0001_initial.py
@@ -1,9 +1,11 @@
-# Generated by Django 6.0.2 on 2026-02-17 23:53
+# Generated by Django 6.0.2 on 2026-06-05 06:52
import django.contrib.auth.models
import django.contrib.auth.validators
+import django.core.validators
import django.db.models.deletion
import django.utils.timezone
+import uuid
from django.conf import settings
from django.db import migrations, models
@@ -13,85 +15,314 @@ class Migration(migrations.Migration):
initial = True
dependencies = [
- ('auth', '0012_alter_user_first_name_max_length'),
+ ("auth", "0012_alter_user_first_name_max_length"),
]
operations = [
migrations.CreateModel(
- name='Filament',
+ name="Filament",
fields=[
- ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
- ('colour', models.CharField(choices=[('RED', 'Red'), ('GREEN', 'Green'), ('YELLOW', 'Yellow'), ('BLUE', 'Blue'), ('MAGENTA', 'Magenta'), ('WHITE', 'White'), ('BLACK', 'Black'), ('PURPLE', 'Purple'), ('BROWN', 'Brown'), ('GREY', 'Grey'), ('ORANGE', 'Orange')], max_length=25)),
- ('type', models.CharField(choices=[('PLA', 'Pla'), ('REINFORCED_PLA', 'Reinforced Pla'), ('PETG', 'Petg'), ('ABS', 'Abs'), ('TPE/TPU', 'Tpe')], max_length=25)),
- ('quantity', models.PositiveIntegerField(default=0)),
+ (
+ "id",
+ models.BigAutoField(
+ auto_created=True,
+ primary_key=True,
+ serialize=False,
+ verbose_name="ID",
+ ),
+ ),
+ (
+ "color",
+ models.CharField(
+ default="#ffffff",
+ max_length=7,
+ validators=[
+ django.core.validators.RegexValidator(
+ "^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$"
+ )
+ ],
+ ),
+ ),
+ ("color_name", models.TextField()),
+ (
+ "type",
+ models.CharField(
+ choices=[("PLA", "Pla"), ("PETG", "Petg")], max_length=25
+ ),
+ ),
+ ("quantity", models.PositiveIntegerField(default=0)),
+ ("price", models.PositiveIntegerField(default=0)),
],
),
migrations.CreateModel(
- name='Printer',
+ name="Printer",
fields=[
- ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
- ('type', models.CharField(choices=[('SLA/DLP/MSLA', 'Sla'), ('SLS/MJF', 'Sls'), ('FDM/FFF', 'Fdm'), ('MJP', 'Mjp'), ('Binder_Jetting', 'Binder Jetting'), ('DMLS/SLM', 'Dmls')], max_length=25)),
- ('status', models.CharField(choices=[('UP', 'Up'), ('DOWN', 'Down'), ('USED', 'Used')], max_length=25)),
+ (
+ "name",
+ models.CharField(
+ choices=[
+ ("CREALITY_K1C", "Creality K1C"),
+ ("SNAPMAKER_U1", "Snapmaker U1"),
+ ("PRUSA_MK3", "Prusa Mk3"),
+ ],
+ max_length=25,
+ primary_key=True,
+ serialize=False,
+ ),
+ ),
+ (
+ "status",
+ models.CharField(
+ choices=[("UP", "Up"), ("DOWN", "Down"), ("USED", "Used")],
+ default="DOWN",
+ max_length=25,
+ ),
+ ),
],
),
migrations.CreateModel(
- name='User',
+ name="User",
fields=[
- ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
- ('password', models.CharField(max_length=128, verbose_name='password')),
- ('last_login', models.DateTimeField(blank=True, null=True, verbose_name='last login')),
- ('is_superuser', models.BooleanField(default=False, help_text='Designates that this user has all permissions without explicitly assigning them.', verbose_name='superuser status')),
- ('username', models.CharField(error_messages={'unique': 'A user with that username already exists.'}, help_text='Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only.', max_length=150, unique=True, validators=[django.contrib.auth.validators.UnicodeUsernameValidator()], verbose_name='username')),
- ('first_name', models.CharField(blank=True, max_length=150, verbose_name='first name')),
- ('last_name', models.CharField(blank=True, max_length=150, verbose_name='last name')),
- ('is_staff', models.BooleanField(default=False, help_text='Designates whether the user can log into this admin site.', verbose_name='staff status')),
- ('is_active', models.BooleanField(default=True, help_text='Designates whether this user should be treated as active. Unselect this instead of deleting accounts.', verbose_name='active')),
- ('date_joined', models.DateTimeField(default=django.utils.timezone.now, verbose_name='date joined')),
- ('email', models.EmailField(max_length=254, unique=True)),
- ('credit', models.DecimalField(decimal_places=2, default=0, max_digits=6)),
- ('groups', models.ManyToManyField(blank=True, help_text='The groups this user belongs to. A user will get all permissions granted to each of their groups.', related_name='user_set', related_query_name='user', to='auth.group', verbose_name='groups')),
- ('user_permissions', models.ManyToManyField(blank=True, help_text='Specific permissions for this user.', related_name='user_set', related_query_name='user', to='auth.permission', verbose_name='user permissions')),
+ ("password", models.CharField(max_length=128, verbose_name="password")),
+ (
+ "last_login",
+ models.DateTimeField(
+ blank=True, null=True, verbose_name="last login"
+ ),
+ ),
+ (
+ "is_superuser",
+ models.BooleanField(
+ default=False,
+ help_text="Designates that this user has all permissions without explicitly assigning them.",
+ verbose_name="superuser status",
+ ),
+ ),
+ (
+ "username",
+ models.CharField(
+ error_messages={
+ "unique": "A user with that username already exists."
+ },
+ help_text="Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only.",
+ max_length=150,
+ unique=True,
+ validators=[
+ django.contrib.auth.validators.UnicodeUsernameValidator()
+ ],
+ verbose_name="username",
+ ),
+ ),
+ (
+ "first_name",
+ models.CharField(
+ blank=True, max_length=150, verbose_name="first name"
+ ),
+ ),
+ (
+ "last_name",
+ models.CharField(
+ blank=True, max_length=150, verbose_name="last name"
+ ),
+ ),
+ (
+ "is_staff",
+ models.BooleanField(
+ default=False,
+ help_text="Designates whether the user can log into this admin site.",
+ verbose_name="staff status",
+ ),
+ ),
+ (
+ "is_active",
+ models.BooleanField(
+ default=True,
+ help_text="Designates whether this user should be treated as active. Unselect this instead of deleting accounts.",
+ verbose_name="active",
+ ),
+ ),
+ (
+ "date_joined",
+ models.DateTimeField(
+ default=django.utils.timezone.now, verbose_name="date joined"
+ ),
+ ),
+ (
+ "id",
+ models.UUIDField(
+ default=uuid.uuid4,
+ editable=False,
+ primary_key=True,
+ serialize=False,
+ ),
+ ),
+ ("email", models.EmailField(max_length=254, unique=True)),
+ ("credit", models.IntegerField(default=0)),
+ (
+ "groups",
+ models.ManyToManyField(
+ blank=True,
+ help_text="The groups this user belongs to. A user will get all permissions granted to each of their groups.",
+ related_name="user_set",
+ related_query_name="user",
+ to="auth.group",
+ verbose_name="groups",
+ ),
+ ),
+ (
+ "user_permissions",
+ models.ManyToManyField(
+ blank=True,
+ help_text="Specific permissions for this user.",
+ related_name="user_set",
+ related_query_name="user",
+ to="auth.permission",
+ verbose_name="user permissions",
+ ),
+ ),
],
options={
- 'verbose_name': 'user',
- 'verbose_name_plural': 'users',
- 'abstract': False,
+ "verbose_name": "user",
+ "verbose_name_plural": "users",
+ "abstract": False,
},
managers=[
- ('objects', django.contrib.auth.models.UserManager()),
+ ("objects", django.contrib.auth.models.UserManager()),
],
),
migrations.CreateModel(
- name='File',
+ name="File",
fields=[
- ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
- ('path', models.FileField(upload_to='uploads/%Y/%m/%d')),
- ('number_of_printing', models.IntegerField(default=1)),
- ('para_slicer', models.JSONField(blank=True, null=True)),
- ('filament_id', models.ManyToManyField(to='api.filament')),
- ('user_id', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to=settings.AUTH_USER_MODEL)),
+ (
+ "id",
+ models.UUIDField(
+ default=uuid.uuid4,
+ editable=False,
+ primary_key=True,
+ serialize=False,
+ ),
+ ),
+ ("path", models.FileField(upload_to="uploads/%Y/%m/%d")),
+ ("number_of_printing", models.PositiveIntegerField(default=1)),
+ ("para_slicer", models.JSONField(blank=True, null=True)),
+ (
+ "filament",
+ models.ForeignKey(
+ null=True,
+ on_delete=django.db.models.deletion.CASCADE,
+ to="api.filament",
+ ),
+ ),
],
),
migrations.CreateModel(
- name='Operation',
+ name="Request",
fields=[
- ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
- ('datetime', models.DateTimeField(auto_now_add=True)),
- ('operation_type', models.CharField(choices=[('WITHDRAW', 'Withdraw'), ('ADDING', 'Adding')], max_length=25)),
- ('comment', models.TextField(blank=True, null=True)),
- ('amount', models.PositiveIntegerField(default=0)),
- ('signer_id', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='operation_signer', to=settings.AUTH_USER_MODEL)),
- ('user_id', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='operation_receiver', to=settings.AUTH_USER_MODEL)),
+ (
+ "id",
+ models.UUIDField(
+ default=uuid.uuid4,
+ editable=False,
+ primary_key=True,
+ serialize=False,
+ ),
+ ),
+ ("price", models.PositiveIntegerField(default=0)),
+ ("comment", models.TextField(blank=True, null=True)),
+ ("created_at", models.DateTimeField(auto_now_add=True)),
+ (
+ "status",
+ models.CharField(
+ choices=[
+ ("SUBMITTED", "Submitted"),
+ ("AWAITING_PAYMENT", "Awaiting Payment"),
+ ("PENDING", "Pending"),
+ ("PRINTING", "Printing"),
+ ("AWAITING_PICKUP", "Awaiting Pickup"),
+ ("PICKED_UP", "Picked Up"),
+ ("FAILED", "Failed"),
+ ("CANCELED", "Canceled"),
+ ],
+ default="SUBMITTED",
+ max_length=25,
+ ),
+ ),
+ (
+ "file",
+ models.ForeignKey(
+ null=True,
+ on_delete=django.db.models.deletion.CASCADE,
+ to="api.file",
+ ),
+ ),
+ (
+ "printer",
+ models.ForeignKey(
+ null=True,
+ on_delete=django.db.models.deletion.CASCADE,
+ to="api.printer",
+ ),
+ ),
+ (
+ "user",
+ models.ForeignKey(
+ on_delete=django.db.models.deletion.CASCADE,
+ to=settings.AUTH_USER_MODEL,
+ ),
+ ),
],
),
migrations.CreateModel(
- name='Request',
+ name="Operation",
fields=[
- ('id', models.BigAutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),
- ('datetime', models.DateTimeField(auto_now_add=True)),
- ('status', models.CharField(choices=[('PENDING', 'Pending'), ('PROCESSING', 'Processing'), ('COMPLETED', 'Completed'), ('FAILED', 'Failed')], max_length=25)),
- ('file_id', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, to='api.file')),
- ('printer_id', models.ForeignKey(null=True, on_delete=django.db.models.deletion.CASCADE, to='api.printer')),
+ (
+ "id",
+ models.UUIDField(
+ default=uuid.uuid4,
+ editable=False,
+ primary_key=True,
+ serialize=False,
+ ),
+ ),
+ ("created_at", models.DateTimeField(auto_now_add=True)),
+ (
+ "operation_type",
+ models.CharField(
+ choices=[
+ ("CASH", "Cash"),
+ ("CARD", "Card"),
+ ("PAYMENT", "Payment"),
+ ("REFUND", "Refund"),
+ ],
+ max_length=25,
+ ),
+ ),
+ ("comment", models.TextField(blank=True, null=True)),
+ ("amount", models.IntegerField(default=0)),
+ (
+ "agent",
+ models.ForeignKey(
+ on_delete=django.db.models.deletion.CASCADE,
+ related_name="operation_agent",
+ to=settings.AUTH_USER_MODEL,
+ ),
+ ),
+ (
+ "beneficiary",
+ models.ForeignKey(
+ on_delete=django.db.models.deletion.CASCADE,
+ related_name="operation_beneficiary",
+ to=settings.AUTH_USER_MODEL,
+ ),
+ ),
+ (
+ "request",
+ models.ForeignKey(
+ null=True,
+ on_delete=django.db.models.deletion.CASCADE,
+ to="api.request",
+ ),
+ ),
],
),
]
diff --git a/PrINTech-Back/back/apps/api/migrations/0002_user_priority.py b/PrINTech-Back/back/apps/api/migrations/0002_user_priority.py
new file mode 100644
index 0000000..60343fe
--- /dev/null
+++ b/PrINTech-Back/back/apps/api/migrations/0002_user_priority.py
@@ -0,0 +1,28 @@
+# Generated by Django 6.0.2 on 2026-06-05 10:38
+
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+ dependencies = [
+ ("api", "0001_initial"),
+ ]
+
+ operations = [
+ migrations.AddField(
+ model_name="user",
+ name="priority",
+ field=models.CharField(
+ choices=[
+ ("ADHERENT", "Adherent"),
+ ("ROBOTECH", "Robotech"),
+ ("AUTOTECH", "Autotech"),
+ ("DRONE", "Drone"),
+ ("BUREAU", "Bureau"),
+ ],
+ default="ADHERENT",
+ max_length=25,
+ ),
+ ),
+ ]
diff --git a/PrINTech-Back/back/apps/api/migrations/0003_rename_priority_user_role_user_profile_picture.py b/PrINTech-Back/back/apps/api/migrations/0003_rename_priority_user_role_user_profile_picture.py
new file mode 100644
index 0000000..57a7b77
--- /dev/null
+++ b/PrINTech-Back/back/apps/api/migrations/0003_rename_priority_user_role_user_profile_picture.py
@@ -0,0 +1,28 @@
+# Generated by Django 6.0.2 on 2026-06-06 12:59
+
+import back.apps.api.models
+from django.db import migrations, models
+
+
+class Migration(migrations.Migration):
+
+ dependencies = [
+ ("api", "0002_user_priority"),
+ ]
+
+ operations = [
+ migrations.RenameField(
+ model_name="user",
+ old_name="priority",
+ new_name="role",
+ ),
+ migrations.AddField(
+ model_name="user",
+ name="profile_picture",
+ field=models.ImageField(
+ blank=True,
+ null=True,
+ upload_to=back.apps.api.models.User.profile_pic_path,
+ ),
+ ),
+ ]
diff --git a/PrINTech-Back/back/apps/api/models.py b/PrINTech-Back/back/apps/api/models.py
index 944db9e..83162e4 100644
--- a/PrINTech-Back/back/apps/api/models.py
+++ b/PrINTech-Back/back/apps/api/models.py
@@ -2,45 +2,50 @@
from django.contrib.auth.models import AbstractUser
from django.db import models
+from django.core.validators import RegexValidator
class User(AbstractUser):
+
+ class Role(models.TextChoices):
+ ADHERENT = 'ADHERENT', 'Adherent'
+ ROBOTECH = 'ROBOTECH', 'Robotech'
+ AUTOTECH = 'AUTOTECH', 'Autotech'
+ DRONE = 'DRONE', 'Drone'
+ BUREAU = 'BUREAU', 'Bureau'
+
+ def profile_pic_path(instance, filename):
+ ext = filename.split('.')[-1]
+ return f'profile_pics/{instance.id}.{ext}'
+
id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
email = models.EmailField(blank=False, unique=True, null=False)
credit = models.IntegerField(default=0)
-
+ role = models.CharField(choices=Role.choices, max_length=25, null=False, blank=False, default=Role.ADHERENT)
+ profile_picture = models.ImageField(upload_to=profile_pic_path, null=True, blank=True)
+ USERNAME_FIELD = 'email'
+ REQUIRED_FIELDS = ['username']
class Filament(models.Model):
class Type(models.TextChoices):
PLA = 'PLA'
- REINFORCED_PLA = 'REINFORCED_PLA'
PETG = 'PETG'
- ABS = 'ABS'
- TPE = 'TPE/TPU'
-
- class Color(models.TextChoices):
- RED = 'RED'
- GREEN = 'GREEN'
- YELLOW = 'YELLOW'
- BLUE = 'BLUE'
- MAGENTA = 'MAGENTA'
- WHITE = 'WHITE'
- BLACK = 'BLACK'
- PURPLE = 'PURPLE'
- BROWN = 'BROWN'
- GREY = 'GREY'
- ORANGE = 'ORANGE'
-
- colour = models.CharField(choices=Color.choices, max_length=25, null=False, blank=False)
+
+ color = models.CharField(
+ max_length=7,
+ default='#ffffff',
+ validators=[RegexValidator(r'^#([A-Fa-f0-9]{6}|[A-Fa-f0-9]{3})$')]
+ )
+ color_name = models.TextField(null=False, blank=False)
type = models.CharField(choices=Type.choices, max_length=25, null=False, blank=False)
quantity = models.PositiveIntegerField(default=0)
+ price = models.PositiveIntegerField(default=0)
class File(models.Model):
id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
- user_id=models.ForeignKey(User, on_delete=models.CASCADE)
- filament_id=models.ManyToManyField(Filament)
+ filament=models.ForeignKey(Filament, on_delete=models.CASCADE, null=True)
path = models.FileField(upload_to='uploads/%Y/%m/%d')
number_of_printing = models.PositiveIntegerField(default=1)
para_slicer = models.JSONField(null=True, blank=True)
@@ -53,44 +58,55 @@ class Status(models.TextChoices):
DOWN = 'DOWN'
USED = 'USED'
- class Type(models.TextChoices):
- SLA = 'SLA/DLP/MSLA' #Resin
- SLS = 'SLS/MJF' #Powder
- FDM = 'FDM/FFF' #Filament
- MJP = 'MJP' #MultiJet Printing
- Binder_Jetting = 'Binder_Jetting'
- DMLS = 'DMLS/SLM' #Metal
-
- type = models.CharField(choices=Type.choices, max_length=25, null=False, blank=False)
+ class Name(models.TextChoices):
+ CREALITY_K1C = 'CREALITY_K1C'
+ SNAPMAKER_U1 = 'SNAPMAKER_U1'
+ PRUSA_MK3 = 'PRUSA_MK3'
+
+ name = models.CharField(primary_key=True,choices=Name.choices, max_length=25, null=False, blank=False)
status = models.CharField(choices=Status.choices, max_length=25, null=False, blank=False, default=Status.DOWN)
+
class Request(models.Model):
class Status(models.TextChoices):
+ SUBMITTED = 'SUBMITTED'
+ AWAITING_PAYMENT = 'AWAITING_PAYMENT'
PENDING = 'PENDING'
- PROCESSING = 'PROCESSING'
- COMPLETED = 'COMPLETED'
+ PRINTING = 'PRINTING'
+ AWAITING_PICKUP = 'AWAITING_PICKUP'
+ PICKED_UP = 'PICKED_UP'
FAILED = 'FAILED'
+ CANCELED = 'CANCELED'
id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
- file_id = models.ForeignKey(File, on_delete=models.CASCADE)
- printer_id = models.ForeignKey(Printer, on_delete=models.CASCADE, null=True)
+ user=models.ForeignKey(User, on_delete=models.CASCADE)
+ file = models.ForeignKey(File, on_delete=models.CASCADE, null=True)
+ printer = models.ForeignKey(Printer, on_delete=models.CASCADE, null=True)
+ price = models.PositiveIntegerField(default=0)
+ comment = models.TextField(null=True, blank=True)
created_at = models.DateTimeField(auto_now_add=True)
- status = models.CharField(choices=Status.choices, max_length=25, null=False, blank=False, default=Status.PENDING)
+ status = models.CharField(choices=Status.choices, max_length=25, null=False, blank=False, default=Status.SUBMITTED)
+ @property
+ def is_paid(self):
+ return hasattr(self, 'operation')
class Operation(models.Model):
class Type(models.TextChoices):
CASH = 'CASH'
CARD = 'CARD'
+ PAYMENT = 'PAYMENT'
+ REFUND = 'REFUND'
+
id = models.UUIDField(primary_key=True, default=uuid.uuid4, editable=False)
- beneficiary_id = models.ForeignKey(User, on_delete=models.CASCADE, related_name='operation_beneficiary')
- agent_id = models.ForeignKey(User, on_delete=models.CASCADE, related_name='operation_agent')
+ beneficiary = models.ForeignKey(User, on_delete=models.CASCADE, related_name='operation_beneficiary')
+ agent = models.ForeignKey(User, on_delete=models.CASCADE, related_name='operation_agent')
created_at = models.DateTimeField(auto_now_add=True)
operation_type = models.CharField(choices=Type.choices, max_length=25, null=False, blank=False)
comment = models.TextField(null=True, blank=True)
amount = models.IntegerField(default=0)
-
+ request = models.ForeignKey(Request, on_delete=models.CASCADE, null=True)
diff --git a/PrINTech-Back/back/apps/api/serializers.py b/PrINTech-Back/back/apps/api/serializers.py
index 51786a6..366f5a8 100644
--- a/PrINTech-Back/back/apps/api/serializers.py
+++ b/PrINTech-Back/back/apps/api/serializers.py
@@ -1,6 +1,8 @@
from django.contrib.auth.password_validation import validate_password
from rest_framework import serializers
-from .models import User
+from .models import User, Operation, Request, File, Filament, Printer
+from django.db import transaction
+
class ChangePasswordSerializer(serializers.Serializer):
@@ -46,6 +48,98 @@ def validate_password(self, password):
class Meta:
model = User
- fields = ["id", "username", "password", "email"]
- extra_kwargs = {"password": {"write_only": True}}
+ fields = ["id", "username", "password", "email", "credit", "is_staff", "profile_picture","role"]
+ extra_kwargs = {
+ "password": {"write_only": True},
+ "credit": {"read_only": True},
+ "is_staff": {"read_only": True},
+ "role": {"read_only": True}
+ }
+
+
+class AdminUserSerializer(serializers.ModelSerializer):
+ password = serializers.CharField(write_only=True, required=False)
+
+ class Meta:
+ model = User
+ fields = ["id", "username", "email", "password", "credit", "is_staff", "is_active", "profile_picture", "role"]
+ read_only_fields = ["id"]
+
+ def validate_password(self, password):
+ validate_password(password)
+ return password
+
+ def create(self, validated_data):
+ password = validated_data.pop("password")
+ user = User.objects.create_user(password=password, **validated_data)
+ return user
+
+ def update(self, instance, validated_data):
+ password = validated_data.pop("password", None)
+ for key, value in validated_data.items():
+ setattr(instance, key, value)
+ if password:
+ instance.set_password(password)
+ instance.save()
+ return instance
+
+class OperationSerializer(serializers.ModelSerializer):
+ class Meta:
+ model = Operation
+ fields = ['id', 'beneficiary', 'agent', 'amount', 'operation_type', 'comment', 'created_at','request']
+ read_only_fields = ['agent', 'id', 'created_at']
+
+ def create(self, validated_data):
+ with transaction.atomic():
+ beneficiary = validated_data['beneficiary']
+ amount = validated_data['amount']
+ if amount<0 and beneficiary.credit<-amount:
+ raise serializers.ValidationError("Insufficient funds")
+ beneficiary.credit += amount
+ beneficiary.save()
+ return super().create(validated_data)
+
+
+class FileSerializer(serializers.ModelSerializer):
+ class Meta:
+ model = File
+ fields = ["path", "number_of_printing", "filament", "para_slicer"]
+ read_only_fields = ['id', 'user','status', 'printer', 'created_at', 'status']
+
+class RequestSerializer(serializers.ModelSerializer):
+ file = FileSerializer(many=False, read_only=True)
+ path = serializers.FileField(write_only=True)
+ number_of_printing = serializers.IntegerField(write_only=True, default=1)
+ para_slicer = serializers.JSONField(write_only=True, required=False)
+ filament = serializers.PrimaryKeyRelatedField(
+ write_only=True, queryset=Filament.objects.all(), required=True
+ )
+ class Meta:
+ model = Request
+ fields = ['id', 'user', 'file', 'printer', 'price', 'filament', 'comment', 'created_at','status',"path","number_of_printing", "para_slicer"]
+ read_only_fields = ['id', 'user','file', 'printer', 'price', 'created_at', 'status']
+
+ def create(self, validated_data):
+ path = validated_data.pop('path')
+ number_of_printing = validated_data.pop('number_of_printing')
+ para_slicer = validated_data.pop('para_slicer', {})
+ filament = validated_data.pop('filament', None)
+
+ new_file = File.objects.create(
+ path=path,
+ number_of_printing=number_of_printing,
+ para_slicer=para_slicer,
+ filament=filament
+ )
+ return Request.objects.create(file=new_file, **validated_data)
+
+class FilamentSerializer(serializers.ModelSerializer):
+ class Meta:
+ model = Filament
+ fields = ['id', 'color', 'color_name', 'type', 'quantity']
+
+class PrinterSerializer(serializers.ModelSerializer):
+ class Meta:
+ model = Printer
+ fields = ['name', 'status']
\ No newline at end of file
diff --git a/PrINTech-Back/back/apps/api/tests.py b/PrINTech-Back/back/apps/api/tests.py
index 7ce503c..01337f0 100644
--- a/PrINTech-Back/back/apps/api/tests.py
+++ b/PrINTech-Back/back/apps/api/tests.py
@@ -1,3 +1,797 @@
-from django.test import TestCase
+from django.urls import reverse
+from rest_framework import status
+from rest_framework.test import APITestCase
+from rest_framework_simplejwt.tokens import RefreshToken
+from django.core.files.uploadedfile import SimpleUploadedFile
+from django.contrib.auth import get_user_model
+from PIL import Image
+import io
-# Create your tests here.
+User = get_user_model()
+import json
+from .models import Request, File, Operation, Filament, Printer
+
+class UserMeTests(APITestCase):
+
+ def setUp(self):
+ self.initial_balance = 100
+ self.user = User.objects.create_user(
+ username='scammerrr',
+ password='password123',
+ email='scammer67@intech.com',
+ credit=self.initial_balance
+ )
+ refresh = RefreshToken.for_user(self.user)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+ self.me_url = reverse('user_info')
+
+ def test_user_cannot_update_credit_manually(self):
+ response = self.client.patch(self.me_url, {'credit': 9999})
+ self.assertEqual(response.status_code, status.HTTP_200_OK)
+ self.user.refresh_from_db()
+ self.assertEqual(self.user.credit, self.initial_balance)
+
+ def test_delete_profile_picture_when_none_exists(self):
+ self.user.profile_picture = None
+ self.user.save()
+
+ response = self.client.delete(self.me_url)
+ self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
+ self.assertEqual(response.data['error'], "Aucune photo de profil à supprimer.")
+
+
+class UserChangePasswordDetailedTests(APITestCase):
+
+ def setUp(self):
+ self.user = User.objects.create_user(username='Billy', password='VeryySecure2!', email='mod@intech.com')
+ refresh = RefreshToken.for_user(self.user)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+ self.password_url = reverse('change-password')
+
+ def test_change_password_mismatched_confirmation(self):
+ data = {
+ "old_password": "VeryySecure2!",
+ "new_password": "Passworddd7676767!",
+ "confirm_password": "DifferentPassworddd7676767!"
+ }
+ response = self.client.put(self.password_url, data)
+ self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
+ self.assertIn("non_field_errors", response.data)
+
+ def test_change_password_wrong_old_password(self):
+ data = {
+ "old_password": "WrongPassword1!",
+ "new_password": "BrandNewPassword67!",
+ "confirm_password": "BrandNewPassword67!"
+ }
+ response = self.client.put(self.password_url, data)
+ self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
+ self.assertIn("old_password", response.data)
+
+class AdminUserViewSetTests(APITestCase):
+
+ def setUp(self):
+ self.admin = User.objects.create_user(
+ username='WilliamPrez',
+ password='Adminn123!',
+ email='william@intech.com',
+ is_staff=True
+ )
+ self.regular_user = User.objects.create_user(
+ username='subordinate',
+ password='UserPassword123!',
+ email='zzz@intech.com',
+ credit=10
+ )
+
+ refresh = RefreshToken.for_user(self.admin)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+
+ self.list_url = reverse('admin-user-list')
+ self.detail_url = reverse('admin-user-detail', args=[self.regular_user.id])
+
+ def test_admin_can_list_all_users_sorted_by_email(self):
+ """Admin should get a list of all users, ordered by email address."""
+ response = self.client.get(self.list_url)
+ self.assertEqual(response.status_code, status.HTTP_200_OK)
+ self.assertEqual(len(response.data), 2)
+ self.assertEqual(response.data[0]['email'], self.admin.email) # car w > z
+
+ def test_admin_can_manually_adjust_user_credit(self):
+ """Admin uses AdminUserSerializer which allows direct credit modification."""
+ data = {"credit": 500}
+ response = self.client.patch(self.detail_url, data)
+ self.assertEqual(response.status_code, status.HTTP_200_OK)
+
+ self.regular_user.refresh_from_db()
+ self.assertEqual(self.regular_user.credit, 500)
+
+ def test_admin_can_deactivate_user(self):
+ """Admin can change account status flags like is_active."""
+ data = {"is_active": False}
+ response = self.client.patch(self.detail_url, data)
+ self.assertEqual(response.status_code, status.HTTP_200_OK)
+
+ self.regular_user.refresh_from_db()
+ self.assertFalse(self.regular_user.is_active)
+
+ def test_admin_can_create_user_with_explicit_password(self):
+ """Admin can explicitly create a new valid user profile."""
+ data = {
+ "username": "created_by_admin",
+ "email": "created@intech.com",
+ "password": "ValidPassword123!",
+ "credit": 6767
+ }
+ response = self.client.post(self.list_url, data)
+ self.assertEqual(response.status_code, status.HTTP_201_CREATED)
+
+ new_user = User.objects.get(email="created@intech.com")
+ self.assertTrue(new_user.check_password("ValidPassword123!"))
+
+ def test_regular_user_cannot_access_admin_user_endpoints(self):
+ """Non-staff users must be rejected immediately."""
+ refresh = RefreshToken.for_user(self.regular_user)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+
+ response = self.client.get(self.list_url)
+ self.assertEqual(response.status_code, status.HTTP_403_FORBIDDEN)
+
+class UserProfilePictureTests(APITestCase):
+
+ def setUp(self):
+ self.user = User.objects.create_user(username='CelianTest', password='password123', email='celiantest@intech.com')
+ refresh = RefreshToken.for_user(self.user)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+ self.me_url = reverse('user_info')
+
+ img = Image.new('RGB', (100, 100), color='red')
+ img_bytes = io.BytesIO()
+ img.save(img_bytes, format='JPEG')
+ img_bytes.seek(0) # Avoid blank file read
+ self.test_image = SimpleUploadedFile(
+ name='pp.jpg',
+ content=img_bytes.read(),
+ content_type='image/jpeg'
+ )
+
+ def test_upload_profile_picture(self):
+ response = self.client.patch(self.me_url, {'profile_picture': self.test_image}, format='multipart')
+ self.assertEqual(response.status_code, status.HTTP_200_OK)
+ self.user.refresh_from_db()
+ self.assertTrue(self.user.profile_picture)
+
+ def test_modify_profile_picture(self):
+ self.client.patch(self.me_url, {'profile_picture': self.test_image}, format='multipart')
+ self.user.refresh_from_db()
+ old_name = self.user.profile_picture.name
+
+ new_img = Image.new('RGB', (100, 100), color='blue')
+ new_img_bytes = io.BytesIO()
+ new_img.save(new_img_bytes, format='JPEG')
+ new_image_file = SimpleUploadedFile(name='new_avatar.jpg', content=new_img_bytes.getvalue(), content_type='image/jpeg')
+
+ response = self.client.patch(self.me_url, {'profile_picture': new_image_file}, format='multipart')
+ self.assertEqual(response.status_code, status.HTTP_200_OK)
+ self.user.refresh_from_db()
+
+ self.assertNotEqual(self.user.profile_picture.name, old_name)
+
+ def test_delete_profile_picture(self):
+ self.client.patch(self.me_url, {'profile_picture': self.test_image}, format='multipart')
+
+ response = self.client.delete(self.me_url)
+ self.assertEqual(response.status_code, status.HTTP_200_OK)
+ self.user.refresh_from_db()
+ self.assertFalse(self.user.profile_picture)
+ self.assertTrue(User.objects.filter(id=self.user.id).exists())
+
+ def test_unauthenticated_cannot_upload(self):
+ self.client.credentials()
+ response = self.client.patch(self.me_url, {'profile_picture': self.test_image}, format='multipart')
+ self.assertEqual(response.status_code, status.HTTP_401_UNAUTHORIZED)
+
+class UserRoleAndPriorityTests(APITestCase):
+
+ def setUp(self):
+ # Create an Admin to access admin endpoints
+ self.admin = User.objects.create_user(
+ username='admin_boss',
+ password='Password123!',
+ email='admin@intech.com',
+ is_staff=True
+ )
+
+ # Create users with different roles
+ self.user_bureau = User.objects.create_user(
+ username='bureau_member', password='Password123!', email='bureau@intech.com', role='BUREAU'
+ )
+ self.user_robotech = User.objects.create_user(
+ username='robotech_member', password='Password123!', email='robotech@intech.com', role='ROBOTECH'
+ )
+ self.user_adherent = User.objects.create_user(
+ username='adherent_member', password='Password123!', email='adherent@intech.com', role='ADHERENT'
+ )
+
+ # Create a shared dummy filament and file setup for requests
+ self.filament = Filament.objects.create(
+ color='#FFFFFF', color_name='Blanc', type='PLA', quantity=10
+ )
+ test_file = SimpleUploadedFile(name='role_test.stl', content=b'data', content_type='model/stl')
+ self.file_obj = File.objects.create(path=test_file, number_of_printing=1, filament=self.filament)
+
+ # Authenticate the client as admin for priority testing
+ refresh = RefreshToken.for_user(self.admin)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+ self.admin_request_list_url = reverse('admin-request-list')
+
+ def test_admin_request_list_priority_sorting(self):
+ """
+ Verify that the admin viewset orders requests primarily by priority rank:
+ BUREAU (0) > ROBOTECH/AUTOTECH/DRONE (1) > ADHERENT (2)
+ """
+ # Create requests in mixed/scrambled order of roles
+ req_adherent = Request.objects.create(user=self.user_adherent, status='SUBMITTED', comment="Adherent Req", file=self.file_obj)
+ req_bureau = Request.objects.create(user=self.user_bureau, status='SUBMITTED', comment="Bureau Req", file=self.file_obj)
+ req_robotech = Request.objects.create(user=self.user_robotech, status='SUBMITTED', comment="Robotech Req", file=self.file_obj)
+
+ response = self.client.get(self.admin_request_list_url)
+ self.assertEqual(response.status_code, status.HTTP_200_OK)
+
+ # Extract the comments in order from the response payload
+ returned_comments = [item['comment'] for item in response.data]
+
+ # Assert specific priority rank hierarchy sorting
+ expected_order = ["Bureau Req", "Robotech Req", "Adherent Req"]
+ self.assertEqual(returned_comments, expected_order)
+
+ def test_default_role_is_adherent(self):
+ """Ensure a newly registered user defaults safely to the ADHERENT role."""
+ new_user = User.objects.create_user(
+ username='fresh_user',
+ password='Password123!',
+ email='fresh@intech.com'
+ )
+ self.assertEqual(new_user.role, User.Role.ADHERENT)
+
+
+class UserRoleTests(APITestCase):
+
+ def setUp(self):
+ self.user = User.objects.create_user(
+ username='cel',
+ password='Password123!',
+ email='cel@intech.com',
+ role='ADHERENT'
+ )
+ self.admin = User.objects.create_user(
+ username='sek',
+ password='Password123!',
+ email='sek@intech.com',
+ is_staff=True
+ )
+
+ self.me_url = reverse('user_info')
+ self.admin_user_detail_url = reverse('admin-user-detail', args=[self.user.id])
+
+ def test_regular_user_cannot_change_own_role(self):
+ refresh = RefreshToken.for_user(self.user)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+
+ response = self.client.patch(self.me_url, {'role': 'BUREAU'})
+ self.assertEqual(response.status_code, status.HTTP_200_OK)
+
+ self.user.refresh_from_db()
+ self.assertEqual(self.user.role, 'ADHERENT')
+
+ def test_admin_can_modify_user_role(self):
+ refresh = RefreshToken.for_user(self.admin)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+
+ response = self.client.patch(self.admin_user_detail_url, {'role': 'ROBOTECH'})
+ self.assertEqual(response.status_code, status.HTTP_200_OK)
+
+ self.user.refresh_from_db()
+ self.assertEqual(self.user.role, 'ROBOTECH')
+
+class RequestViewSetTests(APITestCase):
+ def setUp(self):
+ self.initial_balance = 100
+
+ self.user = User.objects.create_user(username='Celian', password='password123', email='celian@intech.com', credit=self.initial_balance)
+ self.user2 = User.objects.create_user(username='Yanis', password='password123', email='yanis@intech.com', credit=self.initial_balance)
+
+ refresh = RefreshToken.for_user(self.user)
+ self.access_token = str(refresh.access_token)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {self.access_token}')
+
+ self.filament = Filament.objects.create(
+ color='#FF0000',
+ color_name='Rouge',
+ type='PLA',
+ quantity=5
+ )
+
+ test_file = SimpleUploadedFile(
+ name='test.stl',
+ content=b'blabla',
+ content_type='model/stl'
+ )
+
+ file = File.objects.create(
+ path=test_file,
+ number_of_printing=1,
+ filament=self.filament
+ )
+
+ self.req_usr1 = Request.objects.create(
+ user=self.user, status='AWAITING_PAYMENT', price=10, comment="Robotech", file=file
+ )
+ self.req_usr2 = Request.objects.create(
+ user=self.user2, status='SUBMITTED', comment="Autotech", file=file
+ )
+
+ self.list_url = reverse('request-list')
+ self.pay_url = reverse('request-pay', args=[self.req_usr1.id])
+ self.cancel_url = reverse('request-cancel', args=[self.req_usr1.id])
+
+ def test_list_requests_authenticated(self):
+ response = self.client.get(self.list_url)
+ self.assertEqual(response.status_code, status.HTTP_200_OK)
+ self.assertEqual(len(response.data), 1)
+ self.assertEqual(response.data[0]['comment'], "Robotech")
+
+ def test_no_access_other_user_request(self):
+ url = reverse('request-detail', args=[self.req_usr2.id])
+ response = self.client.get(url)
+ self.assertEqual(response.status_code, status.HTTP_404_NOT_FOUND)
+
+ def test_cannot_change_status(self):
+ data = {'status': 'PRINTING'}
+ response = self.client.patch(self.list_url, data)
+ self.assertEqual(response.status_code, status.HTTP_405_METHOD_NOT_ALLOWED)
+
+
+ def test_create_request(self):
+
+ test_file = SimpleUploadedFile(
+ name='test.stl',
+ content=b'blabla',
+ content_type='model/stl'
+ )
+
+ data = {
+ "comment": "test",
+ "path": test_file,
+ "number_of_printing": 1,
+ "para_slicer": json.dumps({"layer_height": 0.2, "infill": "20%"}),
+ "filament": self.filament.id
+ }
+ response = self.client.post(self.list_url, data, format='multipart')
+ #response = self.client.post(self.list_url, data)
+ self.assertEqual(response.status_code, status.HTTP_201_CREATED)
+ self.assertEqual(Request.objects.count(), 3)
+
+ def test_missing_token(self):
+ self.client.credentials() # Clear the header
+ response = self.client.get(self.list_url)
+ self.assertEqual(response.status_code, status.HTTP_401_UNAUTHORIZED)
+
+ def test_pay_request_success(self):
+ response = self.client.post(self.pay_url)
+
+ self.assertEqual(response.status_code, status.HTTP_201_CREATED)
+ self.req_usr1.refresh_from_db()
+ self.user.refresh_from_db()
+
+ self.assertEqual(self.req_usr1.status, 'PENDING')
+ expected_balance = self.initial_balance - self.req_usr1.price
+ self.assertEqual(self.user.credit, expected_balance)
+ self.assertEqual(self.req_usr1.operation_set.filter(operation_type='PAYMENT').count(), 1)
+
+ def test_cancel_request_with_refund(self):
+ self.client.post(self.pay_url)
+ response = self.client.post(self.cancel_url)
+ self.assertEqual(response.status_code, status.HTTP_200_OK)
+ self.user.refresh_from_db()
+ self.assertEqual(self.user.credit, self.initial_balance)
+ self.req_usr1.refresh_from_db()
+ self.assertEqual(self.req_usr1.status, 'CANCELED')
+ self.assertEqual(self.req_usr1.operation_set.count(), 2)
+
+ def test_cancel_request_multiple_payments_conflict(self):
+ self.req_usr1.status = 'PENDING'
+ self.req_usr1.save()
+
+ for _ in range(2):
+ Operation.objects.create(
+ beneficiary=self.user, agent=self.user, amount=-10,
+ operation_type='PAYMENT', request=self.req_usr1
+ )
+
+ response = self.client.post(self.cancel_url)
+ self.assertEqual(response.status_code, status.HTTP_409_CONFLICT)
+
+ def test_pay_request_insufficient_funds(self):
+ USER_BALANCE = -1 #always insufficient
+ self.user.credit = USER_BALANCE
+ self.user.save()
+
+ response = self.client.post(self.pay_url)
+ self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
+ self.req_usr1.refresh_from_db()
+ self.assertEqual(self.req_usr1.status, 'AWAITING_PAYMENT')
+ self.user.refresh_from_db()
+ self.assertEqual(self.user.credit, USER_BALANCE)
+
+ def test_pay_request_requires_price(self):
+ self.req_usr1.price = 0
+ self.req_usr1.save()
+
+ response = self.client.post(self.pay_url)
+
+ self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
+ self.assertEqual(response.data['error'], 'Request price is not set.')
+
+ def test_cannot_pay_other_user_request(self):
+ usr2_pay_url = reverse('request-pay', args=[self.req_usr2.id])
+ response = self.client.post(usr2_pay_url)
+ self.assertEqual(response.status_code, status.HTTP_404_NOT_FOUND)
+ self.assertEqual(Operation.objects.filter(request=self.req_usr2).count(), 0)
+
+ def test_cannot_cancel_other_user_request(self):
+ usr2_cancel_url = reverse('request-cancel', args=[self.req_usr2.id])
+ response = self.client.post(usr2_cancel_url)
+ self.assertEqual(response.status_code, status.HTTP_404_NOT_FOUND)
+ self.req_usr2.refresh_from_db()
+ self.assertEqual(self.req_usr2.status, 'SUBMITTED')
+
+class AdminRequestViewTests(APITestCase):
+ def setUp(self):
+ self.admin = User.objects.create_user(
+ username='william',
+ password='password123',
+ email='william@intech.com',
+ is_staff=True
+ )
+
+ refresh = RefreshToken.for_user(self.admin)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+
+ self.filament = Filament.objects.create(
+ color='#FF0000',
+ color_name='Rouge',
+ type='PLA',
+ quantity=5
+ )
+ test_file = SimpleUploadedFile(name='test.stl', content=b'data', content_type='model/stl')
+ self.file_obj = File.objects.create(path=test_file, number_of_printing=1, filament=self.filament)
+
+ self.print_req = Request.objects.create(
+ user=self.admin,
+ status='SUBMITTED',
+ comment="Admin Test",
+ file=self.file_obj
+ )
+
+ self.change_status_url = reverse('admin-request-change-status', args=[self.print_req.id])
+
+ def test_staff_change_status_manually(self):
+ data = {'status': 'PRINTING'}
+ response = self.client.patch(self.change_status_url, data)
+
+ self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
+ self.assertEqual(response.data['error'], 'New requests must move to awaiting payment first.')
+ self.print_req.refresh_from_db()
+ self.assertEqual(self.print_req.status, 'SUBMITTED')
+
+ def test_staff_change_status_auto(self):
+ expected_status = Request.Status.AWAITING_PAYMENT
+
+ response = self.client.patch(self.change_status_url, {'price': 25})
+
+ self.assertEqual(response.status_code, status.HTTP_200_OK)
+ self.print_req.refresh_from_db()
+ self.assertEqual(self.print_req.status, expected_status)
+ self.assertEqual(self.print_req.price, 25)
+
+ def test_staff_cannot_auto_skip_payment(self):
+ self.print_req.status = Request.Status.AWAITING_PAYMENT
+ self.print_req.save()
+
+ response = self.client.patch(self.change_status_url, {})
+
+ self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
+ self.assertEqual(response.data['error'], 'Request is waiting for user payment.')
+
+ def test_staff_must_set_price_for_awaiting_payment(self):
+ response = self.client.patch(self.change_status_url, {'status': 'AWAITING_PAYMENT'})
+
+ self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
+ self.assertEqual(response.data['error'], 'A price is required before setting awaiting payment.')
+
+ def test_staff_change_status_auto_limit(self):
+ statuses = Request.Status.values
+ self.print_req.status = statuses[-2]
+ self.print_req.save()
+
+ response = self.client.patch(self.change_status_url, {})
+ self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
+ self.assertEqual(response.data['error'], 'Already Completed.')
+
+ def test_non_staff_access(self):
+ user = User.objects.create_user(username='Ilo', password='password123')
+ refresh = RefreshToken.for_user(user)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+
+ response = self.client.patch(self.change_status_url, {'status': 'PRINTING'})
+ self.assertEqual(response.status_code, status.HTTP_403_FORBIDDEN)
+
+
+class UserOperationTests(APITestCase):
+ def setUp(self):
+ self.initial_balance = 100
+ self.user1 = User.objects.create_user(
+ username='Celian',
+ password='password123',
+ email='celian@intech.com',
+ credit=self.initial_balance
+ )
+ self.user2 = User.objects.create_user(
+ username='Yanis',
+ password='password123',
+ email='yanis@intech.com',
+ credit=self.initial_balance
+ )
+
+ self.admin = User.objects.create_user(
+ username='William',
+ password='password123',
+ email='william@intech.com',
+ is_staff=True
+ )
+
+ refresh = RefreshToken.for_user(self.user1)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {str(refresh.access_token)}')
+
+ Operation.objects.create(
+ beneficiary=self.user1,
+ agent=self.admin,
+ amount=20,
+ operation_type='CASH'
+ )
+
+
+ self.url = reverse('operation-list')
+
+ def test_user_list_own_operations_only(self):
+ Operation.objects.create(
+ beneficiary=self.user2,
+ agent=self.admin,
+ amount=50,
+ operation_type='CASH'
+ )
+
+ response = self.client.get(self.url)
+ self.assertEqual(response.status_code, status.HTTP_200_OK)
+ self.assertEqual(len(response.data), 1)
+ self.assertEqual(response.data[0]['amount'], 20)
+
+ def test_user_cannot_create_operation(self):
+ data = {"beneficiary": self.user1, "amount": 100, "operation_type": "CASH"}
+ response = self.client.post(self.url, data)
+ self.assertEqual(response.status_code, status.HTTP_405_METHOD_NOT_ALLOWED)
+
+
+class AdminOperationTests(APITestCase):
+ def setUp(self):
+ self.initial_balance = 100
+ self.admin = User.objects.create_user(
+ username='Celian',
+ password='password123',
+ email='celian@intech.com',
+ is_staff=True
+ )
+ self.beneficiary = User.objects.create_user(
+ username='Ilo',
+ password='password123',
+ email='ilo@test.com',
+ credit=self.initial_balance
+ )
+
+ refresh = RefreshToken.for_user(self.admin)
+ self.access_token = str(refresh.access_token)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {self.access_token}')
+
+ self.url = reverse('admin-operation-list')
+
+ def test_admin_deposit_cash(self):
+ change = 50
+ data = {
+ "beneficiary": self.beneficiary.id,
+ "amount": change,
+ "operation_type": "CASH"
+ }
+ response = self.client.post(self.url, data)
+ self.assertEqual(response.status_code, status.HTTP_201_CREATED)
+
+ self.beneficiary.refresh_from_db()
+ self.assertEqual(self.beneficiary.credit, self.initial_balance + change)
+
+ def test_admin_insufficient_funds(self):
+ data = {
+ "beneficiary": self.beneficiary.id,
+ "amount": -150,
+ "operation_type": "PAYMENT"
+ }
+ response = self.client.post(self.url, data)
+ self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
+
+ def test_admin_list(self):
+ Operation.objects.create(
+ beneficiary=self.beneficiary,
+ agent=self.admin,
+ amount=10,
+ operation_type='CASH'
+ )
+
+ response = self.client.get(self.url)
+ self.assertEqual(response.status_code, status.HTTP_200_OK)
+ self.assertTrue(len(response.data) >= 1)
+
+
+class FilamentTests(APITestCase):
+ def setUp(self):
+ self.initial_balance=100
+ self.user = User.objects.create_user(
+ username='Celian',
+ password='password123',
+ email='celian@intech.com',
+ credit=self.initial_balance
+ )
+
+ self.admin = User.objects.create_user(
+ username='William',
+ password='password123',
+ email='william@intech.com',
+ is_staff=True
+ )
+
+ # Create initial data
+ self.filament = Filament.objects.create(
+ color='#FF0000',
+ color_name='Rouge',
+ type='PLA',
+ quantity=5
+ )
+
+ self.public_list_url = reverse('filament-list')
+ self.admin_list_url = reverse('filament-admin-list')
+ self.admin_detail_url = reverse('filament-admin-detail', args=[self.filament.id])
+
+
+ def test_user_can_list_filaments(self):
+ refresh = RefreshToken.for_user(self.user)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+
+ response = self.client.get(self.public_list_url)
+ self.assertEqual(response.status_code, status.HTTP_200_OK)
+ self.assertEqual(len(response.data), 1)
+ self.assertEqual(response.data[0]['color_name'], 'Rouge')
+
+ def test_user_cannot_create_filament(self):
+ """ReadOnlyModelViewSet should block POST requests from regular users."""
+ refresh = RefreshToken.for_user(self.user)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+
+ data = {"color": "#00FF00", "color_name": "Green", "type": "PETG", "quantity": 10}
+ response = self.client.post(self.public_list_url, data)
+ self.assertEqual(response.status_code, status.HTTP_405_METHOD_NOT_ALLOWED)
+
+ def test_user_cannot_access_admin_endpoint(self):
+ refresh = RefreshToken.for_user(self.user)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+
+ response = self.client.get(self.admin_list_url)
+ self.assertEqual(response.status_code, status.HTTP_403_FORBIDDEN)
+
+
+ def test_admin_create_filament(self):
+ refresh = RefreshToken.for_user(self.admin)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+
+ data = {
+ "color": "#0000FF",
+ "color_name": "Bleu",
+ "type": "PLA",
+ "quantity": 5
+ }
+ response = self.client.post(self.admin_list_url, data)
+ self.assertEqual(response.status_code, status.HTTP_201_CREATED)
+ self.assertEqual(Filament.objects.count(), 2)
+
+ def test_admin_can_update_quantity(self):
+ refresh = RefreshToken.for_user(self.admin)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+
+ data = {"quantity": 67}
+ response = self.client.patch(self.admin_detail_url, data)
+
+ self.assertEqual(response.status_code, status.HTTP_200_OK)
+ self.filament.refresh_from_db()
+ self.assertEqual(self.filament.quantity, 67)
+
+ def test_invalid_hex_code(self):
+ refresh = RefreshToken.for_user(self.admin)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+
+ data = {
+ "color": "NOT A HEX CODE",
+ "color_name": "blabla",
+ "type": "PLA",
+ "quantity": 1
+ }
+ response = self.client.post(self.admin_list_url, data)
+ self.assertEqual(response.status_code, status.HTTP_400_BAD_REQUEST)
+
+ def test_admin_delete_filament(self):
+ refresh = RefreshToken.for_user(self.admin)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+
+ response = self.client.delete(self.admin_detail_url)
+ self.assertEqual(response.status_code, status.HTTP_204_NO_CONTENT)
+ self.assertEqual(Filament.objects.count(), 0)
+
+class PrinterViewTests(APITestCase):
+ def setUp(self):
+ self.user = User.objects.create_user(username='Celian', password='password123', email='celian@intech.com')
+ self.admin = User.objects.create_user(username='William', password='password123', email='william@intech.com', is_staff=True)
+
+ for printer in Printer.Name.values:
+ Printer.objects.get_or_create(name=printer)
+
+ self.public_list_url = reverse('printer-list')
+ self.admin_list_url = reverse('admin-printer-list')
+ self.printer = Printer.objects.first()
+ self.admin_detail_url = reverse('admin-printer-detail', args=[self.printer.name])
+
+ def test_list_printers(self):
+ refresh = RefreshToken.for_user(self.user)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+ response = self.client.get(self.public_list_url)
+ self.assertEqual(response.status_code, status.HTTP_200_OK)
+ self.assertEqual(len(response.data), 3)
+
+ def test_readonly(self):
+ data = {'status': 'UP'}
+ response = self.client.patch(self.public_list_url, data)
+ self.assertEqual(response.status_code, status.HTTP_405_METHOD_NOT_ALLOWED)
+
+ def test_admin_update_printer_status(self):
+ refresh = RefreshToken.for_user(self.admin)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+ data = {'status': 'UP'}
+ response = self.client.patch(self.admin_detail_url, data)
+ self.assertEqual(response.status_code, status.HTTP_200_OK)
+ self.printer.refresh_from_db()
+ self.assertEqual(self.printer.status, 'UP')
+
+ def test_admin_access(self):
+ refresh = RefreshToken.for_user(self.user)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+ data = {'status': 'UP'}
+ response = self.client.patch(self.admin_detail_url, data)
+ self.assertEqual(response.status_code, status.HTTP_403_FORBIDDEN)
+
+ def test_admin_cannot_create_printer(self):
+ refresh = RefreshToken.for_user(self.admin)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+ data = {'name': 'CREALITY_K1C', 'status': 'UP'}
+ response = self.client.post(self.admin_list_url, data)
+ self.assertEqual(response.status_code, status.HTTP_405_METHOD_NOT_ALLOWED)
+
+ def test_admin_cannot_delete_printer(self):
+ refresh = RefreshToken.for_user(self.admin)
+ self.client.credentials(HTTP_AUTHORIZATION=f'Bearer {refresh.access_token}')
+ response = self.client.delete(self.admin_detail_url)
+ self.assertEqual(response.status_code, status.HTTP_405_METHOD_NOT_ALLOWED)
\ No newline at end of file
diff --git a/PrINTech-Back/back/apps/api/views.py b/PrINTech-Back/back/apps/api/views.py
index d7fa2fc..028452e 100644
--- a/PrINTech-Back/back/apps/api/views.py
+++ b/PrINTech-Back/back/apps/api/views.py
@@ -1,11 +1,15 @@
from rest_framework.response import Response
from rest_framework_simplejwt.tokens import RefreshToken, AccessToken
-from .models import User
-from rest_framework import permissions, viewsets, generics, status
+from .models import User, Operation, Request, Filament, Printer
+from django.db.models import Case, When, IntegerField, Value
+from rest_framework import permissions, viewsets, mixins, generics, status, serializers
+from rest_framework.decorators import action
from django.shortcuts import render
-from rest_framework.permissions import AllowAny, IsAuthenticated
+from rest_framework.permissions import AllowAny, IsAuthenticated,IsAdminUser
from rest_framework.throttling import UserRateThrottle
-from .serializers import UserSerializer, ChangePasswordSerializer
+from .serializers import UserSerializer, ChangePasswordSerializer, OperationSerializer, RequestSerializer,FilamentSerializer, PrinterSerializer
+from .serializers import AdminUserSerializer
+from django.db import transaction
class CreateUserView(generics.CreateAPIView):
queryset = User.objects.all()
@@ -34,7 +38,7 @@ def create(self, request, *args, **kwargs):
)
-class UserMeView(generics.RetrieveUpdateAPIView):
+class UserMeView(generics.RetrieveUpdateDestroyAPIView):
permission_classes = [IsAuthenticated]
serializer_class = UserSerializer
throttle_classes = [UserRateThrottle]
@@ -42,6 +46,16 @@ class UserMeView(generics.RetrieveUpdateAPIView):
def get_object(self):
return self.request.user
+ def destroy(self, request, *args, **kwargs):
+ """Deletes ONLY profile picture, not the user account."""
+ user = self.get_object()
+ if user.profile_picture:
+ user.profile_picture.delete(save=False)
+ user.profile_picture = None
+ user.save()
+ return Response({"message": "Photo de profil supprimée avec succès."}, status=status.HTTP_200_OK)
+ return Response({"error": "Aucune photo de profil à supprimer."}, status=status.HTTP_400_BAD_REQUEST)
+
class ChangePasswordView(generics.UpdateAPIView):
permission_classes = [IsAuthenticated]
serializer_class = ChangePasswordSerializer
@@ -56,3 +70,287 @@ def update(self, request, *args, **kwargs):
{"message": "Mot de passe changé avec succès."}, status=status.HTTP_200_OK
)
+class OperationView(mixins.ListModelMixin,
+ mixins.RetrieveModelMixin,
+ viewsets.GenericViewSet):
+ serializer_class = OperationSerializer
+ permission_classes = [permissions.IsAuthenticated]
+
+ def get_queryset(self):
+ return Operation.objects.filter(beneficiary=self.request.user)
+
+class AdminOperationView(mixins.CreateModelMixin,
+ mixins.ListModelMixin,
+ mixins.RetrieveModelMixin,
+ viewsets.GenericViewSet):
+ serializer_class = OperationSerializer
+ permission_classes = [permissions.IsAdminUser]
+ queryset = Operation.objects.all()
+
+ def perform_create(self, serializer):
+ serializer.save(agent=self.request.user)
+
+class RequestView(mixins.CreateModelMixin,
+ mixins.ListModelMixin,
+ mixins.RetrieveModelMixin,
+ viewsets.GenericViewSet):
+ serializer_class = RequestSerializer
+ permission_classes=[IsAuthenticated]
+ def get_queryset(self):
+ return Request.objects.filter(user=self.request.user)
+
+ def perform_create(self, serializer):
+ serializer.save(user=self.request.user, status='SUBMITTED')
+
+ @transaction.atomic
+ @action(detail=True, methods=['post'])
+ def relaunch(self, request, pk=None):
+ previous_request = self.get_object()
+
+ if previous_request.file is None:
+ return Response(
+ {"error": "Cannot relaunch a request without file."},
+ status=status.HTTP_400_BAD_REQUEST,
+ )
+
+ relaunched_request = Request.objects.create(
+ user=request.user,
+ file=previous_request.file,
+ printer=None,
+ comment=previous_request.comment,
+ status='SUBMITTED',
+ )
+
+ serializer = self.get_serializer(relaunched_request)
+ return Response(serializer.data, status=status.HTTP_201_CREATED)
+
+ @transaction.atomic
+ @action(detail=True, methods=['post'])
+ def pay(self, request, pk=None):
+ print_request = self.get_object()
+
+ if print_request.status != 'AWAITING_PAYMENT':
+ return Response(
+ {"error": "Request not awaiting payment."},
+ status=status.HTTP_400_BAD_REQUEST
+ )
+
+ price = print_request.price
+ if price <= 0:
+ return Response(
+ {"error": "Request price is not set."},
+ status=status.HTTP_400_BAD_REQUEST
+ )
+
+ data = {
+ "beneficiary": request.user.id,
+ "amount": -price,
+ "operation_type": "PAYMENT",
+ "request": print_request.id
+ }
+
+ serializer = OperationSerializer(data=data)
+ if serializer.is_valid():
+ serializer.save(agent=request.user)
+ print_request.status = 'PENDING'
+ print_request.save()
+ return Response(status=201)
+ return Response(serializer.errors, status=400)
+
+ @transaction.atomic
+ @action(detail=True, methods=['post'])
+ def cancel(self, request, pk=None):
+ print_request = self.get_object()
+
+ allowed_cancel = ['SUBMITTED','AWAITING_PAYMENT', 'PENDING']
+
+ if print_request.status not in allowed_cancel:
+ return Response(
+ {"error": f"Cannot cancel for status: {print_request.status}"},
+ status=status.HTTP_400_BAD_REQUEST
+ )
+
+ if print_request.status == 'PENDING':
+ #Operation default related_name: `operation_set`
+ payments = print_request.operation_set.filter(
+ operation_type=Operation.Type.PAYMENT
+ )
+
+ if payments.count() > 1:
+ return Response(
+ {"error": "Cannot refund"},
+ status=status.HTTP_409_CONFLICT
+ )
+ elif payments.count() == 1:
+ payment = payments.first()
+ refund_amount = abs(payment.amount)
+
+ data = {
+ "beneficiary": print_request.user.id,
+ "amount": refund_amount,
+ "operation_type": "REFUND",
+ "request": print_request.id,
+ "comment": f"Refund for cancellation of request {print_request.id}"
+ }
+
+ serializer = OperationSerializer(data=data)
+ if serializer.is_valid():
+ serializer.save(agent=request.user)
+ else:
+ return Response(serializer.errors, status=status.HTTP_400_BAD_REQUEST)
+
+ print_request.status = 'CANCELED'
+ print_request.save()
+
+ return Response({"status": "Request canceled successfully"}, status=status.HTTP_200_OK)
+
+class AdminRequestView(viewsets.ReadOnlyModelViewSet):
+ serializer_class = RequestSerializer
+ permission_classes=[IsAdminUser]
+
+ def get_queryset(self):
+ # BUREAU highest (0), project types equal (1), ADHERENT lowest (2)
+ qs = Request.objects.all().annotate(
+ priority_rank=Case(
+ When(user__role='BUREAU', then=Value(0)),
+ When(user__role='ROBOTECH', then=Value(1)),
+ When(user__role='AUTOTECH', then=Value(1)),
+ When(user__role='DRONE', then=Value(1)),
+ When(user__role='ADHERENT', then=Value(2)),
+ default=Value(3),
+ output_field=IntegerField(),
+ )
+ ).order_by('priority_rank', '-created_at')
+ return qs
+
+ @transaction.atomic
+ @action(detail=True, methods=['patch'])
+ def change_status(self, request, pk):
+ print_request = self.get_object()
+ new_status = request.data.get('status')
+ price = request.data.get('price')
+ current_status = str(print_request.status)
+ statuses = Request.Status.values
+
+ if current_status == Request.Status.SUBMITTED and new_status and new_status != Request.Status.AWAITING_PAYMENT:
+ return Response(
+ {'error': 'New requests must move to awaiting payment first.'},
+ status=status.HTTP_400_BAD_REQUEST
+ )
+
+ if current_status == Request.Status.AWAITING_PAYMENT:
+ if not new_status:
+ return Response(
+ {'error': 'Request is waiting for user payment.'},
+ status=status.HTTP_400_BAD_REQUEST
+ )
+ if new_status != Request.Status.AWAITING_PAYMENT:
+ return Response(
+ {'error': 'Request must be paid before advancing status.'},
+ status=status.HTTP_400_BAD_REQUEST
+ )
+
+ if current_status in [Request.Status.SUBMITTED, Request.Status.AWAITING_PAYMENT] and new_status == Request.Status.AWAITING_PAYMENT:
+ if price is None:
+ return Response(
+ {'error': 'A price is required before setting awaiting payment.'},
+ status=status.HTTP_400_BAD_REQUEST
+ )
+
+ try:
+ price = int(price)
+ except (TypeError, ValueError):
+ return Response(
+ {'error': 'Invalid price.'},
+ status=status.HTTP_400_BAD_REQUEST
+ )
+
+ if price <= 0:
+ return Response(
+ {'error': 'Price must be greater than zero.'},
+ status=status.HTTP_400_BAD_REQUEST
+ )
+
+ print_request.price = price
+
+ if not new_status:
+ current_index = statuses.index(current_status)
+
+ if current_status == Request.Status.SUBMITTED:
+ new_status = Request.Status.AWAITING_PAYMENT
+ else:
+ # Cannot autochange to ERROR/CANCELED.
+ ERROR_STATUS_COUNT = 2
+ if current_index < len(statuses) - ERROR_STATUS_COUNT - 1:
+ new_status = statuses[current_index + 1]
+ else:
+ return Response(
+ {'error': 'Already Completed.'},
+ status=status.HTTP_400_BAD_REQUEST
+ )
+
+ if new_status == Request.Status.AWAITING_PAYMENT:
+ if price is None:
+ return Response(
+ {'error': 'A price is required before setting awaiting payment.'},
+ status=status.HTTP_400_BAD_REQUEST
+ )
+
+ try:
+ price = int(price)
+ except (TypeError, ValueError):
+ return Response(
+ {'error': 'Invalid price.'},
+ status=status.HTTP_400_BAD_REQUEST
+ )
+
+ if price <= 0:
+ return Response(
+ {'error': 'Price must be greater than zero.'},
+ status=status.HTTP_400_BAD_REQUEST
+ )
+
+ print_request.price = price
+
+ if new_status not in statuses:
+ return Response(
+ {'error': f'Invalid status: {new_status}'},
+ status=status.HTTP_400_BAD_REQUEST
+ )
+
+
+ print_request.status = new_status
+ print_request.save()
+
+ serializer = self.get_serializer(print_request)
+ return Response(serializer.data)
+
+
+class AdminUserView(viewsets.ModelViewSet):
+ queryset = User.objects.all().order_by('email')
+ serializer_class = AdminUserSerializer
+ permission_classes = [IsAdminUser]
+
+
+class FilamentView(viewsets.ReadOnlyModelViewSet):
+ queryset = Filament.objects.all()
+ serializer_class = FilamentSerializer
+ permission_classes = [permissions.AllowAny]
+
+class AdminFilamentView(viewsets.ModelViewSet):
+ queryset = Filament.objects.all()
+ serializer_class = FilamentSerializer
+ permission_classes = [permissions.IsAdminUser]
+
+class PrinterView(viewsets.ReadOnlyModelViewSet):
+ queryset = Printer.objects.all()
+ serializer_class = PrinterSerializer
+ permission_classes = [permissions.AllowAny]
+
+class AdminPrinterView(mixins.UpdateModelMixin,
+ mixins.RetrieveModelMixin,
+ mixins.ListModelMixin,
+ viewsets.GenericViewSet):
+ queryset = Printer.objects.all()
+ serializer_class = PrinterSerializer
+ permission_classes = [permissions.IsAdminUser]
\ No newline at end of file
diff --git a/PrINTech-Back/__init__.py b/PrINTech-Back/back/migrations/__init__.py
similarity index 100%
rename from PrINTech-Back/__init__.py
rename to PrINTech-Back/back/migrations/__init__.py
diff --git a/PrINTech-Back/back/settings/base.py b/PrINTech-Back/back/settings/base.py
index f58712a..90613e7 100644
--- a/PrINTech-Back/back/settings/base.py
+++ b/PrINTech-Back/back/settings/base.py
@@ -112,7 +112,7 @@
LOCAL_APPS = [
'back',
- 'back.apps.api',
+ 'back.apps.api.apps.ApiConfig',
]
INSTALLED_APPS = DJANGO_APPS + THIRD_PARTY_APPS + LOCAL_APPS
diff --git a/PrINTech-Back/back/urls.py b/PrINTech-Back/back/urls.py
index 62e7194..5ad2fd5 100644
--- a/PrINTech-Back/back/urls.py
+++ b/PrINTech-Back/back/urls.py
@@ -1,15 +1,37 @@
from django.conf import settings
from django.contrib import admin
from django.urls import include, path
-from rest_framework import routers, permissions
+from django.conf.urls.static import static
+from rest_framework.routers import DefaultRouter
from drf_spectacular.views import SpectacularAPIView, SpectacularSwaggerView, SpectacularRedocView
from rest_framework_simplejwt.views import TokenObtainPairView, TokenRefreshView
-from .apps.api.views import CreateUserView, UserMeView, ChangePasswordView
-from .views import home
-admin.autodiscover()
+from .apps.api.views import (
+ CreateUserView,
+ UserMeView,
+ ChangePasswordView,
+ OperationView,
+ AdminOperationView,
+ RequestView,
+ AdminRequestView,
+ AdminUserView,
+ FilamentView,
+ AdminFilamentView,
+ PrinterView,
+ AdminPrinterView,
+)
+from .views import home
-router = routers.DefaultRouter()
+router = DefaultRouter()
+router.register(r'requests', RequestView, basename='request')
+router.register(r'admin/requests', AdminRequestView, basename='admin-request')
+router.register(r'admin/users', AdminUserView, basename='admin-user')
+router.register(r'operations', OperationView, basename='operation')
+router.register(r'admin/operations', AdminOperationView, basename='admin-operation')
+router.register(r'filaments', FilamentView, basename='filament')
+router.register(r'admin/filaments', AdminFilamentView, basename='filament-admin')
+router.register(r'printers', PrinterView, basename='printer')
+router.register(r'admin/printers', AdminPrinterView, basename='admin-printer')
urlpatterns = [
# Examples:
@@ -31,9 +53,9 @@
path('admin/', admin.site.urls),
]
-# debug toolbar for dev
-if settings.DEBUG and 'debug_toolbar'in settings.INSTALLED_APPS:
+if settings.DEBUG and 'debug_toolbar' in settings.INSTALLED_APPS:
import debug_toolbar
- urlpatterns += [
- path('__debug__/', include(debug_toolbar.urls)),
- ]
+ urlpatterns += [path('__debug__/', include(debug_toolbar.urls))]
+
+if settings.DEBUG:
+ urlpatterns += static(settings.MEDIA_URL, document_root=settings.MEDIA_ROOT)
\ No newline at end of file
diff --git a/PrINTech-Back/back/wsgi.py b/PrINTech-Back/back/wsgi.py
index d2777c2..3a57d9d 100644
--- a/PrINTech-Back/back/wsgi.py
+++ b/PrINTech-Back/back/wsgi.py
@@ -11,6 +11,6 @@
from django.core.wsgi import get_wsgi_application
-os.environ.setdefault("DJANGO_SETTINGS_MODULE", "back.settings.{{ goal }}")
+os.environ.setdefault("DJANGO_SETTINGS_MODULE", "back.settings.dev")
application = get_wsgi_application()
diff --git a/PrINTech-Back/manage.py b/PrINTech-Back/manage.py
index 775faa1..f57e38f 100644
--- a/PrINTech-Back/manage.py
+++ b/PrINTech-Back/manage.py
@@ -3,8 +3,7 @@
import sys
if __name__ == "__main__":
- os.environ.setdefault("DJANGO_SETTINGS_MODULE", "back.settings.{{ goal }}")
-
+ os.environ.setdefault("DJANGO_SETTINGS_MODULE", "back.settings.dev")
from django.core.management import execute_from_command_line
execute_from_command_line(sys.argv)
diff --git a/PrINTech-Back/patch_html.html b/PrINTech-Back/patch_html.html
new file mode 100644
index 0000000..c559464
--- /dev/null
+++ b/PrINTech-Back/patch_html.html
@@ -0,0 +1,42 @@
+
Voici l'état de vos impressions et du parc d'imprimantes.
+
+
+
+
+
+
+
+
Nos imprimantes
+
Trois machines complémentaires pour des impressions rapides, propres et fiables.
+
+
+
+
+
+
+
Creality K1C
+
+ Imprimante FDM rapide idéale pour le prototypage quotidien. Elle offre une bonne
+ qualité de surface et des temps d'impression courts pour les pièces fonctionnelles.
+
+
+
Haute vitesse d'impression
+
Très bon choix pour PLA, PETG et TPU
+
Parfaite pour les itérations rapides
+
+
+
+
+
+
+
+
Snapmaker U1
+
+ Machine polyvalente orientée précision et stabilité. Adaptée aux impressions plus
+ techniques, avec un excellent rendu sur les pièces détaillées.
+
+
+
Grande précision sur les petits détails
+
Très bon comportement sur pièces techniques
+
Bonne régularité pour les impressions longues
+
+
+
+
+
+
+
+
Prusa i3 MK3
+
+ Imprimante reconnue pour sa fiabilité et sa qualité d'impression constante. Idéale pour
+ des pièces précises, des longues sessions d'impression et un excellent rendu global.
+
+ 
+