⚙️ How to Run the Project

Attention: The platform was developed using the Flask framework. Therefore, it is necessary to run some commands in the VS Code terminal to execute it properly.

📌 Step by step:
1. Open the VS Code application
2. Open the project folder
(Important: extract the files if they are in a .zip format)
3. Open the integrated terminal in VS Code
4. Run the following commands one at a time:
python3 -m venv venv (if using Windows: python -m venv venv)
source venv/bin/activate (if using Windows: venv\Scripts\activate)
pip install flask
pip install requests
pip install flask flask_sqlalchemy werkzeug pymysql
flask shell

5. Inside the interactive terminal, type:
from app import db
db.create_all()
exit()

6. Then run:
flask run --debug

7. Click on the link generated in the terminal to access the application in your browser.


📘 User Manual – Voz de Menina
1. System Access

Create an account on our platform!
Once logged in, you will see a sidebar menu with the main sections:

🏠 Home
🎓 Modules
ℹ️ Information
🎥 Videos
🤝 Support Networks
📔 Diary
⚡ Quick Exit
2. Learning Modules

In the Modules section, you can learn through quizzes and educational content.

How to use:
Click on "Start module"
Answer the activities

Track your progress:

✅ Completed
⏳ In progress
❌ Not started
3. Information (Educational Content)

Here you will find important explanations about various topics.

How to use:
Choose a topic
Click on "Open"
Read the content carefully
4. Videos

Section with educational video content.

How to use:
Click the link to access the full library (Drive)
Watch the videos available on the page
5. Support Networks

Section to find help.

Available resources:
📞 Dial 180 – Women’s Support Hotline
🚨 Emergency: 190
🚑 Ambulance (SAMU): 192
🚒 Fire Department: 193
How to use:
Enter your city
Select your country (e.g., Brazil)
Click Search
You can also filter by health, safety, etc.
6. Diary

A personal space to write thoughts and feelings.

How to use:
Write in the field "Write a note..."
Click Add
View your entries below
7. Quick Exit

A safety button.

Purpose:
Quickly exit the platform to a neutral website
Useful in situations where you need to close the site urgently
8. Profile

Located in the top-left corner:

Access your profile
View or edit personal information
Add emergency contacts
9. Logout Button

At the bottom of the menu, click "Logout" to sign out.

⚠️ Note

Some features of the platform are still in the prototype phase and will be implemented in future versions.

🚀 Planned Improvements
Implementation of a performance tracking system, showing the percentage of correct answers after completing a module.
Display of user productivity indicators on the home page, allowing clearer tracking of progress and engagement.
Addition of a password recovery feature (“Forgot password”), ensuring greater autonomy and accessibility for users.

------------------------------------------------------------------------------------------------------------------------------------------------------


⚙️ Como executar o projeto

Atenção: A plataforma foi desenvolvida utilizando o framework Flask. Portanto, é necessário executar alguns comandos no terminal do VS Code para rodá-la corretamente.

📌 Passo a passo:
1. Abra o aplicativo VS Code
2. Abra a pasta do projeto
(Importante: extraia os arquivos caso estejam compactados em .zip)
3. Abra o terminal integrado do VS Code
4. Execute os seguintes comandos um de cada vez:

python3 -m venv venv (python -m venv venv)
source venv/bin/activate (venv\Scripts\activate)
pip install flask
pip install requests
pip install flask flask_sqlalchemy werkzeug pymysql
flask shell

5. Dentro do terminal interativo, digite:
from app import db
db.create_all()
exit()
6. Em seguida, execute:
flask run --debug
7. Clique no link gerado no terminal para acessar a aplicação no navegador.



Manual de Uso – Voz de Menina

1. Acesso ao sistema
Crie uma conta em nossa plataforma!
Ao entrar na plataforma, você verá um menu lateral com as principais seções:

🏠 Início
🎓 Módulos
ℹ️ Informações
🎥 Vídeos
🤝 Redes de Apoio
📔 Diário
⚡ Saída rápida

2. Módulos de aprendizado
Na seção Módulos, você pode aprender através de quizzes e conteúdos educativos.
Como usar:

Clique em "Iniciar módulo"
Responda às atividades

Acompanhe o status:
✅ Concluído
⏳ Em andamento
❌ Não iniciado


3. Informações (Conteúdo educativo)
Aqui você encontra explicações importantes sobre diversos temas.
Como usar:
Escolha um tema
Clique em "Abrir"
Leia o conteúdo com atenção

4. Vídeos
Área com conteúdos educativos em vídeo.
Como usar:

Clique no link para acessar a biblioteca completa (Drive)
Assista aos vídeos disponíveis na página

5. Redes de Apoio
Seção para encontrar ajuda.
Recursos já disponíveis:

📞 Ligue 180 – Central de Atendimento à Mulher
🚨 Emergência: 190
🚑 SAMU: 192
🚒 Bombeiros: 193

Como usar:
Digite sua cidade
Escolha o país (ex: Brasil)
Clique em Buscar
Você também pode fitrar por saúde, segurança, etc

6. Diário
Espaço pessoal para escrever pensamentos e sentimentos.

Como usar:
Escreva no campo "Escreva um lembrete..."
Clique em Adicionar
Veja seus registros abaixo

7. Saída rápida
Botão de segurança.

Para que serve:
Sair rapidamente da plataforma para um site neutro
Útil em situações onde você precisa fechar o site com urgência

8. Perfil
Na parte superior esquerda:

Acesse seu perfil
Visualize ou edite informações pessoais
Cadastre contatos de Emergência

9. Botão de logout
No rodapé do menu, clique em "sair" para fazer logout

**Observação: Algumas funcionalidades da plataforma ainda se encontram em fase de protótipo e serão implementadas em versões futuras.

Melhorias previstas para a plataforma:

Implementação de um sistema de cálculo de desempenho, apresentando a porcentagem de acertos ao final de cada módulo concluído.
Exibição de indicadores de produtividade do usuário na página inicial, permitindo um acompanhamento mais claro do progresso e engajamento.
Inclusão da funcionalidade de recuperação de senha (“Esqueci minha senha”), garantindo maior autonomia e acessibilidade no acesso à conta.