> For the complete documentation index, see [llms.txt](https://docs.audit.venturytechnology.fr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.audit.venturytechnology.fr/architecture-fonctionnel/structure-des-fichiers.md).

# Structure des fichiers

{% code overflow="wrap" %}

```
/
├── actions/                        # Server Actions Next.js
│   ├── auth.actions.ts             # Valider le formulaire d'auth
│   ├── user.actions.ts             # Récupérer l'utilisateur
│   ├── mfa.actions.ts              # Vérifier MFA + envoyer le code
│   ├── session.actions.ts          # Lire / détruire la session (cookies)
│   └── logout.actions.ts           # Déconnexion (purge des cookies)
│
├── app/                            # Routing Next.js (App Router)
│   ├── api/
│   │   ├── auth/verify/            # Endpoint : vérification du code MFA
│   │   └── mail/send/              # Endpoint : envoi de l'email MFA
│   ├── audit/                      # ⭐ Le questionnaire
│   ├── auth/
│   │   ├── page.tsx                # Saisie des credentials
│   │   ├── mfa/page.tsx            # Saisie du code MFA reçu par email
│   │   └── verify/page.tsx         # Vérification intermédiaire
│   ├── result/                     # ⭐ Page de résultats
│   └── page.tsx                    # Page d'accueil (démarrage de l'audit)
│
├── components/                     # Composants UI réutilisables
│
├── data/                           # ⭐ Source de données statiques
│   ├── answer.data.ts              # Valeurs possibles (Oui/Non/Partiel)
│   ├── auth.data.ts                # Utilisateurs autorisés
│   ├── domain.data.ts              # Les 5 domaines
│   ├── question.data.ts            # Les 15 questions
│   └── result.data.ts              # Niveaux de maturité et remédiation
│
├── emails/                         # Templates React Email (design des mails)
│
├── lib/                            # Utilitaires et librairies
│   ├── domain.utils.ts             # Helpers liés aux domaines
│   ├── email-template.tsx          # Rendu du template email
│   ├── mail.ts                     # Configuration et envoi d'email
│   ├── pdf.tsx                     # Génération du rapport PDF
│   ├── questions.utils.ts          # Helpers liés aux questions
│   ├── result.utils.ts             # Calcul des scores et niveaux
│   └── utils.tsx                   # Utilitaires généraux
│
├── store/
│   └── Quiz-Store.tsx              # ⭐ Context global des réponses
│
├── types/                          # Interfaces TypeScript du projet
│   ├── answer.type.ts
│   ├── auth.type.ts
│   ├── domain.type.ts
│   ├── props.type.ts
│   ├── questions.type.ts
│   └── result.type.ts
│
└── proxy.ts                        # Middleware (protection des routes)
```

{% endcode %}

> ⭐️ Les fichiers les plus importants à connaitre pour maintenir le proejt : `data/`, `store/quiz-store.tsx`, `lib/result.utils.ts` et `proxy.ts`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.audit.venturytechnology.fr/architecture-fonctionnel/structure-des-fichiers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.