Araponga Logo

Wiki Araponga

Documentação Completa

📊 Análise: Inserção de Hospedagem no Roadmap Estratégico

Data: 2026-01-25
Status: 📋 Análise Estratégica
Objetivo: Determinar prioridade e posicionamento ideal da funcionalidade de Hospedagem no roadmap de 29+ fases

Recomendação: Inserir Hospedagem como Fase 30 na Onda 7: Economia Circular, com prioridade 🟡 P1 (Alta), após Fase 23 (Compra Coletiva) e antes de Fase 24 (Trocas Comunitárias).

Justificativa da Numeração:

  • ✅ Fase 30 é a primeira disponível: O roadmap possui 29 fases documentadas (FASE1.md até FASE29.md)
  • ✅ Fases 31-44 são conceituais: Existem apenas no roadmap estratégico, sem documentos detalhados
  • ✅ Sequência lógica: 30 é a próxima numeração após 29 (primeira fase nova com documento completo)
  • ✅ Evita confusão: Numeração clara e sequencial com documentos existentes

Justificativa do Posicionamento:

  • ✅ Fortalece economia local (complementa Marketplace)
  • ✅ Diferencial competitivo importante (referência Airbnb)
  • ✅ Requer infraestrutura já existente (pagamentos, notificações, aprovação)
  • ✅ Alinha com valores de soberania territorial
  • ✅ Pode ser desenvolvida em paralelo com outras fases de economia circular

📋 Análise de Contexto

Estado Atual do Sistema

  • ✅ Pagamentos: Sistema completo (Fase 6-7)

    • FinancialTransaction, escrow, split de pagamento
    • Payout para vendedores
    • Platform fees configuráveis

  • ✅ Aprovação Humana: WorkItem implementado

    • Sistema genérico de fila de revisão
    • Suporta diferentes tipos de aprovação

  • ✅ Notificações: Sistema completo

    • OutboxMessage e UserNotification
    • Notificações confiáveis

  • ✅ Feature Flags: Sistema por território

    • Controle granular de funcionalidades

  • ✅ Membership e Validação: Sistema robusto

    • ResidencyVerification (Flags)
    • MembershipCapability para papéis

⚠️ Dependências Identificadas

  • ✅ Nenhuma dependência bloqueante: Todas as infraestruturas necessárias já existem
  • ✅ Pode ser desenvolvida independentemente: Não bloqueia outras fases
  • ✅ Complementa Marketplace: Usa padrões similares, mas é domínio independente

🔍 Análise Comparativa com Fases Existentes

Aspecto Marketplace Hospedagem Conclusão
Economia Local ✅ Sim ✅ Sim Alinhados
Pagamentos ✅ Escrow + Split ✅ Escrow + Split Reutiliza
Aprovação ⚠️ ItemInquiry ✅ WorkItem Hospedagem mais robusta
Visibilidade ✅ Pública ✅ Privada → Pública Hospedagem mais privada
Complexidade 🟡 Média 🔴 Alta (agenda) Hospedagem mais complexa
Valor de Negócio 🔴 Alto 🔴 Alto Ambos críticos

Conclusão: Hospedagem é complementar ao Marketplace, não concorrente. Ambos fortalecem economia local.

Aspecto Entregas Hospedagem Conclusão
Foco Logística Acomodação Diferentes
Economia Local ✅ Sim ✅ Sim Alinhados
Dependências Marketplace Independente Hospedagem menos dependente
Complexidade 🟡 Média 🔴 Alta Hospedagem mais complexa
Prioridade 🟢 P2 🟡 P1 Hospedagem mais prioritária

Conclusão: Hospedagem pode ser desenvolvida antes de Entregas, pois não depende dela.

Aspecto Rental System (Fase 43) Hospedagem Conclusão
Escopo Genérico (recursos diversos) Específico (acomodação) Hospedagem mais focado
Complexidade 🔴 Alta (genérico) 🔴 Alta (específico) Similar
Valor Territorial 🟡 Médio 🔴 Alto Hospedagem mais alinhada
Prioridade Atual 🟢 P2 (Onda 8) 🟡 P1 (proposta) Hospedagem mais prioritária
Timeline Mês 12-18 Mês 6-9 (proposta) Hospedagem antes

