# Aplicações Prontas

Cada um dos três é uma aplicação funcional, não um fragmento de código: formulário, servidor, desenho e resposta da API. Clone, coloque a chave no `.env`, execute. O código está sob licença MIT, então leve-o para o seu produto sem condições.

Os três estão estruturados da mesma forma: Vite no frontend e um pequeno servidor em Node pelo qual passam as chamadas. O navegador não pode acessar a API diretamente, então a chave fica no servidor e não chega à 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
```

A chave você obtém no [dashboard](https://api.astroway.info/dashboard/sign-up). Enquanto estiver a desenvolver, use a chave de teste `aw_test_*`: ela não consome créditos.

## Human Design

Data, hora e local de nascimento na entrada, bodygraph e análise na saída. Uma chamada `POST /v1/human-design` retorna tipo, estratégia, autoridade, perfil, definição, cruz de encarnação, nove centros com portas ativas, todos os canais definidos e ambos os conjuntos de ativações. A aplicação desenha o bodygraph em SVG e uma tabela de ativações. 50 créditos por leitura, ou seja, 200 leitagens no plano gratuito.

<CardGrid>
  <LinkCard title="Demonstração ao vivo" href="https://api.astroway.info/demo/human-design/" />
  <LinkCard title="Código no GitHub" href="https://github.com/astroway/starter-human-design" />
  <LinkCard title="Implementar no Render" href="https://render.com/deploy?repo=https://github.com/astroway/starter-human-design" />
</CardGrid>

## BaZi

Quatro pilares do destino e ciclo da sorte. `POST /v1/bazi/chart` retorna pilares com caules ocultos, yin e fase das doze etapas, senhor do dia, equilíbrio dos elementos, veredito de força com explicação, estrelas simbólicas e todas as combinações e colisões de ramos. `POST /v1/bazi/luck-pillars` retorna Da Yun: direção, idade de início e dez pilares de dez anos. Ambas as chamadas são feitas em paralelo, 30 créditos por leitura.

<CardGrid>
  <LinkCard title="Demonstração ao vivo" href="https://api.astroway.info/demo/bazi/" />
  <LinkCard title="Código no GitHub" href="https://github.com/astroway/starter-bazi" />
  <LinkCard title="Implementar no Render" href="https://render.com/deploy?repo=https://github.com/astroway/starter-bazi" />
</CardGrid>

## Painel de Relatórios

Para prática: dados do cliente na entrada, PDF pronto com a sua marca na saída. Dezesseis relatórios sob um prefixo `POST /v1/reports/<type>`, cada um aceita o bloco `whitelabel`, então o arquivo que o cliente recebe tem o seu nome, não o nosso. Quinze relatórios custam 5000 créditos, tarô 100.

<CardGrid>
  <LinkCard title="Demonstração ao vivo" href="https://api.astroway.info/demo/practice/" />
  <LinkCard title="Código no GitHub" href="https://github.com/astroway/starter-practice" />
  <LinkCard title="Implementar no Render" href="https://render.com/deploy?repo=https://github.com/astroway/starter-practice" />
</CardGrid>

<Aside>
As demonstrações são limitadas por endereço e usam suas próprias chaves com acesso apenas aos seus endpoints. A demonstração do painel de relatórios renderiza apenas o tarô, pois a página na internet aberta, que faria um relatório de 5000 créditos para cada um, consumiria o plano gratuito mensal em dois cliques. Sua cópia renderiza todos os dezesseis.
</Aside>

## Implementação

O botão Render lê o `render.yaml` no repositório: um serviço web em Node no plano gratuito, que é compilado e iniciado pelos scripts do package.json. Ao criar o Render, ele pedirá a chave API. Qualquer hospedagem onde o Node 22 funcione serve da mesma forma: compile, execute, defina a chave.