🏢 CondoReserva

Sistema web SaaS para gerenciamento de reservas de áreas comuns em condomínios residenciais, desenvolvido como projeto acadêmico da disciplina de Empreendedorismo na Tecnologia.

---

🚀 Sobre o Projeto

O CondoReserva é uma aplicação focada em resolver um problema operacional recorrente em pequenos e médios condomínios residenciais: o gerenciamento de reservas de áreas comuns e o controle automatizado da taxa de limpeza.

O projeto propõe uma solução moderna, simples e intuitiva para condomínios que ainda realizam reservas manualmente via grupos de WhatsApp, planilhas ou cadernos físicos na portaria.

O sistema foi idealizado com foco em:

• 🏢 Condomínios de pequeno e médio porte
• 📅 Reserva de áreas comuns
• 💰 Cobrança automatizada de taxa de limpeza
• 📲 Fluxo self-service para moradores
• ✅ Confirmação automática após pagamento
• 🔐 Redução de conflitos de agenda
• 👨‍💼 Redução da sobrecarga operacional do síndico

---

💡 Conceito da Solução

O CondoReserva funciona como uma plataforma SaaS B2B especializada exclusivamente no gerenciamento de reservas de áreas comuns.

Ao acessar o sistema, o morador consegue:

• selecionar o espaço desejado;
• visualizar datas disponíveis;
• realizar a reserva;
• efetuar o pagamento da taxa de limpeza via PIX;
• confirmar automaticamente o agendamento após o pagamento.

Já o síndico possui uma visão simplificada do processo, recebendo notificações das reservas confirmadas e fazendo gestão ativa quando for conveniente.

Exemplo:

Apartamento 302 reservou a churrasqueira para sábado.
Pagamento confirmado com sucesso.

---

⚠️ Problema Resolvido

Em muitos condomínios pequenos e médios, o gerenciamento de reservas ainda ocorre manualmente, gerando:

• conflitos entre moradores;
• dupla reserva de espaços;
• dificuldade de controle;
• inadimplência da taxa de limpeza;
• desgaste entre síndico e moradores.

O CondoReserva elimina esses problemas através da automação do fluxo de reserva e confirmação de pagamento.

---

🧠 Diferencial do Projeto

Ao invés de competir com sistemas completos de administração condominial, o CondoReserva adota a estratégia de MVP especializado.

O sistema executa uma única função principal, porém com foco total na experiência do usuário, simplicidade operacional e automação do processo.

Isso torna o projeto:

• mais viável tecnicamente;
• mais barato operacionalmente;
• mais simples para adoção;
• mais acessível para pequenos condomínios;
• mais rápido de implementar e validar.

---

📁 Estrutura do Projeto

CondoReserva/
│
├── app/
│   ├── index.html
│   │
│   ├── js/
│   │   ├── views/
|   |   |   ├── homeView.js
│   │   │   ├── loginView.js
│   │   │   ├── managerAreasView.js
│   │   │   ├── managerReservationsView.js
│   │   │   ├── managerUsersView.js
│   │   │   ├── managerView.js
│   │   │   └── userView.js
│   │   │
│   │   ├── utils/
|   |   |   ├── helpers.js
│   │   │   ├── pixModal.js
│   │   │   ├── reservationDetailsModal.js
│   │   │   ├── usersCreateModal.js
│   │   │   └── usersEditModal.js
│   │   │
│   │   ├── api.js
│   │   ├── auth.js
│   │   └── main.js
│   │
│   └── assets/
│       ├── favicon.png
│       │
│       └── images/
|           └── banner.png
│
├── docs/
│   ├── 01_plano_de_negocio.md
│   └── 02_business_canvas.md
│
├── server/
│   ├── app.js
│   │
│   ├── routes/
│   │   ├── areaRoutes.js
│   │   ├── authRoutes.js
│   │   ├── reservationRoutes.js
│   │   └── userRoutes.js
│   │
│   ├── controllers/
│   │   ├── areaController.js
│   │   ├── authController.js
│   │   ├── reservationController.js
│   │   └── userController.js
│   │
│   ├── database/
│   │   ├── connection.js
│   │   └── createDB.js
│   │
│   ├── middlewares/
│       └── authMiddleware.js
│
├── .gitignore
├── .env
├── env.js
├── CondoReserva.sqlite
├── package-lock.json
├── package.json
├── README.md
└── server.js

