Sistema de Cadeia Dominial

Sistema web para gestão e visualização de cadeias dominiais de terras indígenas, desenvolvido em Django.

---

✨ Principais Funcionalidades

• 🌳 Visualização Interativa em Árvore - Diagrama D3.js com zoom e pan
• 📊 Gestão Completa - TIs, Imóveis, Documentos (Matrículas/Transcrições) e Lançamentos
• 🔍 Detecção de Duplicatas - Prevenção automática de dados duplicados
• 🔗 Rastreamento de Cadeia - Histórico completo desde a origem até o presente
• 📤 Exportação de Dados - Excel, PDF e JSON
• 🏛️ Base de Cartórios - Gestão de Cartórios de Registro de Imóveis (CRI)
• 🎯 Interface Moderna - Design responsivo e intuitivo

---

🚀 Quick Start

1. Instale o uv (instalador Python ultra-rápido)

# Linux/macOS
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

2. Clone e configure

git clone https://github.com/transistir/CadeiaDominial.git
cd CadeiaDominial

# Crie ambiente e instale dependências
uv venv
source .venv/bin/activate  # Linux/macOS - Windows: .venv\Scripts\activate
uv pip install -r requirements.txt

# Configure ambiente
cp env.example .env
# Edite .env: configure SECRET_KEY e ADMIN_PASSWORD

3. Inicialize o banco de dados

uv run python manage.py migrate
uv run python manage.py criar_tipos_documento
uv run python manage.py criar_tipos_lancamento
uv run python manage.py createsuperuser

4. Inicie o servidor

uv run python manage.py runserver

🎉 Pronto! Acesse: http://localhost:8000

---

📚 Documentação

Para Usuários

• Guia de Instalação - Instruções detalhadas de instalação e configuração
• Guia do Usuário - Como usar o sistema completo
• Documentação Completa - Índice de toda documentação

Para Desenvolvedores

• Guia de Desenvolvimento - Setup de dev, testes e debugging
• Arquitetura do Sistema - Arquitetura detalhada e padrões de código
• Roadmap - Planejamento de versões futuras
• Como Contribuir - Guia para contribuidores

Deploy e Produção

• Deploy com Docker - Configuração Docker completa
• Checklist de Produção - Guia para deploy em produção

---

🛠️ Tecnologias

Backend:

• Django 5.2.3
• Python 3.8+
• PostgreSQL (produção) / SQLite (desenvolvimento)

Frontend:

• HTML5, CSS3, JavaScript
• Bootstrap 5
• D3.js (visualização em árvore)
• django-autocomplete-light

Outros:

• WeasyPrint (geração de PDF)
• openpyxl (exportação Excel)

---

🧪 Executando Testes

# Instale dependências de teste
uv pip install -r requirements-test.txt

# Execute todos os testes
uv run pytest

# Com relatório de cobertura
uv run pytest --cov=dominial --cov-report=html

# Ou use Django test runner
uv run python manage.py test

Para mais detalhes sobre testes, veja Guia de Desenvolvimento.

---

🤝 Como Contribuir

Contribuições são bem-vindas! Por favor, leia o Guia de Contribuição para detalhes sobre:

• Como reportar bugs
• Como sugerir funcionalidades
• Processo de desenvolvimento
• Padrões de código
• Processo de Pull Request

Issues boas para começar:

• Procure labels good first issue e help wanted
• Veja as issues abertas

---

📋 Versão Atual: Beta 1.0.0

Esta é a primeira versão beta, disponível para testes com clientes.

Status: Em testes | Próxima versão: 1.0.0 (Março 2025)

Veja o Roadmap completo para funcionalidades planejadas.

---

📄 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.

---

📞 Suporte

• Documentação: docs/README.md
• Issues: GitHub Issues
• Discussões: GitHub Discussions

---

Desenvolvido pela equipe Transistir

Documentação • Contribuir • Roadmap • Changelog