# Seja bem-vindo!

Madrix é uma plataforma para **desenhar, gerar e operar** apps corporativos com IA.

Você descreve o que quer.\
Agentes executam ferramentas determinísticas.\
Você revisa, aprova e publica.

### O que você consegue construir

Use Madrix para criar:

* CRMs, helpdesks e backoffices.
* Portais internos e fluxos operacionais.
* Apps com regras de negócio, permissões e ambientes (Dev/Staging/Prod).

{% hint style="info" %}
Aqui “IA agêntica” significa: a IA **não só escreve texto**. Ela **executa ações** via ferramentas, com rastreabilidade e checkpoints de aprovação.
{% endhint %}

### Comece agora (15 min)

Siga o onboarding e tenha seu primeiro app rodando:

* [Comece aqui](https://docs.madrix.dev/br/comece-aqui)

Se você prefere começar por exemplos prontos:

* [Templates de Prompt](https://docs.madrix.dev/br/tutoriais-praticos/4.-templates-de-prompt)

Depois, aprofunde com:

* [Tutoriais Práticos](https://docs.madrix.dev/br/tutoriais-praticos)
* [Demonstrações](https://docs.madrix.dev/br/demonstracoes)

### Como navegar na documentação

Escolha um caminho e siga os links:

{% tabs %}
{% tab title="Construir rápido" %}

* Onboarding completo: [Comece aqui](https://docs.madrix.dev/br/comece-aqui)
* Prompts prontos: [Templates de Prompt](https://docs.madrix.dev/br/tutoriais-praticos/4.-templates-de-prompt)
* Exemplos guiados: [Demonstrações](https://docs.madrix.dev/br/demonstracoes)
  {% endtab %}

{% tab title="Produto / Plataforma" %}

* Visão geral dos blocos: [Plataforma](https://docs.madrix.dev/br/documentacao/plataforma)
* Recursos de IA: [IA e Agentic Coding](https://docs.madrix.dev/br/documentacao/modo-chat-ai)
* Aprofundar por tema: [Tutoriais Práticos](https://docs.madrix.dev/br/tutoriais-praticos)
  {% endtab %}

{% tab title="TI / Integrações / Ops" %}

* Conectar com seu stack: [Integrações e API](https://docs.madrix.dev/br/documentacao/integracoes-e-api)
* Governança e segurança: [Segurança e Compliance (TI)](https://docs.madrix.dev/br/documentacao/configuracoes-do-runtime)
* Deploy e operação: [Deployment e Ops](https://docs.madrix.dev/br/broken-reference)
  {% endtab %}

{% tab title="Troubleshooting" %}

* Quando travar: [Solução de problemas](https://docs.madrix.dev/br/solucao-de-problemas)
  {% endtab %}
  {% endtabs %}

### Como funciona (visão rápida)

1. **Prompt** com objetivo, módulos, entidades e regras.
2. **Especificação** para revisar e aprovar.
3. **Geração** de backend, UI e integrações.
4. **Preview** para testar o app.
5. **Deploy** em ambientes (Dev/Staging/Prod).

### Conceitos (em 2 minutos)

* **Projeto**: o “container” do seu app.
* **Ambiente**: onde o app roda (Dev/Staging/Prod).
* **Módulo**: um domínio funcional (ex: Tarefas, Clientes).
* **Entidade**: o dado principal do domínio (ex: Tarefa, Cliente).
* **Regra de negócio**: validações e automações do processo.
* **Papéis e permissões (RBAC)**: quem pode ver e fazer o quê.

### O que esperar

1. **Facilidade de uso**
   * Interface guiada.
   * Fluxo claro de prompt → aprovação → execução.
2. **Flexibilidade**
   * Modelos e regras adaptados ao seu negócio.
   * Evolução iterativa com Chat AI e Editor.
3. **Eficiência**
   * Menos tempo entre ideia e app rodando.
   * Menos retrabalho com especificação aprovada.
4. **Colaboração**
   * Times trabalham no mesmo projeto.
   * Papéis e permissões para governança.

### Próximos passos

* Entender os blocos principais: [Plataforma](https://docs.madrix.dev/br/documentacao/plataforma)
* Explorar recursos de IA: [IA e Agentic Coding](https://docs.madrix.dev/br/documentacao/modo-chat-ai)
* Conectar com seu stack: [Integrações e API](https://docs.madrix.dev/br/documentacao/integracoes-e-api)
* Pegar prompts prontos: [Templates de Prompt](https://docs.madrix.dev/br/tutoriais-praticos/4.-templates-de-prompt)
* Se travar em algo: [Solução de problemas](https://docs.madrix.dev/br/solucao-de-problemas)
