archinsa/readme.md

# Arch'insa
Ce site a pour but à therme de remplacer le site actuel des annales de L'INSA Toulouse, avec une recherche par themes/classes/temps de résolution, la possibilité de prendre directement des photos de son exercice pour le téléverser et d'envoyer toutes sortes de supports tels que des fiches de cours. Des commentaires seront aussi disponibles pour les auteurs pour donner un contexte ou des indications sur un exercice en particulier, ou un paquet de documents en entier.
D'autres fonctionnalités seront ajoutées petit à petit. (si vous avez des suggestions, n'hésitez pas à contacter le club info ou moi directement)


## structure bdd
### Table: themes

| Column | Type            | Constraints              |
|--------|-----------------|--------------------------|
| id     | INT             | AUTO_INCREMENT, PRIMARY KEY |
| name   | VARCHAR(255)    | NOT NULL                 |

### Table: exercices_themes

| Column       | Type   | Constraints                               |
|--------------|--------|-------------------------------------------|
| exercice_id  | INT    | FOREIGN KEY (exercice_id) REFERENCES exercises(id) |
| ensemble_id  | INT    | FOREIGN KEY (ensemble_id) REFERENCES ensembles(id) |
| theme_id     | INT    | FOREIGN KEY (theme_id) REFERENCES themes(id) |
| id           | INT    | AUTO_INCREMENT, PRIMARY KEY                |

### Table: exercices

| Column             | Type          | Constraints                              |
|--------------------|---------------|------------------------------------------|
| id                 | INT           | AUTO_INCREMENT, PRIMARY KEY              |
| commentaire_auteur | TEXT          |                                          |
| ensemble_id        | INT           | FOREIGN KEY (ensemble_id) REFERENCES ensembles(id) |
| document_id        | INT           | FOREIGN KEY (document_id) REFERENCES documents(id)
| duree              | INT           |                                          |
(la durée est en minutes)

### Table: ensembles

| Column             | Type          | Constraints                              |
|--------------------|---------------|------------------------------------------|
| id                 | INT           | AUTO_INCREMENT                           |
| commentaire_auteur | TEXT          |                                          |
| valide             | BOOLEAN       | NOT NULL                                 |
| corrige_inclu      | BOOLEAN       | DEFAULT NULL                             |
| date_televersement | DATE          | DEFAULT CURRENT_TIMESTAMP                |
| date_conception    | VARCHAR(9)    |                                          |


> le champ "corrige_inclu" ne sera utilisé que pour des annales

### Table: documents

| Column             | Type          | Constraints                              |
|--------------------|---------------|------------------------------------------|
| id                 | INT           | AUTO_INCREMENT, PRIMARY KEY              |
| titre              | VARCHAR(255)  | NOT NULL                                 |
| type               | INT           |                                          |
| upload_path        | TEXT          | NOT NULL                                 |
| commentaire_auteur | TEXT          |                                          |
| ensemble_id        | INT           | FOREIGN KEY (ensemble_id) REFERENCES ensemble(id) |
| theme_id           | INT           | FOREIGN KEY (theme_id) REFERENCES themes(id) |


## TOUDOU : 
> Tester le code qui a été séparé en plusieurs fichiers différents (les pages pour utilisateurs)


### téléverser.php :

- tout pack dans un json à l'envoi : 
``    
let ex = [{duree:"10",themes:["algèbre","analyse"],commentaire_exo:"cci est un commenataire"},{duree:"15",themes:["elec analogique"],commentaire_exo:""}]; 
; 
``
 
