victoria-ynov 0.1.0

package/README.md

@@ -0,0 +1,128 @@
+# Module Test - Formulaire d'inscription React
+
+Application React de formulaire d'inscription avec validation en temps reel des champs (date de naissance, nom, prenom, ville, code postal, email). Les donnees sont envoyees a une API REST via Axios et le compteur d'utilisateurs est recupere au chargement depuis JSONPlaceholder.
+
+## Pre-requis
+
+- Node.js (v21 ou superieur)
+- npm
+
+## Installation
+
+```bash
+git clone <url-du-repo>
+cd my-app
+npm install
+```
+
+## Lancer l'application
+
+```bash
+npm start
+```
+
+L'application s'ouvre sur [http://localhost:3000](http://localhost:3000).
+
+## Lancer les tests unitaires et d'integration
+
+```bash
+npm test
+```
+
+Les tests s'executent avec coverage. Le rapport de couverture est genere dans le dossier `coverage/`.
+
+### Strategie de mock (Jest)
+
+Les tests d'integration utilisent `jest.mock('axios')` pour simuler les reponses de l'API sans connexion reseau reelle :
+
+```js
+jest.mock('axios');
+
+// Simuler un succes GET
+axios.get.mockResolvedValue({ data: mockUsers });
+
+// Simuler une erreur metier (400)
+const error400 = new Error('Bad Request');
+error400.response = { status: 400, data: { message: 'Cet email est deja utilise.' } };
+axios.post.mockRejectedValue(error400);
+
+// Simuler un crash serveur (500)
+const error500 = new Error('Internal Server Error');
+error500.response = { status: 500 };
+axios.post.mockRejectedValue(error500);
+```
+
+Cela permet de tester les trois scenarios API sans dependre de JSONPlaceholder :
+
+| Scenario | Mock | Comportement attendu |
+| -------- | ---- | -------------------- |
+| Succes (201) | `mockResolvedValue` | Toast vert, compteur incremente |
+| Erreur metier (400) | `mockRejectedValue` status 400 | Toast rouge avec message du back |
+| Crash serveur (500) | `mockRejectedValue` status 500 | Toast rouge d'alerte, app stable |
+
+## Lancer les tests End-to-End (Cypress)
+
+Les tests E2E s'executent dans un vrai navigateur contre l'application en cours d'execution.
+
+**1. Lancer l'application** (dans un terminal)
+
+```bash
+npm start
+```
+
+**2. Ouvrir Cypress** (dans un autre terminal)
+
+```bash
+npm run cypress
+```
+
+Cypress ouvre une interface graphique. Cliquer sur `navigation.cy.js` pour lancer les tests E2E.
+
+### Strategie de mock (Cypress)
+
+Les tests E2E utilisent `cy.intercept` pour bouchonner les routes API et permettre aux tests de passer sans backend reel. Chaque requete HTTP est interceptee avant d'atteindre le reseau et remplacee par une reponse fictive :
+
+```js
+// Intercepter le GET /users (dans beforeEach : actif pour tous les tests)
+cy.intercept('GET', 'https://jsonplaceholder.typicode.com/users', {
+  statusCode: 200,
+  body: mockUsers,
+}).as('getUsers');
+
+// Intercepter le POST /users avec une erreur 400
+cy.intercept('POST', 'https://jsonplaceholder.typicode.com/users', {
+  statusCode: 400,
+  body: { message: 'Cet email est deja utilise.' },
+}).as('postUser');
+```
+
+**Scenarios couverts :**
+
+- **Nominal (201)** : inscription complete, toast vert, compteur passe de 10 a 11.
+- **Erreur metier (400)** : le message specifique du back s'affiche dans un toast rouge, compteur inchange.
+- **Crash serveur (500)** : toast d'alerte generique, l'application ne plante pas, compteur inchange.
+
+## Structure du projet
+
+```text
+my-app/
+├── src/
+│   ├── pages/
+│   │   ├── Home.js          - Page d'accueil (compteur d'utilisateurs)
+│   │   └── Register.js      - Page formulaire d'inscription avec validation
+│   ├── tests/
+│   │   ├── home.test.js     - Tests unitaires du composant Home
+│   │   ├── register.test.js - Tests d'integration du formulaire (scenario chaotique)
+│   │   ├── app.test.js      - Tests d'integration API avec jest.mock('axios')
+│   │   ├── api.test.js      - Tests unitaires des fonctions Axios (countUsers, getAllUsers, postUser)
+│   │   ├── module.test.js   - Tests unitaires de calculateAge
+│   │   └── validator.test.js - Tests unitaires des validateurs
+│   ├── App.js               - Composant racine avec routeur et etat global
+│   ├── api.js               - Fonctions Axios (countUsers, getAllUsers, postUser)
+│   ├── module.js            - Fonction de calcul d'age
+│   └── validator.js         - Fonctions de validation (age, email, CP, identite, ville)
+├── cypress/
+│   └── e2e/
+│       └── navigation.cy.js - Tests E2E avec cy.intercept (201, 400, 500)
+└── TEST_PLAN.md             - Plan de test et documentation des cas testes
+```

package/babel.config.js

@@ -0,0 +1,6 @@
+module.exports = {
+    presets: [
+        '@babel/preset-env',
+        ['@babel/preset-react', { runtime: 'automatic' }],
+    ],
+};

package/dist/App.js

@@ -0,0 +1,63 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = require("react");
+var _reactRouterDom = require("react-router-dom");
+var _Home = _interopRequireDefault(require("./pages/Home"));
+var _Register = _interopRequireDefault(require("./pages/Register"));
+var _api = require("./api");
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * Composant racine de l'application.
+ * Gère l'état global du compteur d'utilisateurs et le routage entre les pages.
+ * Récupère le nombre d'utilisateurs depuis l'API au chargement.
+ *
+ * @component
+ * @returns {JSX.Element} L'application avec le routeur
+ */function App() {
+  const [usersCount, setUsersCount] = (0, _react.useState)(0);
+  const [apiError, setApiError] = (0, _react.useState)('');
+  (0, _react.useEffect)(() => {
+    const fetchCount = async () => {
+      try {
+        const count = await (0, _api.countUsers)();
+        setUsersCount(count);
+      } catch (error) {
+        setApiError('Impossible de récupérer les utilisateurs.');
+      }
+    };
+    fetchCount();
+  }, []);
+
+  /**
+   * Envoie un nouvel utilisateur à l'API et incrémente le compteur.
+   * @param {Object} user - L'utilisateur à ajouter
+   * @returns {Promise<void>}
+   */
+  const addUser = async user => {
+    await (0, _api.postUser)(user);
+    setUsersCount(prev => prev + 1);
+  };
+  return /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactRouterDom.BrowserRouter, {
+    basename: process.env.NODE_ENV === 'production' ? '/Module-test' : '',
+    children: /*#__PURE__*/(0, _jsxRuntime.jsxs)(_reactRouterDom.Routes, {
+      children: [/*#__PURE__*/(0, _jsxRuntime.jsx)(_reactRouterDom.Route, {
+        path: "/",
+        element: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Home.default, {
+          usersCount: usersCount,
+          apiError: apiError
+        })
+      }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactRouterDom.Route, {
+        path: "/register",
+        element: /*#__PURE__*/(0, _jsxRuntime.jsx)(_Register.default, {
+          addUser: addUser
+        })
+      })]
+    })
+  });
+}
+var _default = exports.default = App;

