📖 Solix Docs

Repositório oficial de documentação técnica do Solix
_{Arquitetura, padrões, decisões e guias para contribuidores e agentes de IA.}

Sobre • Como usar • Organização • Contribuição

---

🧭 Sobre

Este repositório contém toda a documentação técnica do Solix — o aplicativo desktop que torna a configuração do Linux simples, bonita e acessível para todos.

Aqui você encontrará:

• Arquitetura do sistema e fluxo de dados
• Documentação do backend (Rust/Tauri) e frontend (TypeScript)
• Decisões técnicas registradas como ADRs (Architecture Decision Records)
• Padrões de código e convenções do projeto
• Estratégia de testes e cobertura
• Processo de releases e distribuição
• Roadmap e histórico de evolução
• Guias práticos para desenvolvimento
• Documentação para agentes de IA que venham a contribuir

---

📖 Como usar

Este repositório é independente do código-fonte do Solix. Você pode navegá-lo diretamente no GitHub ou lê-lo localmente.

Leitores	Como usar
👨‍💻 Desenvolvedores	Comece por guides/getting-started.md e consulte a arquitetura em architecture/
🤖 Agentes de IA	Comece por ai-agents/overview.md para entender o contexto completo do projeto
🧠 Curiosos	Explore philosophy/ para entender a visão do projeto e roadmap/ para ver o que vem por aí

---

🗂️ Organização

solix-docs/
├── architecture/     # Visão geral da arquitetura e fluxo de dados
├── backend/          # Documentação do backend Rust/Tauri
├── frontend/         # Documentação do frontend TypeScript
├── decisions/        # ADRs — decisões técnicas registradas
├── standards/        # Padrões de código e convenções
├── testing/          # Estratégia de testes e cobertura
├── releases/         # Versionamento, distribuição e changelog
├── roadmap/          # Features planejadas e histórico
├── ux-ui/            # Design system, componentes e localização
├── philosophy/       # Manifesto, público-alvo e visão do projeto
├── ai-agents/        # Documentação otimizada para agentes de IA
├── guides/           # Tutoriais práticos e checklists
└── references/       # Glossário e links externos

Cada diretório contém arquivos Markdown com propósito claro e escopo definido.

---

🤝 Contribuição

Este repositório aceita contribuições! Veja como ajudar:

1. Correções: Encontrou algo desatualizado ou errado? Abra uma issue ou PR.
2. Novas seções: Quer documentar algo que não está aqui? Siga a estrutura existente.
3. ADRs: Toda decisão técnica relevante deve ser registrada em decisions/.

Leia guides/getting-started.md para saber mais.

---

📜 Licença

MIT — Copyright (c) 2026 Rafa-MKR2

---

_{Solix — Linux para todos. Documentado para sempre.}