# Módulo 2 — Importación de elementos en TypeScript

## 1. Importación de datos

TypeScript utiliza el **sistema de módulos ES** igual que JavaScript, pero añade **tipado explícito**, lo que permite validar la estructura de los datos en tiempo de desarrollo.

En este módulo los ejemplos se adaptan a la estructura real de tu API: **recursos humanos, recursos materiales y activaciones**.

---

### Ejemplo: Importación desde otro archivo TypeScript

Archivo `data/recursos.ts`:

```ts
// data/recursos.ts
export type TipoRecurso = 'Humano' | 'Material';

export interface RecursoBase {
  id: number;
  nombreRecurso: string;
  tipoRecurso: TipoRecurso;
  unidad: string;
  comunidadAutonoma: string;
  provincia: string;
  localidad: string;
  base: string;
  servicioMedicoReferencia?: string; // opcional
}

export const recursosHumanos: RecursoBase[] = [
  {
    id: 1,
    nombreRecurso: 'Laura Gómez',
    tipoRecurso: 'Humano',
    unidad: 'AGRUSAN',
    comunidadAutonoma: 'Madrid',
    provincia: 'Madrid',
    localidad: 'Pozuelo de Alarcón',
    base: 'General Cavalcanti',
    servicioMedicoReferencia: 'Hospital La Paz',
  },
  {
    id: 2,
    nombreRecurso: 'Javier Ruiz',
    tipoRecurso: 'Humano',
    unidad: 'NAS 11',
    comunidadAutonoma: 'Madrid',
    provincia: 'Madrid',
    localidad: 'Pozuelo de Alarcón',
    base: 'General Cavalcanti',
    servicioMedicoReferencia: 'Hospital Infanta Sofía',
  },
];

export const recursosMateriales: RecursoBase[] = [
  {
    id: 10,
    nombreRecurso: 'ET 117928',
    tipoRecurso: 'Material',
    unidad: 'AGRUSAN',
    comunidadAutonoma: 'Madrid',
    provincia: 'Madrid',
    localidad: 'Pozuelo de Alarcón',
    base: 'General Cavalcanti',
  },
  {
    id: 11,
    nombreRecurso: 'ET 117929',
    tipoRecurso: 'Material',
    unidad: 'AGRUSAN',
    comunidadAutonoma: 'Madrid',
    provincia: 'Madrid',
    localidad: 'Pozuelo de Alarcón',
    base: 'General Cavalcanti',
  },
];
```

Archivo `gestion/mostrarRecursos.ts`:

```ts
// gestion/mostrarRecursos.ts
import { recursosHumanos, recursosMateriales, RecursoBase } from '../data/recursos';

console.log('Listado de recursos humanos:');
recursosHumanos.forEach((r: RecursoBase) => {
  console.log(`- ${r.nombreRecurso} (${r.unidad})`);
});

console.log('\nListado de recursos materiales:');
recursosMateriales.forEach((r: RecursoBase) => {
  console.log(`- ${r.nombreRecurso} [${r.base}]`);
});
```

---

### Ejemplo: Importación desde un archivo JSON

En TypeScript, los datos JSON suelen mapearse a **interfaces**.

Archivo `data/activaciones.json` (sin cambios):

```json
[
  {
    "id": 100,
    "recursoId": 1,
    "fechaHoraInicio": "2025-01-05T08:00:00",
    "fechaHoraFin": "2025-01-05T15:00:00",
    "tipoJornada": "COMPLETA",
    "tipoSituacion": "ACTIVIDAD",
    "observaciones": "Servicio programado"
  }
]
```

Archivo `models/Activacion.ts`:

```ts
// models/Activacion.ts
export interface Activacion {
  id: number;
  recursoId: number;
  fechaHoraInicio: string;
  fechaHoraFin: string;
  tipoJornada: 'COMPLETA' | 'PARCIAL';
  tipoSituacion: 'ACTIVIDAD' | 'NO_OPERATIVO';
  observaciones?: string;
}
```

Archivo `gestion/activaciones.ts`:

```ts
// gestion/activaciones.ts
import activaciones from '../data/activaciones.json';
import { Activacion } from '../models/Activacion';

function cargarActivaciones(): void {
  console.log('Activaciones registradas:');
  (activaciones as Activacion[]).forEach((a) => {
    console.log(`- Activación #${a.id}: recurso ${a.recursoId} (${a.tipoSituacion}, ${a.tipoJornada})`);
  });
}

cargarActivaciones();
```

---

## 2. Importación de funciones

Archivo `utils/calculos.ts`:

```ts
// utils/calculos.ts
export function calcularPorcentajeActividad(total: number, enActividad: number): string {
  return ((enActividad / total) * 100).toFixed(1);
}

export function formatearSituacion(situacion: string): string {
  return situacion
    .toLowerCase()
    .replace('_', ' ')
    .replace(/^\w/, (c) => c.toUpperCase());
}
```

Archivo `informes/actividadRecursos.ts`:

```ts
// informes/actividadRecursos.ts
import { calcularPorcentajeActividad, formatearSituacion } from '../utils/calculos';

const totalRecursos: number = 20;
const recursosActivos: number = 15;

console.log(
  `Porcentaje de recursos en ACTIVIDAD: ${calcularPorcentajeActividad(totalRecursos, recursosActivos)}%`
);

console.log(`Situación formateada: ${formatearSituacion('BAJA_MEDICA')}`);
```

---

## 3. Importación de clases

Archivo `models/RecursoHumano.ts`:

```ts
// models/RecursoHumano.ts
export class RecursoHumano {
  constructor(
    public id: number,
    public nombreRecurso: string,
    public unidad: string,
    public tipoSituacion: string
  ) {}

  readonly tipoRecurso: string = 'Humano';

  mostrarFicha(): void {
    console.log(
      `Recurso Humano #${this.id}: ${this.nombreRecurso} - Unidad: ${this.unidad} (${this.tipoSituacion})`
    );
  }
}
```

Archivo `gestion/personal.ts`:

```ts
// gestion/personal.ts
import { RecursoHumano } from '../models/RecursoHumano';

const tecnico = new RecursoHumano(1, 'Laura Gómez', 'AGRUSAN', 'ACTIVIDAD');
const medico = new RecursoHumano(2, 'Javier Ruiz', 'NAS 11', 'COMISION_SERVICIO');

tecnico.mostrarFicha();
medico.mostrarFicha();
```

---

## 4. Buenas prácticas en TypeScript

* Evitar `any`; usar `interface` o `type`.
* No es necesario indicar la extensión `.ts` en los imports.
* Usar **barrel files** (`index.ts`) para agrupar exports.
* Separar modelos (`/models`), utilidades (`/utils`) y lógica (`/gestion`).

Ejemplo con exportación por defecto:

```ts
// utils/logger.ts
export default function log(mensaje: string): void {
  console.log(`[Sistema Recursos]: ${mensaje}`);
}
```

```ts
// main.ts
import log from './utils/logger';

log('Sistema de activaciones inicializado.');
```