Conclusão: Hospedagem é mais específica e prioritária que Rental System genérico. Rental System pode reutilizar conceitos de Hospedagem depois.

📊 Análise de Priorização

Critérios de Priorização

1. Valor de Negócio 🔴 ALTO

  • ✅ Diferencial Competitivo: Referência Airbnb (plataforma líder)
  • ✅ Economia Local: Fortalece circulação de recursos no território
  • ✅ Receita Potencial: Taxa de plataforma em cada estadia
  • ✅ Engajamento: Funcionalidade que mantém usuários ativos

Score: 9/10

2. Dependências 🔴 BAIXAS

  • ✅ Infraestrutura Existente: Pagamentos, notificações, aprovação
  • ✅ Sem Bloqueios: Não depende de outras fases pendentes
  • ✅ Pode Paralelizar: Não bloqueia outras fases

Score: 10/10

3. Alinhamento com Valores 🟡 ALTO

  • ✅ Soberania Territorial: Propriedades privadas, moradores validados
  • ✅ Economia Local: Dinheiro circula no território
  • ✅ Governança Comunitária: Aprovação humana, papéis contextuais
  • ✅ Privacidade: Propriedades privadas por padrão

Score: 9/10

  • ⚠️ Agenda Complexa: Núcleo do sistema, requer design cuidadoso
  • ⚠️ Múltiplas Entidades: Property, HostingConfiguration, Calendar, Roles, StayRequest, Stay
  • ✅ Reutilização: Aproveita infraestrutura existente
  • ✅ Padrões Estabelecidos: Segue Clean Architecture

Score: 7/10 (complexidade média-alta, mas gerenciável)

5. Urgência de Mercado 🟡 MÉDIA-ALTA

  • ✅ Expectativa de Usuários: Funcionalidade esperada em plataformas modernas
  • ✅ Concorrência: Airbnb, Booking.com são referências
  • ⚠️ Não Bloqueante: Não é crítico para MVP, mas importante para diferenciação

Score: 7/10

Score Total de Priorização

Critério Peso Score Peso × Score
Valor de Negócio 30% 9/10 2.7
Dependências 20% 10/10 2.0
Alinhamento com Valores 20% 9/10 1.8
Complexidade Técnica 15% 7/10 1.05
Urgência de Mercado 15% 7/10 1.05
TOTAL 100% - 8.6/10

Prioridade Recomendada: 🟡 P1 (Alta)

🗺️ Posicionamento no Roadmap

Análise das Ondas Estratégicas

Onda 1: Fundação de Governança (Mês 0-3) 🔴 CRÍTICO

  • Foco: Governança participativa
  • Hospedagem: ❌ Não se encaixa (não é governança)

Onda 2: Sustentabilidade Financeira (Mês 3-6) 🔴 CRÍTICO

  • Foco: Receitas recorrentes (Subscriptions, Ticketing)
  • Hospedagem: ⚠️ Parcialmente relacionada (gera receita, mas não é recorrente)

Onda 3: Essencial Pós-MVP (Mês 0-6) 🔴 CRÍTICO

  • Foco: MVP completo (Perfil, Mídias, Edição)
  • Hospedagem: ❌ Não se encaixa (não é essencial para MVP)

Onda 4: Preparação Web3 (Mês 6-9) 🔴 CRÍTICO

  • Foco: Blockchain, Wallets, Smart Contracts
  • Hospedagem: ❌ Não se encaixa (não requer Web3)

Onda 5: DAO e Tokenização (Mês 9-12) 🔴 CRÍTICO

  • Foco: Tokens, Governança Tokenizada
  • Hospedagem: ❌ Não se encaixa (pode evoluir para Web3 depois)

Onda 6: Soberania Territorial (Mês 6-12) 🟡 ALTA

  • Foco: Saúde Territorial, Gamificação, Entregas
  • Hospedagem: ⚠️ Parcialmente relacionada (soberania, mas não é saúde/gamificação)

