docs: heart introduction

app-modules/portal/src/Livewire/SocialLinksPage.php

@@ -6,6 +6,7 @@
 
 use He4rt\Portal\DTOs\SocialLink;
 use Illuminate\Contracts\View\View;
+use InvalidArgumentException;
 use Livewire\Attributes\Layout;
 use Livewire\Attributes\Title;
 use Livewire\Component;
@@ -19,14 +20,23 @@ final class SocialLinksPage extends Component
      */
     public static function links(): array
     {
-        return [
-            new SocialLink('Discord', 'https://discord.gg/invite/he4rt', 'fab-discord', '#5865F2'),
-            new SocialLink('X (Twitter)', 'https://x.com/He4rtDevs', 'fab-x-twitter', '#0F172A', '#FFFFFF'),
-            new SocialLink('LinkedIn', 'https://www.linkedin.com/company/he4rt/', 'fab-linkedin', '#0A66C2'),
-            new SocialLink('WhatsApp', 'https://chat.whatsapp.com/EBKjYxIodpe1x5LLExbTzK', 'fab-whatsapp', '#25D366'),
-            new SocialLink('Instagram', 'https://www.instagram.com/heartdevs/', 'fab-instagram', '#E4405F'),
-            new SocialLink('GitHub', 'https://github.com/he4rt', 'fab-github', '#111827', '#FFFFFF'),
-        ];
+        $links = [];
+
+        foreach (config()->array('he4rt.social_media') as $link) {
+            if (!is_array($link)) {
+                continue;
+            }
+
+            $links[] = new SocialLink(
+                label: self::field($link, 'label'),
+                url: self::field($link, 'url'),
+                icon: self::field($link, 'icon'),
+                accent: self::field($link, 'accent'),
+                accentDark: isset($link['accent_dark']) ? self::field($link, 'accent_dark') : null,
+            );
+        }
+
+        return $links;
     }
 
     public function render(): View
@@ -35,4 +45,16 @@ public function render(): View
             'links' => self::links(),
         ]);
     }
+
+    /**
+     * @param  array<array-key, mixed>  $link
+     */
+    private static function field(array $link, string $key): string
+    {
+        $value = $link[$key] ?? null;
+
+        throw_unless(is_string($value), InvalidArgumentException::class, sprintf("Configuração he4rt.social_media inválida: '%s' deve ser uma string.", $key));
+
+        return $value;
+    }
 }

config/he4rt.php

@@ -49,4 +49,18 @@
             'badges_count' => 0,
         ],
     ],
+
+    /*
+     * Fonte única das redes sociais da He4rt. Alimenta a página /redes
+     * (He4rt\Portal\Livewire\SocialLinksPage) e qualquer outro lugar que
+     * precise dos links. `accent_dark` é opcional (cai no `accent` quando ausente).
+     */
+    'social_media' => [
+        'discord' => ['label' => 'Discord', 'url' => 'https://discord.gg/invite/he4rt', 'icon' => 'fab-discord', 'accent' => '#5865F2'],
+        'twitter' => ['label' => 'X (Twitter)', 'url' => 'https://x.com/He4rtDevs', 'icon' => 'fab-x-twitter', 'accent' => '#0F172A', 'accent_dark' => '#FFFFFF'],
+        'linkedin' => ['label' => 'LinkedIn', 'url' => 'https://www.linkedin.com/company/he4rt/', 'icon' => 'fab-linkedin', 'accent' => '#0A66C2'],
+        'whatsapp' => ['label' => 'WhatsApp', 'url' => 'https://chat.whatsapp.com/EBKjYxIodpe1x5LLExbTzK', 'icon' => 'fab-whatsapp', 'accent' => '#25D366'],
+        'instagram' => ['label' => 'Instagram', 'url' => 'https://www.instagram.com/heartdevs/', 'icon' => 'fab-instagram', 'accent' => '#E4405F'],
+        'github' => ['label' => 'GitHub', 'url' => 'https://github.com/he4rt', 'icon' => 'fab-github', 'accent' => '#111827', 'accent_dark' => '#FFFFFF'],
+    ],
 ];

docs/introduction/como-participar.md

@@ -4,49 +4,39 @@ title: Como participar
 order: 5
 ---
 
-> ⚠️ Rascunho — revisar com a comunidade (datas/números/fatos são placeholders).
-
 # Como participar
 
