📌 Base Técnica do Legatum Vivum

1. Introdução

O Legatum Vivum é um sistema estruturado para registrar, organizar e preservar conhecimento de maneira livre e acessível. Sua base técnica foi projetada para garantir simplicidade, eficiência e autonomia, permitindo que qualquer pessoa interessada possa entender seu funcionamento e contribuir para sua expansão.

Este documento detalha como o sistema está estruturado, os principais componentes utilizados e a lógica por trás do seu funcionamento.

2. Estrutura do Sistema

O sistema é composto por três camadas principais:

2.1 Camada de Conteúdo (Markdown - `.md`)

📌 Arquivos Markdown organizados modularmente:
- ✅ Facilitam a edição e organização da informação.
- ✅ Permitem colaboração e versionamento.
- ✅ Mantêm a formatação estruturada para a geração do site.

📂 Diretórios principais:

legatumvivum/
│── docs/                    # Diretório raiz do conteúdo
│   │── index.md             # Página inicial do site
│   │── fundamentos/         # Documentos principais (manifesto, diretrizes)
│   │── colunas/             # Registros históricos e testemunhos
│   │── pratica/             # Planejamento, eventos e registros contínuos
│   │── workflow/            # Organização estratégica e interações
│   │── base_tecnica/        # Documentação técnica do sistema
│   │── referencias/         # Fontes e insights
│   │── imagens/             # Armazenamento de imagens
│── mkdocs.yml               # Arquivo de configuração do MkDocs

2.2 Camada de Processamento (MkDocs)

📌 O MkDocs transforma os arquivos Markdown em um site navegável, garantindo: - ✅ Geração rápida de um site estático para consulta eficiente. - ✅ Personalização de temas e navegação para melhor organização. - ✅ Facilidade de manutenção e atualização do conteúdo.

📂 Principais arquivos do MkDocs:

legatumvivum/
└── mkdocs.yml  # Arquivo de configuração que define a estrutura do site

🔍 Fluxo de atualização do site:
1. Editamos ou criamos um arquivo .md. 2. Geramos o site estático com mkdocs build --clean. 3. Testamos localmente com mkdocs serve. 4. Transferimos os arquivos para o servidor com rsync. 5. O Nginx serve o site publicamente.

2.3 Camada de Publicação (VPS + Nginx)

📌 O site gerado pelo MkDocs é armazenado e servido via Nginx, garantindo: - ✅ Acesso público e escalável ao conteúdo. - ✅ Velocidade e segurança na entrega dos arquivos.

🔧 Infraestrutura:
✅ VPS dedicado para garantir controle total sobre os dados.
✅ Nginx como servidor web para melhor desempenho.
✅ Certbot (Let's Encrypt) para HTTPS e segurança.
✅ Rsync para sincronização rápida e eficiente dos arquivos.

3. Fluxo da Arquitetura

A estrutura do sistema foi desenhada para ser simples, eficiente e expansível, utilizando ferramentas leves e confiáveis:

✅ Markdown (.md) → Escrita estruturada e flexível.
✅ MkDocs → Transformação do conteúdo em um site navegável.
✅ VPS com Nginx → Hospedagem segura e escalável.
✅ Rsync → Sincronização rápida e eficiente de arquivos.
✅ Certbot (Let's Encrypt) → Ativação e renovação automática do HTTPS.

📌 Objetivo: Criar um sistema que seja sustentável, flexível e acessível, permitindo fácil expansão sem complicações técnicas.

4. Próximos Passos

🔹 Agora que a base do sistema está estruturada, podemos aprimorar: - ✅ A configuração detalhada do MkDocs, incluindo temas e customizações. - ✅ A automalção do deploy para o VPS com integração simplificada. - ✅ A otimização da performance e segurança do ambiente.

📌 O próximo documento será comandos.md, listando todos os comandos essenciais para rodar e manter o Legatum Vivum! 🚀