Onda 7: Economia Circular (Mês 12-18) 🟡 ALTA ✅ MELHOR ENCAIXE

  • Foco: Compra Coletiva, Trocas, Negociação, Banco de Sementes
  • Hospedagem: ✅ PERFEITO ENCAIXE
    • Fortalece economia local
    • Complementa Marketplace
    • Alinha com economia circular
    • Propriedades privadas → economia comunitária

Onda 8: Diferenciação e Expansão (Mês 12-18) 🟢 MÉDIA

  • Foco: Learning Hub, Booking System, IA
  • Hospedagem: ⚠️ Parcialmente relacionada (diferenciação, mas Booking System é genérico)

Onda 9: Otimizações e Extensões (Mês 6-18) 🟡 IMPORTANTE

  • Foco: Otimizações, IA, Integrações
  • Hospedagem: ❌ Não se encaixa (não é otimização)

Onda 7: Economia Circular é o melhor encaixe porque:

  1. ✅ Hospedagem fortalece economia local (alinhado com economia circular)
  2. ✅ Complementa Marketplace (já na economia local)
  3. ✅ Pode ser desenvolvida após Compra Coletiva (Fase 23)
  4. ✅ Antes de Trocas Comunitárias (Fase 24) - sequência lógica
  5. ✅ Timeline adequada (Mês 12-18, mas pode começar antes)

📅 Proposta de Inserção

Posicionamento: Onda 7: Economia Circular
Prioridade: 🟡 P1 (Alta)
Duração: 9 semanas (45 dias úteis) - conforme proposta de implementação
Timeline: Mês 9-12 (pode começar após Fase 23, em paralelo com outras fases)

Nota sobre Numeração: As fases 31-44 mencionadas no roadmap estratégico são conceituais (sem documentos detalhados). A Fase 30 (Hospedagem) será a primeira fase nova com documento completo após as 29 existentes.

Onda 7: Economia Circular (Mês 12-18) 🟡 ALTA

Fase 23: Sistema de Compra Coletiva (28 dias) 🟡 P1
    ↓
Fase 30: Sistema de Hospedagem Territorial (56 dias) 🟡 P1 ⭐ NOVA
    ↓
Fase 24: Sistema de Trocas Comunitárias (21 dias) 🟡 P1
    ↓
Fase 20: Sistema de Moeda Territorial (35 dias) 🟡 P1 ⬇️ Reposicionada
    ↓
Fase 27: Negociação Territorial (28 dias) 🟢 P2
    ↓
Fase 28: Banco de Sementes e Mudas (21 dias) 🟢 P2

  1. Fase 23 → Fase 30:

    • Compra Coletiva estabelece padrões de economia comunitária
    • Hospedagem complementa com outra dimensão da economia local
    • Ambas fortalecem autonomia econômica
    • Ambas funcionam com pagamentos atuais da plataforma

  2. Fase 30 → Fase 24:

    • Hospedagem e Trocas são complementares
    • Ambos focam em recursos compartilhados
    • Sequência lógica de economia circular
    • Ambos funcionam com pagamentos atuais da plataforma

  3. Fase 24 → Fase 20 (Moeda Territorial):

    • Moeda territorial reposicionada para depois dos serviços
    • Primeiro criar ecossistema robusto de serviços
    • Moeda virtual implementada quando houver volume e necessidade
    • Funciona melhor com serviços já estabelecidos

  4. Paralelização Possível:

    • Fase 30 pode ser desenvolvida em paralelo com Fase 24 (após início)
    • Fase 20 pode ser desenvolvida em paralelo com Fase 27-28 (menor prioridade)
    • Não há dependências bloqueantes

🔄 Ajustes no Roadmap

Contexto da Numeração Atual:

  • Fases 1-29: Fases documentadas (arquivos FASE1.md até FASE29.md existem)
  • Fases 31-44: Mencionadas no roadmap estratégico, mas sem documentos detalhados (apenas conceituais)
    • Roadmap estratégico menciona: Proof of Sweat (30), Dashboard (31), Subscriptions (32), Ticketing (33), Web3 (34-37), DAO (38-40), Diferenciação (41-43)
    • Mas não existem documentos FASE30.md até FASE43.md
  • Fase 30: Primeira numeração disponível após as 29 fases documentadas

