Hostel Management System Using Flask

Sistema de gerenciamento de albergues

Este é um aplicativo da Web baseado em frasco para gerenciar um albergue. Inclui funcionalidades para matricular alunos, gerenciar quartos, despesas de rastreamento e muito mais.

Características

• Inscreva os alunos com detalhes, incluindo nome, taxa, número da sala e imagem.
• Gerencie quartos e veja quais alunos são designados para quais salas.
• Rastreie as despesas mensais adicionando itens e seus preços.
• Veja uma lista de todos os alunos e quartos.
• Design responsivo usando Bootstrap.

Tecnologias usadas

• Python
• Balão
• Sqlalchemy
• Flask-wtf
• Bootstrap
• Sqlite
• Pipenv

Ferramentas de desenvolvimento recomendadas

• Vs código
• Formatador preto

Configuração e instalação

1. Clone o repositório:

   git clone https://github.com/yourusername/Hostel-Management-System-Using-Flask.git
   cd Hostel-Management-System-Using-Flask

2. Crie um ambiente virtual e ative -o (o nome do diretório de ambiente virtual é .venv ):

   python3 -m venv .venv
   source .venv/bin/activate  # On Windows use `.venvScriptsactivate`

3. Instale o pipenv Package Manager

   pip install pipenv

4. Instale as dependências:

   pipenv install

5. Inicialize o banco de dados:

   flask db init
   flask db upgrade

6. Execute o aplicativo:

   flask run

7. Abra seu navegador e navegue para http://127.0.0.1:5000 .

Estrutura de aplicação

• app.py : arquivo de aplicativo principal contendo rotas e lógica.
• models.py : modelos de banco de dados para aluno, quarto e despesa.
• forms.py : formulários para matricular alunos e adicionar despesas.
• templates/ : modelos html para as páginas de aplicação.
• static/ : arquivos estáticos, incluindo CSS e imagens.
• migrations/ : Arquivos de migração de banco de dados.

Rotas

• / : Página inicial com links para se inscrever, ver os alunos, visualizar quartos e gerenciar despesas.
• /enroll : formulário para inscrever um novo aluno.
• /students : Lista de todos os alunos matriculados.
• /rooms : Lista de todos os quartos e seus alunos designados.
• /expenses : formulário para adicionar despesas e visualizar o total de despesas mensais.

Licença

Este projeto está licenciado sob a licença do MIT. Consulte o arquivo de licença para obter mais detalhes.

Contribuindo

As contribuições são bem -vindas! Abra um problema ou envie uma solicitação de tração.

Contato

Para qualquer dúvida ou sugestão, entre em contato com [email protected].