Projeto Nexus

O Nexus é um sistema para gerenciar arquivos e pastas usando Django REST Framework. Ele permite fazer upload, organizar arquivos e registrar ações no sistema. A autenticação usa JWT em cookies.

Tecnologias usadas

• Python 3.12+
• Django e Django REST Framework
• PostgreSQL
• UV
• Docker

Como rodar o projeto

Instalar o UV

Windows:

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Linux/Mac:

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

Baixar o projeto e instalar dependências

git clone <url-do-seu-repo>
cd nexus_system
uv sync

Ativar o ambiente virtual

Windows:

.\.venv\Scripts\activate

Linux/Mac:

source .venv/bin/activate

Configurar o banco de dados

Com Docker:

docker-compose up -d db

Ou crie um arquivo .env com as credenciais do PostgreSQL.

Criar tabelas e usuário admin

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

Rodar o servidor

uv run python manage.py runserver

API: http://localhost:8000/api/
Admin: http://localhost:8000/admin/

O que já funciona

• Cadastro e login com JWT
• Upload, listagem e exclusão de arquivos
• Criação e navegação de pastas
• Compressão de arquivos
• Logs de auditoria

Comandos úteis

Verificar lint:

uv run ruff check .

Corrigir:

uv run ruff check --fix .

Formatar:

uv run ruff format .