Opção 1: Inserir como Fase 30 (Recomendado) ✅

  • ✅ Primeira fase nova com documento completo: Após as 29 existentes
  • ✅ Numeração lógica: Sequência natural 1-29 → 30
  • ✅ Não quebra referências: Fases 31-44 do roadmap são conceituais, já estão com numeração sequencial correta
  • ✅ Clareza: Documento completo vs. menções conceituais no roadmap

Opção 2: Inserir como Fase 44 (Não recomendado)

  • ❌ Pula numeração: Ignora que não há documentos 30-43
  • ❌ Confusão: Parece que há 43 fases documentadas quando na verdade há 29
  • ⚠️ Inconsistência: Numeração não reflete realidade dos documentos

Opção 3: Criar documentos 30-43 primeiro, depois inserir como 44

  • ⚠️ Trabalho desnecessário: Criar 14 documentos conceituais só para numeração
  • ⚠️ Atraso: Adia implementação de Hospedagem
  • ❌ Não necessário: Hospedagem é mais prioritária que algumas fases conceituais

Recomendação Final

Inserir como Fase 30 na Onda 7. Esta será a primeira fase nova com documento completo após as 29 existentes. As menções às fases 31-44 no roadmap estratégico são conceituais e seguem a numeração sequencial correta.

📊 Comparação com Fase 42 (Booking System)

Fase 43: Rental System (Genérico)

  • Escopo: Aluguel de recursos diversos (salas, equipamentos, espaços, veículos)
  • Complexidade: Alta (genérico = mais abstrato)
  • Prioridade: 🟢 P2 (Média)
  • Timeline: Mês 12-18
  • Status: ⏳ Planejado

Fase 30: Sistema de Hospedagem Territorial (Específico)

  • Escopo: Acomodação territorial (propriedades privadas)
  • Complexidade: Alta (específico = mais detalhado)
  • Prioridade: 🟡 P1 (Alta)
  • Timeline: Mês 9-12 (proposta)
  • Status: ⏳ Novo (primeira fase nova com documento completo após 29)

Nota: O roadmap estratégico menciona fases 31-44 conceituais (Proof of Sweat, Subscriptions, Web3, DAO, etc.), mas sem documentos detalhados. A Fase 30 (Hospedagem) será a primeira fase nova com documento completo.

Fase 30 (Hospedagem) → Fase 43 (Rental System):

  • ✅ Hospedagem estabelece padrões de agenda e aprovação
  • ✅ Rental System (genérico) pode generalizar conceitos de Hospedagem
  • ✅ Padrões criados podem ser reutilizados:
    • Padrões de agenda (HostingCalendar → RentalCalendar)
    • Padrões de aprovação (WorkItem para StayRequest → WorkItem para RentalRequest)
    • Padrões de visibilidade (Property → RentalResource)

Conclusão: Hospedagem deve vir antes de Rental System genérico, que pode reutilizar seus padrões.

🎯 Recomendação Final

Fase 30: Sistema de Hospedagem Territorial

Atributo Valor
Onda 7: Economia Circular
Prioridade 🟡 P1 (Alta)
Duração 56 dias úteis (11 semanas)
Dependências Fase 6-7 (Marketplace/Pagamentos) - ✅ Já implementado
Bloqueia Nada (pode ser desenvolvida independentemente)
Timeline Mês 9-12 (pode começar após Fase 23)
Posição na Onda 7 Após Fase 23, antes de Fase 24
Numeração Primeira fase nova com documento completo (após 29 existentes) 
Onda 7: Economia Circular (Mês 12-18) 🟡 ALTA

1. Fase 23: Sistema de Compra Coletiva (28 dias) 🟡 P1
   → Estabelece padrões de economia comunitária
   → Funciona com pagamentos atuais da plataforma

2. Fase 30: Sistema de Hospedagem Territorial (56 dias) 🟡 P1 ⭐ NOVA
   → Fortalece economia local com acomodações
   → Complementa Marketplace
   → Diferencial competitivo (referência Airbnb)
   → Funciona com pagamentos atuais (escrow, split)