package/dist/api.js

@@ -0,0 +1,58 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.postUser = exports.getAllUsers = exports.countUsers = void 0;
+var _axios = _interopRequireDefault(require("axios"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const API = process.env.REACT_APP_SERVER_URL || 'https://jsonplaceholder.typicode.com';
+
+/**
+ * Récupère le nombre d'utilisateurs enregistrés via l'API.
+ *
+ * @returns {Promise<number>} Le nombre d'utilisateurs
+ * @throws {Error} Si la requête échoue
+ */
+const countUsers = async () => {
+  try {
+    const response = await _axios.default.get("".concat(API, "/users"));
+    return response.data.length;
+  } catch (error) {
+    throw error;
+  }
+};
+
+/**
+ * Récupère la liste complète des utilisateurs depuis l'API.
+ *
+ * @returns {Promise<Array>} La liste des utilisateurs
+ * @throws {Error} Si la requête échoue
+ */
+exports.countUsers = countUsers;
+const getAllUsers = async () => {
+  try {
+    const response = await _axios.default.get("".concat(API, "/users"));
+    return response.data;
+  } catch (error) {
+    throw error;
+  }
+};
+
+/**
+ * Envoie une requête POST à l'API pour créer un nouvel utilisateur avec les données fournies.
+ *
+ * @param {Object} user - L'utilisateur à créer (doit contenir au moins une propriété "name")
+ * @returns {Promise<Object>} L'utilisateur créé tel que retourné par l'API
+ * @throws {Error} Si la requête échoue
+ */
+exports.getAllUsers = getAllUsers;
+const postUser = async user => {
+  try {
+    const response = await _axios.default.post("".concat(API, "/users"), user);
+    return response.data;
+  } catch (error) {
+    throw error;
+  }
+};
+exports.postUser = postUser;

package/dist/index.css

@@ -0,0 +1,13 @@
+body {
+  margin: 0;
+  font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', 'Roboto', 'Oxygen',
+    'Ubuntu', 'Cantarell', 'Fira Sans', 'Droid Sans', 'Helvetica Neue',
+    sans-serif;
+  -webkit-font-smoothing: antialiased;
+  -moz-osx-font-smoothing: grayscale;
+}
+
+code {
+  font-family: source-code-pro, Menlo, Monaco, Consolas, 'Courier New',
+    monospace;
+}

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _react = _interopRequireDefault(require("react"));
+var _client = _interopRequireDefault(require("react-dom/client"));
+require("./index.css");
+var _App = _interopRequireDefault(require("./App"));
+var _reportWebVitals = _interopRequireDefault(require("./reportWebVitals"));
+var _jsxRuntime = require("react/jsx-runtime");
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+const root = _client.default.createRoot(document.getElementById('root'));
+root.render(/*#__PURE__*/(0, _jsxRuntime.jsx)(_react.default.StrictMode, {
+  children: /*#__PURE__*/(0, _jsxRuntime.jsx)(_App.default, {})
+}));
+
+// If you want to start measuring performance in your app, pass a function
+// to log results (for example: reportWebVitals(console.log))
+// or send to an analytics endpoint. Learn more: https://bit.ly/CRA-vitals
+(0, _reportWebVitals.default)();
+var _default = exports.default = _App.default;

package/dist/logo.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 841.9 595.3"><g fill="#61DAFB"><path d="M666.3 296.5c0-32.5-40.7-63.3-103.1-82.4 14.4-63.6 8-114.2-20.2-130.4-6.5-3.8-14.1-5.6-22.4-5.6v22.3c4.6 0 8.3.9 11.4 2.6 13.6 7.8 19.5 37.5 14.9 75.7-1.1 9.4-2.9 19.3-5.1 29.4-19.6-4.8-41-8.5-63.5-10.9-13.5-18.5-27.5-35.3-41.6-50 32.6-30.3 63.2-46.9 84-46.9V78c-27.5 0-63.5 19.6-99.9 53.6-36.4-33.8-72.4-53.2-99.9-53.2v22.3c20.7 0 51.4 16.5 84 46.6-14 14.7-28 31.4-41.3 49.9-22.6 2.4-44 6.1-63.6 11-2.3-10-4-19.7-5.2-29-4.7-38.2 1.1-67.9 14.6-75.8 3-1.8 6.9-2.6 11.5-2.6V78.5c-8.4 0-16 1.8-22.6 5.6-28.1 16.2-34.4 66.7-19.9 130.1-62.2 19.2-102.7 49.9-102.7 82.3 0 32.5 40.7 63.3 103.1 82.4-14.4 63.6-8 114.2 20.2 130.4 6.5 3.8 14.1 5.6 22.5 5.6 27.5 0 63.5-19.6 99.9-53.6 36.4 33.8 72.4 53.2 99.9 53.2 8.4 0 16-1.8 22.6-5.6 28.1-16.2 34.4-66.7 19.9-130.1 62-19.1 102.5-49.9 102.5-82.3zm-130.2-66.7c-3.7 12.9-8.3 26.2-13.5 39.5-4.1-8-8.4-16-13.1-24-4.6-8-9.5-15.8-14.4-23.4 14.2 2.1 27.9 4.7 41 7.9zm-45.8 106.5c-7.8 13.5-15.8 26.3-24.1 38.2-14.9 1.3-30 2-45.2 2-15.1 0-30.2-.7-45-1.9-8.3-11.9-16.4-24.6-24.2-38-7.6-13.1-14.5-26.4-20.8-39.8 6.2-13.4 13.2-26.8 20.7-39.9 7.8-13.5 15.8-26.3 24.1-38.2 14.9-1.3 30-2 45.2-2 15.1 0 30.2.7 45 1.9 8.3 11.9 16.4 24.6 24.2 38 7.6 13.1 14.5 26.4 20.8 39.8-6.3 13.4-13.2 26.8-20.7 39.9zm32.3-13c5.4 13.4 10 26.8 13.8 39.8-13.1 3.2-26.9 5.9-41.2 8 4.9-7.7 9.8-15.6 14.4-23.7 4.6-8 8.9-16.1 13-24.1zM421.2 430c-9.3-9.6-18.6-20.3-27.8-32 9 .4 18.2.7 27.5.7 9.4 0 18.7-.2 27.8-.7-9 11.7-18.3 22.4-27.5 32zm-74.4-58.9c-14.2-2.1-27.9-4.7-41-7.9 3.7-12.9 8.3-26.2 13.5-39.5 4.1 8 8.4 16 13.1 24 4.7 8 9.5 15.8 14.4 23.4zM420.7 163c9.3 9.6 18.6 20.3 27.8 32-9-.4-18.2-.7-27.5-.7-9.4 0-18.7.2-27.8.7 9-11.7 18.3-22.4 27.5-32zm-74 58.9c-4.9 7.7-9.8 15.6-14.4 23.7-4.6 8-8.9 16-13 24-5.4-13.4-10-26.8-13.8-39.8 13.1-3.1 26.9-5.8 41.2-7.9zm-90.5 125.2c-35.4-15.1-58.3-34.9-58.3-50.6 0-15.7 22.9-35.6 58.3-50.6 8.6-3.7 18-7 27.7-10.1 5.7 19.6 13.2 40 22.5 60.9-9.2 20.8-16.6 41.1-22.2 60.6-9.9-3.1-19.3-6.5-28-10.2zM310 490c-13.6-7.8-19.5-37.5-14.9-75.7 1.1-9.4 2.9-19.3 5.1-29.4 19.6 4.8 41 8.5 63.5 10.9 13.5 18.5 27.5 35.3 41.6 50-32.6 30.3-63.2 46.9-84 46.9-4.5-.1-8.3-1-11.3-2.7zm237.2-76.2c4.7 38.2-1.1 67.9-14.6 75.8-3 1.8-6.9 2.6-11.5 2.6-20.7 0-51.4-16.5-84-46.6 14-14.7 28-31.4 41.3-49.9 22.6-2.4 44-6.1 63.6-11 2.3 10.1 4.1 19.8 5.2 29.1zm38.5-66.7c-8.6 3.7-18 7-27.7 10.1-5.7-19.6-13.2-40-22.5-60.9 9.2-20.8 16.6-41.1 22.2-60.6 9.9 3.1 19.3 6.5 28.1 10.2 35.4 15.1 58.3 34.9 58.3 50.6-.1 15.7-23 35.6-58.4 50.6zM320.8 78.4z"/><circle cx="420.9" cy="296.5" r="45.7"/><path d="M520.5 78.1z"/></g></svg>

package/dist/module.js

@@ -0,0 +1,41 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.calculateAge = calculateAge;
+/**
+ * Calule l'âge d'une personne à partir de sa date de naissance.
+ *
+ * @param {Object} p Un objet représentant une personne, implémentant un champ birth de type Date
+ * @returns {number} L'age de la personne en années
+ * @throws {Error} "missing param p" - si aucun argument n'est envoyé
+ * @throws {Error} "p is not an object" - si p n'est pas un objet
+ * @throws {Error} "missing birth field" - si p.birth est manquant
+ * @throws {Error} "birth must be a valid Date" - si p.birth n'est pas une date valide
+ * @throws {Error} "birth cannot be in the future" - si p.birth est une date future
+ * @throws {Error} "age cannot exceed 150 years" - si l'âge calculé est supérieur à 150 ans
+ */
+
+function calculateAge(p) {
+  // Aucun argument n’a été envoyé
+  if (!p) throw new Error("missing param p");
+
+  // Le format envoyé n'est pas un objet
+  if (typeof p !== 'object') throw new Error("p is not an object");
+
+  // L'objet ne contient pas le champ birth
+  if (!p.birth) throw new Error("missing birth field");
+
+  // Le champ birth n'est pas une date et la date envoyée est fausse
+  if (!(p.birth instanceof Date) || isNaN(p.birth.getTime())) throw new Error("birth must be a valid Date");
+
+  // La date de naissance ne peut pas être dans le futur
+  if (p.birth > new Date()) throw new Error("birth cannot be in the future");
+
+  // La personne ne peut pas avoir plus de 150 ans
+  let dateDiff = new Date(Date.now() - p.birth.getTime());
+  let age = Math.abs(dateDiff.getUTCFullYear() - 1970);
+  if (age > 150) throw new Error("age cannot exceed 150 years");
+  return age;
+}

package/dist/pages/Home.js

@@ -0,0 +1,47 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _reactRouterDom = require("react-router-dom");
+var _jsxRuntime = require("react/jsx-runtime");
+/**
+ * Page d'accueil
+ * Présente l'application et propose un lien vers le formulaire d'inscription.
+ * Affiche le nombre d'utilisateurs inscrits récupéré depuis l'API.
+ *
+ * @param {Object} props
+ * @param {number} props.usersCount - Le nombre d'utilisateurs inscrits
+ * @param {string} [props.apiError] - Message d'erreur à afficher si le chargement a échoué
+ * @returns {JSX.Element} La page d'accueil
+ */function Home(_ref) {
+  let {
+    usersCount,
+    apiError
+  } = _ref;
+  return /*#__PURE__*/(0, _jsxRuntime.jsxs)("div", {
+    children: [/*#__PURE__*/(0, _jsxRuntime.jsx)("h1", {
+      children: "Bienvenue"
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)("p", {
+      children: "Cliquez sur le bouton ci-dessous pour acc\xE9der au formulaire d'inscription."
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)(_reactRouterDom.Link, {
+      to: "/register",
+      children: /*#__PURE__*/(0, _jsxRuntime.jsx)("button", {
+        children: "Acc\xE9der au formulaire"
+      })
+    }), /*#__PURE__*/(0, _jsxRuntime.jsx)("h1", {
+      children: "Utilisateurs inscrits"
+    }), apiError ? /*#__PURE__*/(0, _jsxRuntime.jsx)("p", {
+      "data-testid": "api-error",
+      style: {
+        color: 'red'
+      },
+      children: apiError
+    }) : /*#__PURE__*/(0, _jsxRuntime.jsxs)("p", {
+      "data-testid": "user-count",
+      children: [usersCount, " utilisateur", usersCount > 1 ? 's' : '', " inscrit", usersCount > 1 ? 's' : '']
+    })]
+  });
+}
+var _default = exports.default = Home;

package/dist/pages/Register.css

@@ -0,0 +1,38 @@
+.App {
+  text-align: center;
+}
+
+.App-logo {
+  height: 40vmin;
+  pointer-events: none;
+}
+
+@media (prefers-reduced-motion: no-preference) {
+  .App-logo {
+    animation: App-logo-spin infinite 20s linear;
+  }
+}
+
+.App-header {
+  background-color: #282c34;
+  min-height: 100vh;
+  display: flex;
+  flex-direction: column;
+  align-items: center;
+  justify-content: center;
+  font-size: calc(10px + 2vmin);
+  color: white;
+}
+
+.App-link {
+  color: #61dafb;
+}
+
+@keyframes App-logo-spin {
+  from {
+    transform: rotate(0deg);
+  }
+  to {
+    transform: rotate(360deg);
+  }
+}