Atualizando guia com o IP real do Tailscale

Acesso-Externo-e-Integracao.md

@@ -0,0 +1,45 @@
+# Guia de Acesso Externo e Integração de Dados (Dados Reais)
+
+Este documento descreve como consumir os dados do projeto **apitdn** utilizando o IP real da sua VPN Mesh (Tailscale).
+
+## 🌐 1. Infraestrutura de Conexão
+O seu Raspberry Pi está acessível através do Tailscale pelo IP fixo abaixo:
+
+*   **IP Tailscale**: `100.127.147.8`
+*   **Endereço Web Externo**: [http://100.127.147.8:3000](http://100.127.147.8:3000)
+
+## 🛠️ 2. Métodos de Consumo de Dados
+
+### A. Clonagem via Git
+Para baixar a base completa (~640MB) em qualquer máquina da sua rede Tailscale:
+```bash
+git clone http://100.127.147.8:3000/rodolpho/apitdn.git
+```
+
+### B. Download de Snapshot (ZIP)
+Para baixar a versão mais recente dos arquivos Markdown sem o histórico do Git:
+*   **URL**: [http://100.127.147.8:3000/rodolpho/apitdn/archive/master.zip](http://100.127.147.8:3000/rodolpho/apitdn/archive/master.zip)
+
+### C. Acesso aos Arquivos Raw (Markdown Puro)
+Para ler a documentação diretamente via URL (substitua o caminho conforme necessário):
+*   **Exemplo**: `http://100.127.147.8:3000/rodolpho/apitdn/raw/branch/master/fluig_rag_docs/README.md`
+
+## 🤖 3. Integração com LLMs Externas (RAG)
+Protocolo para agentes de IA que precisam acessar esta base de conhecimentos:
+
+### Passo 1: Autenticação (PAT)
+Gere um token em `Configurações > Aplicativos` e utilize no header das requisições.
+
+### Passo 2: Chamada de API para Conteúdo
+Para buscar a lista de arquivos ou o conteúdo de um diretório:
+`GET http://100.127.147.8:3000/api/v1/repos/rodolpho/apitdn/contents/fluig_rag_docs`
+
+### Passo 3: Header de Autorização
+```http
+Authorization: token [SEU_TOKEN_PAT]
+Accept: application/json
+```
+
+## 🔒 Segurança
+*   O acesso só é permitido para dispositivos autenticados na sua rede Tailscale.
+*   O servidor Gitea está rodando no usuário `gitea` no Raspberry Pi, isolado do sistema principal.