RPG System API 🎮

Uma API RESTful moderna para gerenciamento de sistemas RPG, construída com FastAPI, SQLAlchemy e SQLite.

🚀 Recursos

• ✅ Criação e gerenciamento de personagens
• ✅ Persistência de dados em banco de dados
• ✅ Documentação automática interativa (Swagger UI)
• ✅ Validação de dados com Pydantic
• ✅ Arquitetura limpa e escalável

📋 Pré-requisitos

• Python 3.7+
• pip (gerenciador de pacotes Python)

🔧 Instalação

1. Clone o repositório

git clone https://github.com/seu-usuario/rpg-system.git
cd rpg-system

2. Crie um ambiente virtual

python -m venv venv

3. Ative o ambiente virtual

Windows (PowerShell):

.\venv\Scripts\Activate.ps1

Windows (CMD):

.\venv\Scripts\activate.bat

Linux/Mac:

source venv/bin/activate

4. Instale as dependências

pip install -r requirements.txt

▶️ Como Executar

Com o ambiente virtual ativado, execute:

uvicorn app.main:app --reload

A API estará disponível em:

• 🌐 Servidor: http://127.0.0.1:8000
• 📚 Documentação Interativa (Swagger): http://127.0.0.1:8000/docs
• 📖 Documentação Alternativa (ReDoc): http://127.0.0.1:8000/redoc

📚 Endpoints

Criar Personagem

POST /characters
Content-Type: application/json

{
  "name": "Aragorn",
  "class": "Ranger",
  "level": 10
}

Obter Personagem

GET /characters/{character_id}

Listar Personagens

GET /characters

📁 Estrutura do Projeto

rpg-system/
├── app/
│   ├── __init__.py
│   ├── main.py                 # Ponto de entrada da API
│   ├── database.py             # Configuração do banco de dados
│   ├── models/
│   │   └── character.py        # Modelo de dados do personagem
│   ├── schemas/
│   │   └── character_schema.py # Validação de dados (Pydantic)
│   ├── routes/
│   │   └── character_routes.py # Endpoints da API
│   ├── services/
│   │   └── character_service.py # Lógica de negócio
│   └── core/                   # Configurações gerais
├── tests/                      # Testes automatizados
├── requirements.txt            # Dependências do projeto
├── rpg_system.db              # Banco de dados SQLite
└── README.md                   # Este arquivo

🛠️ Stack Tecnológico

• FastAPI - Framework web moderno e rápido
• Uvicorn - Servidor ASGI
• SQLAlchemy - ORM para banco de dados
• Pydantic - Validação de dados
• SQLite - Banco de dados leve

📦 Dependências Principais

Veja requirements.txt para a lista completa:

• fastapi
• uvicorn
• sqlalchemy
• pydantic

🤝 Contribuindo

Contribuições são bem-vindas! Para contribuir:

1. Faça um fork do projeto
2. Crie uma branch para sua feature (git checkout -b feature/MinhaFeature)
3. Commit suas mudanças (git commit -m 'Adiciona MinhaFeature')
4. Push para a branch (git push origin feature/MinhaFeature)
5. Abra um Pull Request

📝 Licença

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

👨‍💻 Autor

Matheus

📧 Suporte

Para dúvidas ou sugestões, abra uma issue no repositório.

---

Última atualização: Maio 2026