# Aplicaciones listas

Cada uno de los tres es una aplicación funcional, no un fragmento de código: un formulario, un servidor, un gráfico y una respuesta de API. Clona, pon la clave en `.env`, ejecuta. El código está bajo MIT, así que puedes usarlo en tu producto sin condiciones.

Los tres están configurados de la misma manera: Vite en el frontend y un pequeño servidor Node a través del cual se realizan las llamadas. El navegador no puede acceder a la API directamente, por lo que la clave reside en el servidor y no llega a la página.

```bash
git clone https://github.com/astroway/starter-human-design
cd starter-human-design && npm install
cp .env.example .env     # ваш ключ сюди
npm run dev
```

Obtendrás la clave en el [panel de control](https://api.astroway.info/dashboard/sign-up). Mientras construyes, usa la clave de prueba `aw_test_*`: no consume créditos.

## Human Design

Fecha, hora y lugar de nacimiento como entrada, bodygraph y análisis como salida. Una llamada `POST /v1/human-design` devuelve el tipo, la estrategia, la autoridad, el perfil, la definición, la cruz de encarnación, los nueve centros con puertas activas, todos los canales definidos y ambos conjuntos de activaciones. La aplicación dibuja el bodygraph en SVG y la tabla de activaciones. 50 créditos por lectura, es decir, 200 lecturas en el plan gratuito.

<CardGrid>
  <LinkCard title="Demo en vivo" href="https://api.astroway.info/demo/human-design/" />
  <LinkCard title="Código en GitHub" href="https://github.com/astroway/starter-human-design" />
  <LinkCard title="Desplegar en Render" href="https://render.com/deploy?repo=https://github.com/astroway/starter-human-design" />
</CardGrid>

## BaZi

Los Cuatro Pilares del Destino y el Ciclo de la Suerte. `POST /v1/bazi/chart` devuelve los pilares con tallos ocultos, el yin y la fase de las doce etapas, el Maestro del Día, el equilibrio de los elementos, el veredicto de fuerza con explicación, las estrellas simbólicas y todas las combinaciones y choques de ramas. `POST /v1/bazi/luck-pillars` devuelve el Da Yun: dirección, edad de inicio y diez pilares de diez años. Ambas llamadas se ejecutan en paralelo, 30 créditos por lectura.

<CardGrid>
  <LinkCard title="Demo en vivo" href="https://api.astroway.info/demo/bazi/" />
  <LinkCard title="Código en GitHub" href="https://github.com/astroway/starter-bazi" />
  <LinkCard title="Desplegar en Render" href="https://render.com/deploy?repo=https://github.com/astroway/starter-bazi" />
</CardGrid>

## Panel de informes

Para el profesional: datos del cliente como entrada, PDF listo con tu marca como salida. Dieciséis informes bajo un mismo prefijo `POST /v1/reports/<type>`, cada uno acepta un bloque `whitelabel`, por lo que el archivo que recibe el cliente lleva tu nombre, no el nuestro. Quince informes cuestan 5000 créditos, el tarot 100.

<CardGrid>
  <LinkCard title="Demo en vivo" href="https://api.astroway.info/demo/practice/" />
  <LinkCard title="Código en GitHub" href="https://github.com/astroway/starter-practice" />
  <LinkCard title="Desplegar en Render" href="https://render.com/deploy?repo=https://github.com/astroway/starter-practice" />
</CardGrid>

<Aside>
Las demos están restringidas por dirección y usan sus propias claves con acceso solo a sus endpoints. La demo del panel de informes solo renderiza el tarot, porque una página en internet abierta que generara un informe de 5000 créditos para cualquiera agotaría el plan gratuito mensual en dos clics. Tu copia renderiza los dieciséis.
</Aside>

## Despliegue

El botón de Render lee `render.yaml` en el repositorio: un servicio web en Node en el plan gratuito, que se construye e inicia con scripts de package.json. Al crear, Render te pedirá la clave API. Cualquier hosting donde funcione Node 22 es igualmente adecuado: construir, ejecutar, configurar la clave.