.. _tips:

=====
Dicas
=====

Downloads, links e dicas para trabalhar com os mapas do Mapper Idea.

Downloads
~~~~~~~~~

**Freemapper 1.0.23**, o editor de mapas mentais para mapas ``.mi`` e ``.mm`` (software livre, GPL v3 ou posterior):

* Windows, com Java incluído: https://static.academy.mapperidea.io/freemapper-1.0.23-windows-x64.zip
* Linux, com Java incluído: https://static.academy.mapperidea.io/freemapper-1.0.23-linux-x64.zip
* Outros sistemas, como macOS (precisa do Java 8 ou mais novo): https://static.academy.mapperidea.io/freemapper-1.0.23.zip
* Código-fonte: https://static.academy.mapperidea.io/freemapper-1.0.23-src.zip

**CLI do Mapper Idea 1.0.8** (``mi``), que envia os mapas para o servidor e gera o código:

* Linux AMD64: https://static.academy.mapperidea.io/mapperidea-cli-1.0.8-linux-amd64.zip
* Linux ARM64: https://static.academy.mapperidea.io/mapperidea-cli-1.0.8-linux-arm64.zip
* macOS Intel: https://static.academy.mapperidea.io/mapperidea-cli-1.0.8-mac-intel.zip
* macOS ARM64 (M1 e mais novos): https://static.academy.mapperidea.io/mapperidea-cli-1.0.8-mac-arm64.zip
* Windows AMD64: https://static.academy.mapperidea.io/mapperidea-cli-1.0.8-windows-amd64.zip

**Guias:**

* Instalação e configuração (CLI, plugin do Claude Code e Freemapper): https://static.academy.mapperidea.io/GuiaBasicodeInstalacaoEConfiguracaodoAmbienteMapperIdea_cli.pdf
* Guia de uso do Freemapper, o mesmo que abre pelo menu Ajuda: https://static.academy.mapperidea.io/Freemapper-GuiaDeUso.pdf

**Mapa de exemplo**, para testar os ícones e o primeiro ``mi generate``: https://static.academy.mapperidea.io/mapperideaHelloworldYT.zip

**Plugins do Mapper Idea para o Claude Code**: https://github.com/mapperidea/claude-plugins

Vídeos
~~~~~~

* **Introdução ao Mapper Idea**: https://www.youtube.com/playlist?list=PLXzWKf_G9upsryGhq4_0tIY-sOonEPb2M
* **Fundamentos do Mapper Idea**: https://www.youtube.com/playlist?list=PLXzWKf_G9upsMSxWVP5S7lIollfh7-epf

Ícones num mapa .mi
~~~~~~~~~~~~~~~~~~~

Num mapa ``.mi``, cada linha é um nó, o recuo (quatro espaços) é a hierarquia e o ícone é o prefixo entre
colchetes. Os ícones mais usados têm um atalho de uma letra:

.. list-table::
   :widths: 20 40 40
   :header-rows: 1

   * - **No mapa .mi**
     - **Ícone**
     - **Significado**
   * - ``[k]``
     - :ref:`bullet_key`
     - Marca um atributo como chave
   * - ``[b]``
     - :ref:`Descriptor.bean`
     - Entidade persistente
   * - ``[c]``
     - :ref:`Descriptor.class`
     - Classe ou tipo auxiliar
   * - ``[g]``
     - :ref:`Descriptor.grouping`
     - Agrupamento visual
   * - ``[d]``
     - :ref:`Mapping.directToField`
     - Atributo simples
   * - ``[r]``
     - :ref:`Mapping.oneToOne`
     - Referência a outra classe
   * - ``[o]``
     - :ref:`Mapping.oneToMany`
     - Coleção (lado mestre)
   * - ``[m]``
     - :ref:`Mapping.manyToOne`
     - Referência ao mestre (lado detalhe)
   * - ``[h]``
     - :ref:`Mapping.directMap`
     - Mapa direto
   * - ``[x]``
     - :ref:`Method.public`
     - Método público
   * - ``[p]``
     - :ref:`Package`
     - Pacote
   * - ``[e]``
     - :ref:`element`
     - Elemento
   * - ``[v]``
     - :ref:`tag_green`
     - Valor
   * - ``[y]``
     - :ref:`tag_yellow`
     - Valor sem quebra de linha
   * - ``[t]``
     - :ref:`textNode`
     - Nó de texto

Qualquer outro ícone é escrito com o nome completo, como ``[Descriptor.window.editor] OrderForm``. Um nó
com mais de um ícone lista os ícones separados por vírgula, como ``[d, k]``. A seção
:ref:`functions-mapperidea-iconography` mostra todos os ícones e o que cada um vira no DOM.

Exemplo:

.. code-block:: text

   [p] sales
       [b] Order
           [d, k] number:string()
           [r] customer:Customer()
           [d] total:decimal()
           [x] confirm:boolean()

Ícones no Freemapper
~~~~~~~~~~~~~~~~~~~~

Os ícones do Mapper Idea já vêm com o Freemapper, e **Alt+I** abre a janela de seleção de ícones. O
Freemapper abre e salva mapas ``.mi`` e ``.mm``.

Usando o Freeplane
~~~~~~~~~~~~~~~~~~

Mapas ``.mm`` também podem ser editados no Freeplane (https://sourceforge.net/projects/freeplane/), com os
ícones do Mapper Idea de https://static.academy.mapperidea.io/mapperideaIcons.zip (os nomes de menu abaixo são os da interface em inglês):

* **Tools > Open user directory** abre o ``freeplane_userdir``. Crie o diretório ``icons``, se
  preciso, copie os ícones para ele e reinicie o Freeplane.
* **Tools > Preferences > Keystrokes** lista os ícones, e ali dá para definir um atalho para cada um.
* **Tools > Assign Hot Key** muda o atalho de um item de menu: deixe a caixa aberta, escolha o
  item de menu e digite o atalho novo.