z3n
9151932eb6
- CreateApiUploadDto : valide le multipart POST /uploads via ValidationPipe (types, @IsIn énums partagés, @IsUUID, @MaxLength(255)). Emails validés seulement si renseignés (@ValidateIf) -> n'casse pas les contacts vides. Remplace le body inline + les checks manuels du contrôleur. - create-api-entry.dto: @MaxLength(255) sur name/provider/contacts (matche les colonnes entité) + @MaxLength sur emails. Vérifié: email invalide -> 400 message clair, contacts vides -> 201 OK. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Datacat
Catalogue de données d'API. Importez des fichiers YAML (AsyncAPI ou OpenAPI) et générez automatiquement de la documentation HTML interactive.
Architecture
Monorepo pnpm avec quatre sous-projets :
datacat/
├── back/ # API REST — NestJS + TypeORM + PostgreSQL
├── front-public/ # Interface web — Angular 19 + DSFR
├── shared/ # Types TypeScript partagés (@datacat/shared)
└── infra/ # Docker Compose, Dockerfiles, Kubernetes
Prérequis
- Node.js 22 LTS
- pnpm 10
- Docker (recommandé)
Démarrage rapide
# Démarrer tous les services (PostgreSQL + backend + frontend)
docker compose -f infra/docker-compose.yml up -d
# Suivre les logs
docker compose -f infra/docker-compose.yml logs -f
URLs de développement
| Service | URL |
|---|---|
| Frontend | http://localhost:4200 |
| API | http://localhost:3010/api |
| Health check | http://localhost:3010/health |
Utilisation
- Ouvrir http://localhost:4200
- Naviguer par catégories via Parcourir ou voir toutes les APIs via Catalogue
- Cliquer sur Importer pour ajouter un fichier YAML AsyncAPI ou OpenAPI
- Une fois la génération terminée (statut GENERATED), cliquer sur Voir la documentation
Stack technique
| Couche | Technologie |
|---|---|
| Backend | NestJS 11, TypeORM 0.3, PostgreSQL 17 |
| Frontend | Angular 19, DSFR |
| Types partagés | TypeScript 5.8 strict |
| Génération docs AsyncAPI | @asyncapi/cli@6.0.0 |
| Génération docs OpenAPI | @redocly/cli |
Développement sans Docker
# Backend (port 3000)
cd back && pnpm install && pnpm run start:dev
# Frontend (port 4200, avec proxy vers l'API)
cd front-public && pnpm install && pnpm run start
Créer
front-public/proxy.conf.jsonsi absent :{ "/api": { "target": "http://localhost:3010", "secure": false } }
Rebuild complet
docker compose -f infra/docker-compose.yml down
docker volume rm datacat_front_node_modules datacat_back_node_modules
docker compose -f infra/docker-compose.yml build --no-cache
docker compose -f infra/docker-compose.yml up -d
Documentation
documentation/architecture.md— flux, schéma DB, servicesdocumentation/api-reference.md— référence complète des endpoints RESTdocumentation/local-setup.md— installation locale (sans Docker)documentation/CLAUDE.md— guide d'implémentation interne