3. Fase 24: Sistema de Trocas Comunitárias (21 dias) 🟡 P1
   → Complementa economia circular
   → Funciona com pagamentos atuais da plataforma

4. Fase 20: Sistema de Moeda Territorial (35 dias) 🟡 P1 ⬇️ Reposicionada
   → Implementada após ecossistema robusto de serviços
   → Moeda virtual complementa serviços já estabelecidos
   → Facilita pagamentos quando houver volume e necessidade

5. Fase 27: Negociação Territorial (28 dias) 🟢 P2
   → Avançado, menor prioridade

6. Fase 28: Banco de Sementes e Mudas (21 dias) 🟢 P2
   → Avançado, menor prioridade

Total de Fases Documentadas: 29 → 30 fases (com Hospedagem)

Nota:

  • Fases 1-29: Documentadas (arquivos FASE1.md até FASE29.md existem)
  • Fases 31-44: Mencionadas no roadmap estratégico, mas sem documentos detalhados (apenas conceituais)
  • Fase 30 (Hospedagem): Primeira fase nova com documento completo após as 29 existentes

Timeline Atualizada:

  • Antes: 29 fases documentadas
  • Depois: 30 fases documentadas (Fase 30 inserida)
  • Impacto: +45 dias úteis (~9 semanas)

Ajuste no Roadmap Estratégico:

  • As menções às fases 30-43 no roadmap estratégico podem ser renumeradas para 31-44 quando seus documentos forem criados
  • Ou podem ser mantidas como conceituais, com Fase 30 sendo a primeira fase nova documentada

Paralelização:

  • Fase 44 pode ser desenvolvida em paralelo com:
    • Fase 24 (Trocas) - após Fase 44 iniciar
    • Fase 27-28 (menor prioridade) - em paralelo total

Economia de Tempo com Paralelização: ~21 dias (Fase 24 em paralelo)

⚠️ Considerações Importantes

Risco: Confusão entre Hospedagem (Fase 30) e Rental System (Fase 43)

Mitigação:

  • ✅ Hospedagem (Fase 30): Específico para acomodação, propriedades privadas, moradores validados
  • ✅ Rental System (Fase 43): Genérico para aluguel de recursos diversos (salas, equipamentos, espaços, veículos)
  • ✅ Documentação clara: Diferenças explícitas na documentação
  • ✅ Nomenclatura distinta: Property vs. RentalResource, StayRequest vs. RentalRequest

2. Complexidade da Agenda

Risco: Agenda é núcleo complexo do sistema

Mitigação:

  • ✅ Design cuidadoso (conforme proposta)
  • ✅ Testes extensivos de concorrência
  • ✅ Estados explícitos e imutáveis
  • ✅ Índices e cache para performance

Risco: Confusão com abstrações do Marketplace

Mitigação:

  • ✅ Domínio completamente separado (Arah.Domain/Hosting/)
  • ✅ Nomenclatura distinta (Property ≠ Store, StayRequest ≠ Checkout)
  • ✅ Documentação clara das diferenças
  • ✅ Reutilização apenas de infraestrutura (pagamentos, notificações)
  1. Aprovar inserção de Fase 30 no roadmap
  2. Renomear FASE44.md para FASE30.md (já criado como FASE44.md)
  3. Atualizar roadmap (docs/02_ROADMAP.md) - ajustar numeração
  4. Atualizar índice de fases (docs/backlog-api/README.md)
  5. Documentar relação com fases conceituais do roadmap estratégico
  6. Roadmap estratégico atualizado (fases 31-44 conceituais com numeração sequencial correta)
  7. Iniciar planejamento detalhado da Fase 30

Status: ✅ ANÁLISE COMPLETA
Recomendação: Inserir como Fase 30 na Onda 7
Prioridade: 🟡 P1 (Alta)
Timeline: Mês 9-12 (após Fase 23, antes de Fase 24)
Nota: Primeira fase nova com documento completo após as 29 existentes. Fases 31-44 mencionadas no roadmap estratégico são conceituais (sem documentos detalhados).

← Voltar às Boas-VindasVer Todos os Docs →