-Entrar para a He4rt Developers é simples e gratuito. Aqui vão os primeiros
-passos para fazer parte da comunidade e começar a aprender e construir junto.
+Existem diferentes formas de fazer parte da comunidade. Dá uma olhada:
+
+## Discord
 
-## 1. Entre no Discord
+Você pode entrar no nosso servidor [clicando aqui](https://discord.gg/invite/he4rt). Lá dentro é só seguir a orientação do bot, fazer sua apresentação e pronto, você já faz parte oficialmente da comunidade. Dá para participar das reuniões semanais, aulões, spaces e muito mais.
 
-O Discord é o ponto de encontro da comunidade. É lá que acontecem as conversas
-do dia a dia, os avisos e as reuniões.
-[a confirmar: link oficial de convite do servidor no Discord.]
+## WhatsApp
 
-## 2. Se apresente
+Temos um grupo no WhatsApp dedicado à conversa e ao networking, para quem gosta de bater papo e viver mais de perto o dia a dia da comunidade. É uma ótima oportunidade para estar mais próximo da gente.
 
-Depois de entrar, passe pelo canal de boas-vindas
-**[a confirmar: nome do canal]** e conte um pouco sobre você: o que faz, o que
-está estudando e o que te trouxe até aqui. A comunidade adora conhecer gente
-nova.
+A gente publica as novidades por lá antes de qualquer outro lugar. Então, se quiser saber em primeira mão, [clique aqui](https://chat.whatsapp.com/EBKjYxIodpe1x5LLExbTzK).
 
-## 3. Participe das reuniões semanais
+## Projetos
 
-Toda semana acontecem encontros abertos a todo mundo. É uma ótima forma de
-conhecer pessoas e entrar no ritmo da comunidade. Veja os detalhes na página
-[Reuniões semanais](reunioes-semanais).
+Na aba de Iniciativas você viu que existem várias formas de contribuir, seja ensinando, desenvolvendo ou melhorando o que já existe. É um mundo de possibilidades esperando por você.
 
-## 4. Contribua com os projetos
+E não importa se você é de programação, design, negócios, produto, segurança, teste, liderança ou qualquer outra área. Sua contribuição é muito bem-vinda, com o conhecimento que você já tem.
 
-A He4rt mantém projetos open source feitos pela comunidade. Você pode contribuir
-com código, documentação, ideias ou ajudando outras pessoas.
-[a confirmar: link para os repositórios / organização no GitHub.]
+Para participar, é só chamar um administrador (com a tag He4rtless no Discord) ou um administrador do grupo do WhatsApp da comunidade.
 
-## 5. Conecte sua conta na plataforma
+## Parcerias, eventos ou oportunidades
 
-A plataforma he4rtdevs.com tem perfis, gamificação e acompanhamento da sua
-participação. Você pode entrar usando sua conta do Discord para começar a somar
-pontos e desbloquear conquistas.
+Se você quer trazer oportunidades para a comunidade ou propor uma parceria com a He4rt, fale direto com 7K ou danielhe4rt.
 
-## Precisa de ajuda?
+## Nossas redes
 
-Se ficar com qualquer dúvida, pergunte nos canais da comunidade — sempre tem
-alguém disposto a ajudar.
-[a confirmar: canal de suporte / dúvidas.]
+Fica por dentro de tudo e escolhe o canal que mais combina com você:
 
-> Os links e nomes de canais acima são placeholders. Confirme cada um com a
-> comunidade antes de publicar esta página.
+- [Discord](https://discord.gg/invite/he4rt)
+- [WhatsApp](https://chat.whatsapp.com/EBKjYxIodpe1x5LLExbTzK)
+- [X (Twitter)](https://x.com/He4rtDevs)
+- [LinkedIn](https://www.linkedin.com/company/he4rt/)
+- [Instagram](https://www.instagram.com/heartdevs/)
+- [GitHub](https://github.com/he4rt)

docs/introduction/iniciativas.md

@@ -0,0 +1,45 @@
+---
+type: introduction
+title: Iniciativas
+order: 3
+---
+
+# Iniciativas
+
+Temos várias iniciativas rodando ao longo do ano, e você pode acompanhar e participar de todas quando quiser.
+
+## Reunião Semanal
+
+É aqui que compartilhamos as novidades, os projetos, as atualizações e, o mais importante, as fofocas. Acontece toda segunda-feira, às 21h. Para participar, é só subir no palco com a gente e acompanhar.
+
+Não precisa ligar câmera nem microfone. Na verdade, você nem precisa falar nada, só ouvir e interagir pelo chat.
+
+Os avisos saem tanto no Discord quanto no nosso grupo do WhatsApp.
+
+## Aulões
+
+Aqui você aprende no 0800, com gente da área, sobre os mais diversos assuntos e com exemplos práticos. Os aulões são ministrados pelos próprios membros, que submetem seu conhecimento e conteúdo para os outros, numa data fixa, geralmente às quartas-feiras, mas pode variar.
+
+Não precisa ligar câmera nem microfone, só ouvir e interagir pelo chat.
+
+Submissões de conteúdo ou de interesse devem ser combinadas com a administração.
+
+## Spaces
+
+Enquanto os aulões trazem conteúdo mais técnico, os Spaces são conversas mais amplas, que nem sempre envolvem técnica. São mais sobre orientação, dicas de carreira e assuntos assim. Às vezes convidamos membros que se destacam em suas empresas para compartilhar um pouco da experiência deles, e também pessoas de fora com relevância no mercado.
+
+Não precisa ligar câmera nem microfone, só ouvir e interagir pelo chat.
+
+Submissões de conteúdo ou de interesse devem ser combinadas com a administração.
+
+## Squads
+
+Quer contribuir com a comunidade? Quer construir projetos ou desenvolver soluções e melhorias no que fazemos aqui? Então faça parte do He4rt Squad, times organizados que trabalham diretamente nos projetos da comunidade e são responsáveis por boa parte de tudo que acontece por aqui.
+
+Submissões de interesse devem ser combinadas com a administração.
+
+## Evangelistas
+
+Quer contribuir mas não sabe como, ou não tem domínio técnico? Então nos ajude engajando a comunidade. Seja alguém de linha de frente: vá a eventos, curta, comente, compartilhe nas redes sociais, participe das discussões sobre o futuro da comunidade e mostre a força da He4rt por aí.
+
+Não exige nenhuma habilidade ou conhecimento técnico, só a vontade genuína de ajudar.

docs/introduction/nossos-valores.md

@@ -4,41 +4,28 @@ title: Nossos valores
 order: 4
 ---
 
-> ⚠️ Rascunho — revisar com a comunidade (datas/números/fatos são placeholders).
-
 # Nossos valores
 
-Mais do que código, a He4rt Developers é feita de pessoas. Os valores abaixo são
-uma proposta de como enxergamos a convivência na comunidade — e precisam ser
-revisados e aprovados por quem faz a He4rt acontecer.
+Temos princípios e valores invioláveis que nos guiam e que nos trouxeram até aqui. É nosso dever, como membros, moderadores, administradores e líderes desta comunidade, repassar esses valores a todos, para que a gente nunca esqueça de onde veio e do que tem orgulho de defender.
 
-## Acolhimento
+## Aprendizado
 
-Queremos que todo mundo se sinta em casa, independentemente do nível de
-experiência, da formação ou da trajetória. Pergunta nenhuma é boba, e ninguém
-deveria ter medo de pedir ajuda.
+O conhecimento é a nossa base. Não importa a área: educação, tecnologia, marketing, design, negócios, cybersecurity, produto ou qualquer outra. Somos eternos aprendizes. Amamos o conhecimento e valorizamos cada compartilhamento, cada aula, cada documento ou artefato que passa por aqui. Somos guiados por uma sede insaciável de conhecimento e por uma verdade que carregamos com a gente:
 
-## Aprender ensinando
+> O conhecimento transforma e muda vidas.
 
-Acreditamos que a melhor forma de aprender é compartilhando. Quem ensina também
-aprende, e quem pergunta ajuda os próximos que terão a mesma dúvida.
+## Contribuição
 
-## Construir em conjunto
+Nossa filosofia é simples. Contribuição é o caminho mais rápido para que todos alcancem seus objetivos. Sozinho você pode ir longe, mas com ajuda, e ajudando, você vai muito mais longe. Esquece a ideia de que você está sozinho, lutando por conta própria. Aqui você luta ao lado de gente com o mesmo objetivo. Ninguém fica para trás. É nosso dever ajudar o próximo com conhecimento, orientação e oportunidades.
 
-Os projetos da comunidade são feitos a muitas mãos. Valorizamos a colaboração
-aberta, o open source e o crédito a quem contribui.
+## Pertencimento
 
-## Respeito e diversidade
+Você faz parte de algo muito maior do que um canal no Discord, no WhatsApp, no GitHub ou nas redes sociais. Você faz parte de uma família. Por isso costumamos nos chamar de primos e primas, porque no fundo é isso que somos: pessoas que nunca se conheceram na vida, mas que em algum momento decidiram se ajudar, construir um futuro melhor e colocar nossa bandeira nos lugares mais altos que a gente consegue imaginar. Não importa onde você esteja ou como esteja sua vida hoje. Aqui tem espaço para você. Um refúgio que acolhe e mostra como evoluir.
 
-A He4rt é um espaço para todas as pessoas. Não há lugar para preconceito,
-assédio ou qualquer forma de discriminação.
-[a confirmar: link para o Código de Conduta oficial da comunidade.]
+## Respeito
 
-## Transparência
+A gente não liga para gênero, cor, orientação sexual ou como você se porta. Não liga para títulos ou rótulos. O que importa é você como humano: o quanto você pode ajudar e o quanto podemos retribuir. Aqui você encontra um espaço seguro, cujo único objetivo é construir e contribuir com o máximo de respeito pelo próximo.
 
-Decisões importantes são discutidas abertamente com a comunidade. Esta própria
-documentação é um exemplo: tudo aqui pode ser revisado e melhorado.
+## Crescimento
 
-> Estes valores são um rascunho inicial. A redação final deve sair de uma
-> conversa com a comunidade — possivelmente referenciando um Código de Conduta
-> formal [a confirmar].
+Tudo que fazemos é para a comunidade e pela comunidade. Nossas ações, projetos, eventos, reuniões, aulões, spaces, palestras e lives se afunilam num único objetivo: crescer. Queremos elevar nossa comunidade, trazer oportunidades, mostrar caminhos e espalhar nossa palavra pelo Brasil e pelo mundo, com aquela sede insaciável de sempre, para que todo mundo conheça a He4rt.

docs/introduction/o-que-e-a-he4rt.md

@@ -6,7 +6,22 @@ order: 1
 
 # O que é a He4rt
 
-A He4rt Developers é uma comunidade brasileira de pessoas desenvolvedoras que
-se reúne para aprender, ensinar e construir projetos em conjunto. Este portal
-documenta como a plataforma funciona, das decisões de arquitetura ao dia a dia
-de cada módulo.
+A He4rt nasceu em 2018, numa live do Daniel Reis. Ele decidiu reunir pessoas apaixonadas por programação para ensinar, construir e desenvolver projetos juntos. Aquele grupo de amigos virou, com o tempo, uma das maiores comunidades de tecnologia da América Latina. Hoje somos a maior comunidade de tecnologia open source do Brasil.
+
+Nosso objetivo é ser um hub de oportunidades. Conectar pessoas, ensinar, compartilhar e aprender. Somos apaixonados por tecnologia e por tudo que ela pode transformar.
+
+## Nossa linha do tempo
+
+**2018.** A He4rt nasce. É criado o servidor oficial da comunidade.
+
+**2019.** Lançamos o **4noob**, um repositório gratuito que ensinava tecnologia e programação do absoluto zero até o nível intermediário, antes mesmo da popularização da IA. Todo o conteúdo foi produzido pela própria comunidade e se tornou um dos maiores acervos gratuitos da época. Até hoje é nosso maior case de sucesso.
+
+**2020.** Organizamos o Microsoft 365 Bootcamp através dos canais da He4rt Developers, cuidando de toda a produção do evento.
+
+**2021.** Fizemos a maior live de tecnologia do ano: nossa primeira conferência, a **He4rt Conf 2021**, com mais de 42 mil espectadores únicos.
+
+**2022.** Nosso primeiro meetup presencial, em parceria com a 44SP, uma das maiores faculdades de tecnologia da América Latina, com apoio da Microsoft, Accusense, Código Falado e Breno Mazieiro.
+
+**2026.** Chegamos aos 25 mil membros no Discord. Entramos numa fase de crescimento acelerado com o desenvolvimento da nossa própria plataforma, a He4rt Hub. Também firmamos parceria com a 3Pontos para o LaravelDaySP, trazendo ao Brasil dois representantes do core team do Laravel, o maior framework PHP do mundo, com quase 77 mil espectadores únicos na Twitch.
+
+E isso é só o começo.