====== Génération des artefacts techniques ======

===== Objectif =====

À ce stade, le projet dispose :

  * du cahier des charges,
  * de l'architecture fonctionnelle,
  * du modèle de données,
  * du modèle UML,
  * de l'architecture Frontend,
  * de l'architecture Backend,
  * du backlog,
  * du plan DevOps.

L'étape suivante consiste à produire les artefacts techniques directement exploitables par les développeurs.

----

====== Ordre recommandé de génération ======

L'ordre est important car certains artefacts dépendent des précédents.

^ Ordre ^ Livrable ^ Priorité ^
| 1 | Monorepo Frontend/Backend | Critique |
| 2 | Configuration NestJS | Critique |
| 3 | Configuration NextJS | Critique |
| 4 | OpenAPI YAML complet | Critique |
| 5 | DTO TypeScript | Critique |
| 6 | Entités Prisma / TypeORM | Critique |
| 7 | Docker Compose | Haute |
| 8 | GitHub Actions | Haute |
| 9 | Helm Charts Kubernetes | Haute |
| 10 | Terraform Infrastructure | Moyenne |

----

====== Monorepo cible ======

<code>
rental-platform/

├── apps/
│
│   ├── frontend/
│   └── backend/
│
├── packages/
│
│   ├── shared-types/
│   ├── ui-kit/
│   ├── sdk/
│   └── eslint-config/
│
├── docs/
│
├── deployment/
│
├── scripts/
│
└── .github/
</code>

----

====== Frontend ======

===== Arborescence =====

<code>
apps/frontend

├── src
│
├── public
│
├── generated
│
├── tests
│
├── package.json
│
└── next.config.ts
</code>

----

====== Backend ======

===== Arborescence =====

<code>
apps/backend

├── src
│
├── prisma
│
├── test
│
├── package.json
│
└── nest-cli.json
</code>

----

====== OpenAPI ======

===== Objectif =====

L'OpenAPI devient la source de vérité.

Tout est généré à partir de lui :

  * SDK
  * DTO
  * Validation
  * Swagger
  * Documentation

----

===== Livrable attendu =====

<code>
docs/openapi/

openapi.yaml
</code>

Taille estimée :

  * 8000 à 12000 lignes

----

====== Génération SDK ======

===== Frontend =====

<code bash>
openapi-generator-cli generate \
-g typescript-fetch
</code>

----

===== Résultat =====

<code>
packages/sdk

├── api.ts
├── models.ts
├── services.ts
└── index.ts
</code>

----

====== Entités Prisma ======

===== Source =====

Le schéma PostgreSQL précédemment défini.

----

===== Exemple =====

<code prisma>
model Property {

  id            String   @id @default(uuid())

  code          String   @unique

  title         String

  status        String

  ownerId       String

  owner         Owner @relation(
                  fields: [ownerId],
                  references: [id]
                )

  createdAt     DateTime @default(now())

  updatedAt     DateTime @updatedAt

}
</code>

----

====== Entités TypeORM ======

===== Exemple =====

<code ts>
@Entity("properties")
export class Property {

  @PrimaryGeneratedColumn("uuid")
  id: string;

  @Column()
  title: string;

  @Column()
  status: string;

}
</code>

----

====== Docker Compose ======

===== Objectif =====

Démarrage local complet.

----

===== Services =====

<code>
frontend

backend

postgres

redis

mailhog

minio
</code>

----

===== Commande =====

<code bash>
docker compose up -d
</code>

----

====== GitHub Actions ======

===== Pipeline Frontend =====

<code>
lint

typecheck

test

build

docker

deploy
</code>

----

===== Pipeline Backend =====

<code>
lint

unit-test

integration-test

build

docker

deploy
</code>

----

====== Helm Charts ======

===== Structure =====

<code>
deployment/

helm/

├── frontend

├── backend

├── postgres

├── redis

└── ingress
</code>

----

====== Variables Kubernetes ======

<code>
DATABASE_URL

REDIS_URL

JWT_SECRET

SMTP_HOST

S3_ENDPOINT

STRIPE_SECRET
</code>

----

====== Repository Git ======

===== Branches =====

<code>
main

develop

feature/*

release/*

hotfix/*
</code>

----

====== Livrables techniques restants ======

Les documents qui n'ont pas encore été détaillés et qui représentent le plus de valeur sont :

  * OpenAPI YAML complet (250 endpoints)
  * Prisma Schema complet (80+ tables)
  * Entités NestJS TypeORM
  * Monorepo Turborepo
  * Docker Compose complet
  * GitHub Actions complètes
  * Helm Charts Kubernetes
  * Terraform Infrastructure AWS/OVH

----

====== Recommandation ======

Le prochain document à produire devrait être :

**OpenAPI YAML complet**

car il permettra ensuite de générer automatiquement :

  * SDK Frontend
  * DTO NestJS
  * Validation Zod
  * Swagger
  * Documentation API
  * Mock Server
  * Tests contractuels

et deviendra la véritable source de référence technique du projet.