Organize repository for public visibility with README, LICENSE, and wiki docs

.gitignore

@@ -0,0 +1,38 @@
+# NetBeans project files
+/*/nbproject/private/
+nbproject/private/
+**/nbproject/private/
+
+# Build outputs
+/*/build/
+/*/dist/
+build/
+dist/
+
+# IDE specific
+*.class
+*.jar
+*.log
+*.ctxt
+.mtj.tmp/
+*.war
+*.nar
+*.ear
+*.zip
+*.tar.gz
+*.rar
+
+# NetBeans specific
+nbactions.xml
+nb-configuration.xml
+
+# System files
+.DS_Store
+Thumbs.db
+*.swp
+*~
+
+# Temporary files
+*.tmp
+*.bak
+*.orig

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Alexandru Tutunaru, André Nunes, Cosmin Ciocan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -0,0 +1,175 @@
+# 📋 Sistema de Gestão de Registos Pessoais
+
+> **Trabalho Prático 3 - Algoritmia e Estruturas de Dados**  
+> Ano Letivo: 2024/2025 | Universidade do Algarve
+
+![Java](https://img.shields.io/badge/Java-Swing-orange?logo=java)
+![NetBeans](https://img.shields.io/badge/IDE-NetBeans-blue)
+![License](https://img.shields.io/badge/License-MIT-green)
+
+## 👥 Autores
+
+| Nome | Email |
+|------|-------|
+| Alexandru Tutunaru | a58379@ualg.pt |
+| André Nunes | a89979@ualg.pt |
+| Cosmin Ciocan | a89983@ualg.pt |
+
+---
+
+## 📖 Sobre o Projeto
+
+Este projeto consiste numa **aplicação gráfica em Java (Swing)** para gerir registos de pessoas. Foi desenvolvido como parte do Trabalho Prático 3 da unidade curricular de Algoritmia e Estruturas de Dados.
+
+### Objetivo Principal
+
+Desenvolver uma aplicação com suporte para:
+
+- ✅ Leitura e gravação de ficheiros de texto e binário
+- ✅ Visualização em tabelas dos dados
+- ✅ Separação automática por género
+- ✅ Ordenação por nome
+- ✅ Edição e remoção de registos
+- ✅ Exportação dos dados em diferentes formatos
+- ✅ Interface intuitiva com contadores visuais
+
+---
+
+## ✨ Funcionalidades
+
+| Funcionalidade | Descrição |
+|----------------|-----------|
+| 📂 **Leitura de Ficheiros** | Suporte automático para `.txt` e `.bin` |
+| 👤 **Separação por Género** | Três abas: Masculino, Feminino e Desconhecido |
+| 🔢 **Contadores** | Contagem automática de registos em cada aba |
+| ✏️ **Edição** | Edição e eliminação com ações diretas na tabela |
+| 🔍 **Pesquisa** | Pesquisa instantânea com árvore binária (BST) |
+| 💾 **Exportação** | Exportação para ficheiros em texto estruturado |
+| ⚠️ **Validação** | Mensagens de aviso quando não há dados |
+| 🧠 **Dedução de Género** | Dedução automática via hashtable para nomes ambíguos |
+
+---
+
+## 🗂️ Estrutura do Projeto
+
+```
+AlgoritmiaTP3/
+├── TP2lib/                      # Biblioteca com lógica e estruturas de dados
+│   └── src/tp2lib/              # Classes utilitárias e estruturas
+│       ├── Pessoa.java          # Modelo de dados principal
+│       ├── ListaDupla.java      # Lista duplamente ligada personalizada
+│       ├── BSTree.java          # Árvore binária de pesquisa
+│       ├── ELEM.java            # Elemento da lista ligada
+│       ├── FicheiroBinario.java # Manipulação de ficheiros binários
+│       ├── FicheiroTexto.java   # Manipulação de ficheiros de texto
+│       ├── GestorLista.java     # Gestão de listas
+│       └── Utils.java           # Utilidades gerais
+│
+├── TP3_GUI/                     # Interface Gráfica (Swing)
+│   └── src/
+│       ├── app/Main.java        # Classe principal da aplicação
+│       ├── gui/                 # Componentes Swing
+│       │   ├── MainFrame.java   # Janela principal
+│       │   ├── ButtonEditor.java
+│       │   └── ButtonRenderer.java
+│       └── icon/                # Ícones da interface
+│
+├── .gitignore                   # Ficheiros a ignorar pelo Git
+└── README.md                    # Este ficheiro
+```
+
+---
+
+## 📊 Estruturas de Dados Utilizadas
+
+### Lista Duplamente Ligada (`ListaDupla`)
+Implementação própria sem uso de `ArrayList`, com suporte para:
+- Adição no início e fim
+- Remoção
+- Ordenação por bubble-sort
+- Iteração
+
+### Árvore Binária de Pesquisa (`BSTree`)
+Utilizada para otimizar a pesquisa por nome com complexidade O(log n) em casos balanceados.
+
+### Hashtable
+Utilizada para dedução de género em nomes ambíguos, baseada nas terminações dos nomes.
+
+---
+
+## 🛠️ Formatos de Ficheiro Suportados
+
+| Formato | Descrição |
+|---------|-----------|
+| **Texto (`.txt`)** | Nome, data de nascimento, telefone (separados por vírgula) |
+| **Binário (`.bin`)** | Serialização de objetos `Pessoa` |
+
+---
+
+## 🚀 Como Executar
+
+### Requisitos
+- **Java JDK 8+**
+- **NetBeans IDE** (recomendado) ou outra IDE compatível com Java Swing
+
+### Passos
+
+1. Clone o repositório:
+   ```bash
+   git clone https://github.com/DevPool1/AlgoritmiaTP3.git
+   ```
+
+2. Abra o projeto no NetBeans:
+   - **File → Open Project**
+   - Selecione a pasta `TP3_GUI`
+
+3. Configure as dependências:
+   - O projeto `TP3_GUI` depende de `TP2lib`
+   - Verifique se a biblioteca `TP2lib.jar` está incluída
+
+4. Execute a aplicação:
+   - Execute a classe `Main.java` em `src/app/`
+
+---
+
+## 📸 Screenshots
+
+*A interface apresenta três abas principais para visualização de registos por género, com funcionalidades de pesquisa, edição e exportação.*
+
+---
+
+## 📚 Documentação Adicional
+
+Para mais detalhes sobre o projeto, consulte a [Wiki](./docs/wiki/Home.md).
+
+---
+
+## 🔧 Observações Técnicas
+
+- As listas são estruturas próprias (`ListaDupla`), sem uso de `ArrayList`
+- Foi utilizada uma árvore binária para otimizar a pesquisa por nome
+- Para dedução de género em nomes ambíguos, foi usada uma Hashtable baseada nas terminações
+- O sistema identifica e separa registos automaticamente com base no género deduzido
+
+---
+
+## 📜 Licença
+
+Este projeto foi desenvolvido para fins académicos na Universidade do Algarve.
+
+---
+
+## 🎓 Conclusão
+
+Este projeto permitiu aplicar os conhecimentos adquiridos ao longo da unidade curricular de **Algoritmia e Estruturas de Dados**, envolvendo:
+
+- 📊 Estruturas dinâmicas
+- 🔄 Algoritmos de ordenação
+- 📁 Manipulação de ficheiros
+- 🖥️ Desenvolvimento de interfaces gráficas em Java
+
+---
+
+<p align="center">
+  <i>Desenvolvido com ❤️ na Universidade do Algarve</i>
+</p>

docs/wiki/01-Visao-Geral.md

@@ -0,0 +1,56 @@
+# 📖 Visão Geral
+
+## Introdução
+
+O **Sistema de Gestão de Registos Pessoais** é uma aplicação desktop desenvolvida em Java utilizando a biblioteca Swing para a interface gráfica. O sistema permite gerir informações de pessoas, incluindo nome, género, data de nascimento e número de telefone.
+
+## Arquitetura do Sistema
+
+O projeto está dividido em dois módulos principais:
+
+### 1. TP2lib (Biblioteca de Estruturas de Dados)
+
+Contém todas as estruturas de dados e lógica de negócio:
+
+- **Estruturas de dados**: Lista duplamente ligada, árvore binária de pesquisa
+- **Modelos**: Classe `Pessoa` para representação de registos
+- **Utilidades**: Classes para manipulação de ficheiros
+
+### 2. TP3_GUI (Interface Gráfica)
+
+Contém a interface gráfica do utilizador:
+
+- **Janela principal**: `MainFrame` com sistema de abas
+- **Componentes personalizados**: Editores e renderizadores de botões
+- **Recursos visuais**: Ícones e imagens
+
+## Fluxo de Dados
+
+```
+┌──────────────┐    ┌──────────────┐    ┌──────────────┐
+│   Ficheiro   │───▶│   TP2lib     │───▶│   TP3_GUI    │
+│  (.txt/.bin) │    │ (Parsing)    │    │ (Exibição)   │
+└──────────────┘    └──────────────┘    └──────────────┘
+       ▲                   │                   │
+       │                   ▼                   │
+       │           ┌──────────────┐           │
+       └───────────│   ListaDupla │◀──────────┘
+                   │    (Dados)   │
+                   └──────────────┘
+```
+
+## Requisitos do Sistema
+
+- **Java JDK**: Versão 8 ou superior
+- **IDE**: NetBeans (recomendado), Eclipse ou IntelliJ IDEA
+- **Sistema Operativo**: Windows, macOS ou Linux
+
+## Dependências
+
+O projeto utiliza apenas a biblioteca padrão do Java, com exceção de:
+
+- **FlatLaf**: Biblioteca para melhorar o visual da interface Swing
+
+---
+
+[← Voltar ao Índice](./Home.md) | [Próximo: Estruturas de Dados →](./02-Estruturas-de-Dados.md)