### _partials/_head.php
- définir la variable $titre_page avant de l'inclure
- va s'occuper de generer tout ce qu'on met dans les tags <head> ainsi que d'importer un fichier css du même nom que la page depuis css/<page>.css (s'il existe)
### _partials/_footer.php
- tout ce qu'on veut faire en fin de chargement de page
- va inclure un script depuis js/<page>.js (s'il existe).
premier commit 2023-10-22 19:24:59 +02:00			`# Arch'insa`
			`Ce site a pour but à therme de remplacer le site actuel des annales de L'INSA Toulouse, avec une recherche par themes/classes/temps de résolution, la possibilité de prendre directement des photos de son exercice pour le téléverser et d'envoyer toutes sortes de supports tels que des fiches de cours. Des commentaires seront aussi disponibles pour les auteurs pour donner un contexte ou des indications sur un exercice en particulier, ou un paquet de documents en entier.`
			`D'autres fonctionnalités seront ajoutées petit à petit. (si vous avez des suggestions, n'hésitez pas à contacter le club info ou moi directement)`


			`## structure bdd`
			`### Table: themes`

			`\| Column \| Type \| Constraints \|`
			`\|--------\|-----------------\|--------------------------\|`
			`\| id \| INT \| AUTO_INCREMENT, PRIMARY KEY \|`
			`\| name \| VARCHAR(255) \| NOT NULL \|`

			`### Table: exercices_themes`

			`\| Column \| Type \| Constraints \|`
			`\|--------------\|--------\|-------------------------------------------\|`
			`\| exercice_id \| INT \| FOREIGN KEY (exercice_id) REFERENCES exercises(id) \|`
bouton suppression d'ensembles en attente de validation 2023-12-23 22:02:14 +01:00			`\| ensemble_id \| INT \| FOREIGN KEY (ensemble_id) REFERENCES ensembles(id) \|`
premier commit 2023-10-22 19:24:59 +02:00			`\| theme_id \| INT \| FOREIGN KEY (theme_id) REFERENCES themes(id) \|`
enregistrement des exercices 2023-11-05 16:49:48 +01:00			`\| id \| INT \| AUTO_INCREMENT, PRIMARY KEY \|`
premier commit 2023-10-22 19:24:59 +02:00
			`### Table: exercices`

			`\| Column \| Type \| Constraints \|`
			`\|--------------------\|---------------\|------------------------------------------\|`
			`\| id \| INT \| AUTO_INCREMENT, PRIMARY KEY \|`
			`\| commentaire_auteur \| TEXT \| \|`
enregistrement des exercices 2023-11-05 16:49:48 +01:00			`\| ensemble_id \| INT \| FOREIGN KEY (ensemble_id) REFERENCES ensembles(id) \|`
voilà c'est comme ça qu'on fait là 2023-12-23 21:42:28 +01:00			`\| document_id \| INT \| FOREIGN KEY (document_id) REFERENCES documents(id)`
l'upload fonctionne ( pas la partie bdd, juste l'upload :( ) 2023-11-01 22:23:40 +01:00			`\| duree \| INT \| \|`
voilà c'est comme ça qu'on fait là 2023-12-23 21:42:28 +01:00			`(la durée est en minutes)`
premier commit 2023-10-22 19:24:59 +02:00
enregistrement des exercices 2023-11-05 16:49:48 +01:00			`### Table: ensembles`
premier commit 2023-10-22 19:24:59 +02:00
			`\| Column \| Type \| Constraints \|`
			`\|--------------------\|---------------\|------------------------------------------\|`
			`\| id \| INT \| AUTO_INCREMENT \|`
			`\| commentaire_auteur \| TEXT \| \|`
ça marche bordel 2023-11-03 22:22:27 +01:00			`\| valide \| BOOLEAN \| NOT NULL \|`
validation de pdfs et specification de corrigé :D 2023-11-11 20:33:14 +01:00			`\| corrige_inclu \| BOOLEAN \| DEFAULT NULL \|`
OUI OUI LES DATES 2024-01-18 15:45:51 +01:00			`\| date_televersement \| DATE \| DEFAULT CURRENT_TIMESTAMP \|`
			`\| date_conception \| VARCHAR(9) \| \|`

enregistrement des exercices 2023-11-05 16:49:48 +01:00
			`> le champ "corrige_inclu" ne sera utilisé que pour des annales`

premier commit 2023-10-22 19:24:59 +02:00			`### Table: documents`

			`\| Column \| Type \| Constraints \|`
			`\|--------------------\|---------------\|------------------------------------------\|`
			`\| id \| INT \| AUTO_INCREMENT, PRIMARY KEY \|`
			`\| titre \| VARCHAR(255) \| NOT NULL \|`
			`\| type \| INT \| \|`
			`\| upload_path \| TEXT \| NOT NULL \|`
			`\| commentaire_auteur \| TEXT \| \|`
			`\| ensemble_id \| INT \| FOREIGN KEY (ensemble_id) REFERENCES ensemble(id) \|`
			`\| theme_id \| INT \| FOREIGN KEY (theme_id) REFERENCES themes(id) \|`
enregistrement des exercices 2023-11-05 16:49:48 +01:00

			`## TOUDOU :`
toudou 2024-02-08 18:12:33 +01:00			`> Tester le code qui a été séparé en plusieurs fichiers différents (les pages pour utilisateurs)`
ça c'est de la recherche qui recherche (pas fini) 2023-12-03 16:30:07 +01:00

enregistrement des exercices 2023-11-05 16:49:48 +01:00			`### téléverser.php :`

			`- tout pack dans un json à l'envoi :`
			``
hehe ça fonctionne un peu :D 2023-11-05 17:03:58 +01:00			`let ex = [{duree:"10",themes:["algèbre","analyse"],commentaire_exo:"cci est un commenataire"},{duree:"15",themes:["elec analogique"],commentaire_exo:""}];`
			`;`
enregistrement des exercices 2023-11-05 16:49:48 +01:00			``

un ptit peu de doc là 2024-02-08 20:01:04 +01:00			`### _partials/_head.php`
			`- définir la variable $titre_page avant de l'inclure`
			`- va s'occuper de generer tout ce qu'on met dans les tags <head> ainsi que d'importer un fichier css du même nom que la page depuis css/<page>.css (s'il existe)`
			`### _partials/_footer.php`
			`- tout ce qu'on veut faire en fin de chargement de page`
			`- va inclure un script depuis js/<page>.js (s'il existe).`
enregistrement des exercices 2023-11-05 16:49:48 +01:00