📄 Sistema de Notas & Clientes v1.0.0

Sistema web desenvolvido em Django para gerenciamento de clientes e notas fiscais, com controle de acesso baseado em perfis de usuário (Gerente e Consultor).

---

✨ Funcionalidades

Perfil	Permissões
Gerente	Cadastrar consultores · Verificar notas · Verificar/cadastrar clientes
Consultor	Inserir notas · Verificar notas

• 🔐 Autenticação com e-mail e senha
• 🔄 Redefinição de senha
• 👥 Cadastro de clientes com CPF ou CNPJ (com máscara via Inputmask)
• 🧾 Inserção, edição e exclusão de notas fiscais (NFS-e, NF-e, Fatura)
• 📎 Upload de arquivo PDF por nota fiscal
• 🛡️ Controle de permissões por role (django-role-permissions)
• 📋 Sidebar dinâmica — exibe apenas as opções permitidas para cada perfil

---

🛠️ Tecnologias

• Back-end: Python 3 · Django · django-role-permissions · python-dotenv
• Banco de dados: SQLite (desenvolvimento)
• Front-end: Bootstrap 4 · Inputmask · Google Fonts (Material Symbols)
• Outros: Django Signals · Django Messages Framework

---

🚀 Como executar localmente

Pré-requisitos

• Python 3.10+
• pip

Passos

# 1. Clone o repositório
git clone https://github.com/seu-usuario/Sistema-de-NotasClientess-v1.0.0.git
cd Sistema-de-NotasClientess-v1.0.0

# 2. Crie e ative o ambiente virtual
python -m venv venv
source venv/bin/activate        # Linux/macOS
venv\Scripts\activate           # Windows

# 3. Instale as dependências
pip install -r requirements.txt

# 4. Configure as variáveis de ambiente
cp .env.example .env
# Edite o arquivo .env e preencha SECRET_KEY e DEBUG

# 5. Execute as migrações
python manage.py migrate

# 6. Crie um superusuário (opcional)
python manage.py createsuperuser

# 7. Inicie o servidor
python manage.py runserver

Acesse em: http://localhost:8000/auth/login/

---

📁 Estrutura do Projeto

├── core/               # Configurações globais (settings, urls, roles)
├── login/              # App de autenticação (models, views, signals)
├── plataforma/         # App principal (clientes, notas fiscais)
├── templates/          # Templates HTML (base, login, plataforma)
├── static/             # Arquivos estáticos (CSS, SVGs)
├── media/              # Uploads de arquivos (ignorado pelo git)
├── .env.example        # Template de variáveis de ambiente
├── manage.py
└── requirements.txt

---

⚙️ Variáveis de Ambiente

Crie um arquivo .env na raiz do projeto a partir do .env.example:

Variável	Descrição
SECRET_KEY	Chave secreta do Django
DEBUG	True em desenvolvimento, False em produção

---

🔒 Segurança

• A SECRET_KEY e o arquivo .env nunca são enviados ao repositório (.gitignore configurado).
• O banco de dados db.sqlite3 e a pasta media/ também são ignorados.
• Em produção, configure DEBUG=False e ALLOWED_HOSTS adequadamente.

---

📌 Roadmap / Melhorias futuras

• Paginação nas listagens de notas e clientes
• Filtros e busca nas tabelas
• Exportação de relatórios em PDF/Excel
• Troca do banco para PostgreSQL em produção
• Testes automatizados

---

👤 Autor

Desenvolvido como projeto de portfólio.
Sinta-se livre para abrir issues ou pull requests com sugestões!