---

🗄️ Banco de Dados

O sistema utiliza SQLite como banco de dados local.

O banco é criado automaticamente durante a inicialização do servidor através do arquivo:

server/database/createDB.js

Tecnologia utilizada:

better-sqlite3

---

⚙️ Tecnologias Utilizadas

Tecnologia	Finalidade
Node.js	Ambiente de execução
Express	Servidor HTTP
SQLite	Persistência de dados
better-sqlite3	Integração com SQLite
HTML5	Estrutura do front-end
TailwindCSS	Estilização da interface
SweetAlert2	Estilização de Alertas
JavaScript Vanilla	Lógica do cliente
dotenv	Variáveis de ambiente
CORS	Comunicação entre aplicações
bcryptjs	Criptografia de senhas
jsonwebtoken	Autenticação via JWT
Nodemon	Ambiente de desenvolvimento
LiveReload	Atualização automática do navegador
connect-livereload	Integração do LiveReload com Express
Git/GitHub	Versionamento

---

📦 Dependências do Projeto

Instalação das dependências principais:

npm install express cors dotenv better-sqlite3 bcryptjs jsonwebtoken

Dependências de desenvolvimento:

npm install -D nodemon livereload connect-livereload

---

🔐 Autenticação

O sistema utiliza autenticação baseada em JWT (JSON Web Token) para gerenciamento de sessões e segurança das rotas protegidas.

As senhas dos usuários são armazenadas de forma criptografada utilizando:

bcryptjs

---

⚙️ Como Executar

1️⃣ Clonar o projeto

git clone <repositorio>

---

2️⃣ Instalar dependências

Instale todas as dependências do projeto:

npm install

---

3️⃣ Configurar variáveis de ambiente

Crie um arquivo .env dentro da raiz do projeto contendo:

SERVER_PORT=3000
JWT_SECRET=sua_chave_secreta

---

4️⃣ Executar o servidor

npm run dev

O banco SQLite será criado automaticamente caso não exista.

---

5️⃣ Acessar aplicação

Abra no navegador:

http://localhost:3000

O LiveReload atualizará automaticamente o navegador durante o desenvolvimento.

---

🎨 Interface

O front-end do CondoReserva utiliza:

TailwindCSS

A proposta visual do sistema prioriza:

• simplicidade;
• responsividade;
• velocidade de desenvolvimento;
• experiência do usuário;
• visual moderno e limpo.

---

🔮 Funcionalidades Futuras

• 📱 Responsividade Mobile
• 🔔 Notificações automáticas
• 💳 Integração real com PIX
• 👤 Controle completo de usuários
• ☁️ Deploy em nuvem
• 📊 Dashboard administrativo
• 📆 Calendário interativo avançado
• 📈 Relatórios de utilização
• 🏢 Multi-condomínios
• 🔐 Controle de permissões

---

👨‍💻 Integrantes do Grupo

• André Felipe Andrade Oliveira
• Isaac Oliveira Ferreira de Sousa
• Turiê Hermano de Oliveira
• Vítor Hugo Moreira

---

👩‍🏫 Disciplina

Empreendedorismo na Tecnologia

Professora:

• Vânia Borges de Oliveira

---

📚 Objetivo Acadêmico

Este projeto possui finalidade acadêmica e foi desenvolvido como atividade prática da disciplina de Empreendedorismo na Tecnologia, com foco em:

• Desenvolvimento de Planos de Negócio;
• Desenvolvimento de MVPs;
• Validação de problemas reais;
• Modelagem de soluções SaaS;
• Viabilidade tecnológica;
• Experiência do usuário;
• Arquitetura de aplicações web;
• Automação de processos operacionais.

---

📌 Observação

Projeto desenvolvido exclusivamente para fins educacionais e de aprendizado em desenvolvimento web, arquitetura de aplicações SaaS e MVP.