Merge pull request 'chore: delete QUICKSTART.md' (#18) from chrore/delete-quickstart into main
Reviewed-on: #18
This commit was merged in pull request #18.
This commit is contained in:
160
QUICKSTART.md
160
QUICKSTART.md
@@ -1,160 +0,0 @@
|
|||||||
# 🚀 Guía de Inicio Rápido
|
|
||||||
|
|
||||||
## Instalación en 3 pasos
|
|
||||||
|
|
||||||
### 1. Instalar dependencias
|
|
||||||
|
|
||||||
```bash
|
|
||||||
npm install
|
|
||||||
```
|
|
||||||
|
|
||||||
### 2. Instalar OpenAPI Generator CLI
|
|
||||||
|
|
||||||
```bash
|
|
||||||
npm run setup
|
|
||||||
# O manualmente:
|
|
||||||
npm install -g @openapitools/openapi-generator-cli
|
|
||||||
```
|
|
||||||
|
|
||||||
### 3. Probar con el ejemplo incluido
|
|
||||||
|
|
||||||
```bash
|
|
||||||
node generate.js -i example-swagger.yaml -o ./test-output --dry-run
|
|
||||||
```
|
|
||||||
|
|
||||||
## Uso con tu API
|
|
||||||
|
|
||||||
### Paso 1: Copia tu archivo Swagger/OpenAPI
|
|
||||||
|
|
||||||
```bash
|
|
||||||
cp /ruta/a/tu/api.yaml ./swagger.yaml
|
|
||||||
```
|
|
||||||
|
|
||||||
### Paso 2: Genera el código
|
|
||||||
|
|
||||||
```bash
|
|
||||||
node generate.js -i swagger.yaml -o ./src/app
|
|
||||||
```
|
|
||||||
|
|
||||||
### Paso 3: Revisa los archivos generados
|
|
||||||
|
|
||||||
```bash
|
|
||||||
ls -la ./src/app/data/
|
|
||||||
ls -la ./src/app/domain/
|
|
||||||
ls -la ./src/app/di/
|
|
||||||
```
|
|
||||||
|
|
||||||
## Opciones Comunes
|
|
||||||
|
|
||||||
### Generar en otra carpeta
|
|
||||||
|
|
||||||
```bash
|
|
||||||
node generate.js -i swagger.yaml -o ./frontend/src/app
|
|
||||||
```
|
|
||||||
|
|
||||||
### Usar templates personalizados
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# Edita los archivos en ./templates/
|
|
||||||
# Luego ejecuta:
|
|
||||||
node generate.js -i swagger.yaml -t ./templates
|
|
||||||
```
|
|
||||||
|
|
||||||
### Modo de prueba (sin generar archivos)
|
|
||||||
|
|
||||||
```bash
|
|
||||||
node generate.js -i swagger.yaml --dry-run
|
|
||||||
```
|
|
||||||
|
|
||||||
## Integración con tu proyecto Angular
|
|
||||||
|
|
||||||
### 1. Registra los providers
|
|
||||||
|
|
||||||
En `app.config.ts` o `app.module.ts`:
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
import { UserRepositoryProvider } from '@/di/repositories/user.repository.provider';
|
|
||||||
import { UserUseCasesProvider } from '@/di/use-cases/user.use-cases.provider';
|
|
||||||
|
|
||||||
export const appConfig: ApplicationConfig = {
|
|
||||||
providers: [
|
|
||||||
// ... otros providers
|
|
||||||
UserRepositoryProvider,
|
|
||||||
UserUseCasesProvider
|
|
||||||
]
|
|
||||||
};
|
|
||||||
```
|
|
||||||
|
|
||||||
### 2. Configura los path aliases
|
|
||||||
|
|
||||||
En `tsconfig.json`:
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"compilerOptions": {
|
|
||||||
"paths": {
|
|
||||||
"@/*": ["src/app/*"],
|
|
||||||
"@environment": ["src/environments/environment"]
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
### 3. Usa en tus componentes
|
|
||||||
|
|
||||||
```typescript
|
|
||||||
import { Component, inject } from '@angular/core';
|
|
||||||
import { USER_USE_CASES } from '@/domain/use-cases/user/user.use-cases.contract';
|
|
||||||
|
|
||||||
@Component({
|
|
||||||
selector: 'app-users',
|
|
||||||
template: `...`
|
|
||||||
})
|
|
||||||
export class UsersComponent {
|
|
||||||
#userUseCases = inject(USER_USE_CASES);
|
|
||||||
|
|
||||||
ngOnInit() {
|
|
||||||
this.#userUseCases.getUsers().subscribe((users) => {
|
|
||||||
console.log(users);
|
|
||||||
});
|
|
||||||
}
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
## Troubleshooting
|
|
||||||
|
|
||||||
### ❌ Error: openapi-generator-cli: command not found
|
|
||||||
|
|
||||||
**Solución:**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
npm install -g @openapitools/openapi-generator-cli
|
|
||||||
```
|
|
||||||
|
|
||||||
### ❌ Error: Cannot find module 'commander'
|
|
||||||
|
|
||||||
**Solución:**
|
|
||||||
|
|
||||||
```bash
|
|
||||||
npm install
|
|
||||||
```
|
|
||||||
|
|
||||||
### ❌ Los archivos no se generan
|
|
||||||
|
|
||||||
**Solución:** Verifica que el directorio de salida existe o usa `--dry-run` para ver qué pasaría:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
node generate.js --dry-run
|
|
||||||
```
|
|
||||||
|
|
||||||
## Próximos pasos
|
|
||||||
|
|
||||||
1. ✅ Genera el código desde tu Swagger
|
|
||||||
2. 📝 Ajusta los templates según tus necesidades
|
|
||||||
3. 🔧 Configura los path aliases en tu tsconfig.json
|
|
||||||
4. 📦 Registra los providers en tu módulo Angular
|
|
||||||
5. 🚀 ¡Usa el código generado en tus componentes!
|
|
||||||
|
|
||||||
## ¿Necesitas ayuda?
|
|
||||||
|
|
||||||
Consulta el README.md completo para documentación detallada.
|
|
||||||
Reference in New Issue
Block a user