https://github.com/gabrielmaialva33/innkeeper
Modern multi-tenant hotel management system built with AdonisJS and React
https://github.com/gabrielmaialva33/innkeeper
adonisjs adonisjs-framework adonisjs6 boilerplate bull inertiajs inertiajs-react jwt management multi-tenant postgresql rbac react react19 redis tailwind web
Last synced: 2 months ago
JSON representation
Modern multi-tenant hotel management system built with AdonisJS and React
- Host: GitHub
- URL: https://github.com/gabrielmaialva33/innkeeper
- Owner: gabrielmaialva33
- License: mit
- Created: 2025-07-31T00:19:35.000Z (3 months ago)
- Default Branch: master
- Last Pushed: 2025-07-31T05:49:58.000Z (3 months ago)
- Last Synced: 2025-07-31T06:37:21.972Z (3 months ago)
- Topics: adonisjs, adonisjs-framework, adonisjs6, boilerplate, bull, inertiajs, inertiajs-react, jwt, management, multi-tenant, postgresql, rbac, react, react19, redis, tailwind, web
- Language: TypeScript
- Homepage:
- Size: 261 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README-pt.md
- License: LICENSE
Awesome Lists containing this project
README
🏨 Innkeeper
Um Sistema Moderno de Gerenciamento Hoteleiro Multi-Tenant
Sobre |
Funcionalidades |
Tecnologias |
Instalação |
Licença
## :bookmark: Sobre
**Innkeeper** é um sistema completo de gerenciamento hoteleiro multi-tenant projetado para otimizar e modernizar as
operações hoteleiras. Construído sobre uma base robusta de backend **AdonisJS v6** e frontend **React 19** com \*
\*Inertia.js\*\*, fornece uma solução completa para gerenciar múltiplas propriedades hoteleiras a partir de uma única
plataforma.
Este sistema atende às necessidades complexas dos negócios de hospitalidade modernos, desde pequenos hotéis boutique até
grandes cadeias hoteleiras. Com sua arquitetura multi-tenant, cada propriedade hoteleira mantém isolamento completo de
dados enquanto se beneficia de infraestrutura compartilhada e recursos de gerenciamento centralizado.
### 🏗️ Visão Geral da Arquitetura
```mermaid
graph TB
subgraph "🖥️ Frontend"
UI["🌐 React + Inertia.js
Portal do Hóspede • Painel da Equipe • Painel Admin"]
end
subgraph "🔧 Serviços Backend"
API[AdonisJS API]
AUTH[Auth Multi-Tenant]
BOOKING[Motor de Reservas]
PMS[Gestão de Propriedades]
end
subgraph "💾 Camada de Dados"
DB[(PostgreSQL)]
CACHE[(Redis)]
end
UI --> API
API --> AUTH
API --> BOOKING
API --> PMS
AUTH --> DB
BOOKING --> DB
PMS --> DB
BOOKING --> CACHE
AUTH --> CACHE
style UI fill:#e1f5fe
style API fill:#f3e5f5
style DB fill:#e8f5e8
style CACHE fill:#fff3e0
```
### 🗄️ Esquema do Banco de Dados
Para uma visão detalhada da estrutura do banco de dados, você pode acessar nosso diagrama interativo:
**[📊 Diagrama Interativo do Banco de Dados](https://dbdiagram.io/d/innkeeper-diagram-688adda9cca18e685c90b3f7)**
```mermaid
erDiagram
ORGANIZATIONS {
int id PK
string name
string slug
string email
string timezone
string currency
}
HOTELS {
int id PK
int organization_id FK
string name
string address
int star_rating
int total_rooms
time check_in_time
time check_out_time
}
ROOMS {
int id PK
int hotel_id FK
int room_type_id FK
string room_number
string status
string housekeeping_status
}
ROOM_TYPES {
int id PK
int hotel_id FK
string name
int max_occupancy
decimal base_price
string bed_type
}
GUESTS {
int id PK
int organization_id FK
string first_name
string last_name
string email
string phone
string document_number
}
RESERVATIONS {
int id PK
int organization_id FK
int hotel_id FK
int room_id FK
int guest_id FK
string confirmation_code
string status
date check_in_date
date check_out_date
decimal total_amount
}
PAYMENTS {
int id PK
int reservation_id FK
int guest_id FK
string transaction_id
string method
string status
decimal amount
string currency
}
ORGANIZATIONS ||--o{ HOTELS : "possui"
ORGANIZATIONS ||--o{ GUESTS : "gerencia"
HOTELS ||--o{ ROOMS : "contém"
HOTELS ||--o{ ROOM_TYPES : "define"
HOTELS ||--o{ RESERVATIONS : "recebe"
ROOM_TYPES ||--o{ ROOMS : "categoriza"
GUESTS ||--o{ RESERVATIONS : "faz"
ROOMS ||--o{ RESERVATIONS : "atribuído_a"
RESERVATIONS ||--o{ PAYMENTS : "gera"
```
## :sparkles: Funcionalidades
### Gerenciamento Hoteleiro Principal
- **🏢 Arquitetura Multi-Tenant**: Gerencie múltiplas propriedades hoteleiras com isolamento completo de dados
- **🛏️ Gestão de Quartos**: Inventário completo de quartos, tipos, comodidades e preços
- **📅 Sistema de Reservas**: Motor de reservas avançado com disponibilidade em tempo real
- **👥 Gestão de Hóspedes**: Perfis completos de hóspedes, preferências e histórico
- **💼 Operações de Recepção**: Check-in/out, atribuição de quartos e walk-ins
- **🧹 Governança**: Rastreamento do status dos quartos, cronogramas de limpeza e manutenção
- **💰 Faturamento e Cobrança**: Preços flexíveis, impostos, descontos e processamento de pagamentos
### Funcionalidades Avançadas
- **📊 Painel de Análises**: Métricas de ocupação, receita e desempenho em tempo real
- **🔄 Gerenciador de Canais**: Integração com OTAs (Booking.com, Expedia, etc.)
- **📱 Mobile-Responsive**: Funcionalidade completa em todos os dispositivos
- **🌐 Suporte Multi-Idiomas**: Internacionalização para operações globais
- **👷 Gestão de Equipe**: Papéis, permissões, horários e atribuição de tarefas
- **📧 Central de Comunicação**: E-mails automatizados, notificações SMS e mensagens para hóspedes
- **🎯 Gestão de Receita**: Preços dinâmicos e otimização de rendimento
- **🔗 Integrações de Terceiros**: Sistemas POS, fechaduras de portas e software de contabilidade
### Funcionalidades Técnicas
- **🔐 Controle de Acesso Baseado em Papéis**: Permissões granulares para diferentes tipos de usuários
- **🚀 Atualizações em Tempo Real**: Atualizações ao vivo via WebSocket em toda a plataforma
- **📈 Arquitetura Escalável**: Construída para lidar com propriedades de qualquer tamanho
- **🔒 Segurança de Dados**: Criptografia ponta a ponta e conformidade com padrões hoteleiros
- **🔄 Design API-First**: API RESTful para integrações fáceis
- **📱 Progressive Web App**: Instalável em dispositivos móveis
- **🎨 UI Personalizável**: Sistema de temas para consistência de marca
## :rocket: Tecnologias
### Backend
- **[AdonisJS v6](https://adonisjs.com/)**: Framework Node.js de nível empresarial
- **[PostgreSQL](https://www.postgresql.org/)**: Banco de dados relacional robusto com suporte multi-tenant
- **[Redis](https://redis.io/)**: Cache de alto desempenho e gerenciamento de sessões
- **[Bull Queue](https://github.com/OptimalBits/bull)**: Processamento de jobs em background
- **[JWT](https://jwt.io/)**: Autenticação segura
### Frontend
- **[React 19](https://react.dev/)**: Biblioteca moderna de UI
- **[Inertia.js](https://inertiajs.com/)**: Experiência SPA sem a complexidade
- **[TypeScript](https://www.typescriptlang.org/)**: Desenvolvimento type-safe
- **[Tailwind CSS](https://tailwindcss.com/)**: Estilização utility-first
- **[shadcn/ui](https://ui.shadcn.com/)**: Componentes bonitos e acessíveis
- **[Recharts](https://recharts.org/)**: Visualização de dados
### DevOps & Ferramentas
- **[Docker](https://www.docker.com/)**: Containerização
- **[Vite](https://vitejs.dev/)**: Desenvolvimento ultrarrápido
- **[ESLint](https://eslint.org/)** & **[Prettier](https://prettier.io/)**: Qualidade de código
- **[Japa](https://japa.dev/)**: Framework de testes
## :hammer_and_wrench: Instalação
### Pré-requisitos
- **Node.js** (v18 ou superior)
- **pnpm** (recomendado) ou npm/yarn
- **PostgreSQL** (v14 ou superior)
- **Redis** (v6 ou superior)
- **Docker** (opcional, para configuração containerizada)
### Início Rápido
1. **Clone o repositório:**
```bash
git clone https://github.com/gabrielmaialva33/innkeeper.git
cd innkeeper
```
2. **Instale as dependências:**
```bash
pnpm install
```
3. **Configure as variáveis de ambiente:**
```bash
cp .env.example .env
```
Configure seu banco de dados, Redis e outras configurações no arquivo `.env`.
4. **Execute as migrações do banco de dados:**
```bash
node ace migration:run
```
5. **Popule dados iniciais (opcional):**
```bash
node ace db:seed
```
6. **Inicie o servidor de desenvolvimento:**
```bash
pnpm dev
```
Sua aplicação estará disponível em `http://localhost:3333`
### Configuração com Docker
Para um ambiente containerizado:
```bash
docker-compose up -d
pnpm docker
```
### Deploy em Produção
1. **Compile a aplicação:**
```bash
pnpm build
```
2. **Execute as migrações em produção:**
```bash
node ace migration:run --force
```
3. **Inicie o servidor de produção:**
```bash
pnpm start
```
## :books: Documentação
Para documentação detalhada, visite nossa [Wiki](https://github.com/gabrielmaialva33/innkeeper/wiki) ou verifique a
pasta `/docs`.
### Documentação da API
A documentação da API está disponível em `/api/docs` quando executada em modo de desenvolvimento.
## :handshake: Contribuindo
Contribuições são bem-vindas! Por favor, leia nosso [Guia de Contribuição](CONTRIBUTING.md) para detalhes sobre nosso
código de conduta e o processo para enviar pull requests.
## :memo: Licença
Este projeto está licenciado sob a **Licença MIT**. Veja o arquivo [LICENSE](LICENSE) para mais detalhes.
---
Feito com ❤️ para a indústria hoteleira