Base HSN

O base.hsn.com.br continua sendo o ponto central de documentacao, assets compartilhados e padroes de interface do ecossistema HSN.

A partir desta revisao, a base estrutural anteriormente tratada como JetMail passa a ser chamada oficialmente de JetApps.

Decisao oficial: novos apps administrativos e operacionais da HSN devem partir da estrutura do Tendas como referencia pratica, usando o nome base JetApps.

JetApps

JetApps e a base padrao para criacao de novos apps da HSN. Ela combina:

estrutura PHP simples e direta
layout administrativo consistente
autenticacao, sessoes, helpers e configuracao central
CSS compartilhado vindo do base.hsn.com.br
camada de customizacao local por app

O Tendas passa a ser a principal implementacao de referencia para essa base.

Estrutura da Base

/base.hsn.com.br
  /argon
    /css
    /js
    /fonts
    /img
  /assets
    /img
  /mvp-padrao
  /jetapps
    README.md
    repository-structure.md
    mobile-mvp.md
  /bankdash
  index.html

Estrutura recomendada para um novo app JetApps

/app-name
  /api
  /app
    /views
      /layout
  /config
  /database
  /docs
  /includes
  /public
    /admin
    /assets
      /css
      /js
      /img
  /storage
  /.env.example

Repositorio de Arquivos

Minha sugestao e separar a base em camadas claras para facilitar criacao, manutencao e clonagem de novos apps.

Modelo recomendado

jetapps-core
  auth
  session
  helpers
  config
  db
  layout-base

jetapps-assets
  argon
  icons
  images
  tokens

jetapps-starters
  php-admin
  php-crud
  api-only
  pwa

jetapps-modules
  users
  roles
  notifications
  documents
  billing
  crm
  integrations

jetapps-mobile
  android
  ios
  windows

jetapps-apps
  tendas
  app-02
  app-03

Recomendacao pratica: o base.hsn.com.br deve continuar sendo o hub de documentacao e assets publicos. O ideal e que a logica reutilizavel do JetApps evolua para um repositorio proprio, separado dos apps finais.

MVP Padrao

O MVP padrao precisa refletir o que hoje ja funciona no Tendas:

layout administrativo com sidebar/topbar
login via /api
pasta public com assets locais
integracao com CSS compartilhado do base
camada de helpers, auth e config desacoplada do dominio do app

Uso minimo recomendado:

<link rel="stylesheet" href="https://base.hsn.com.br/argon/css/argon-dashboard.min.css">
<link rel="stylesheet" href="/public/assets/css/custom.css">

<script src="https://base.hsn.com.br/argon/js/core/bootstrap.bundle.min.js"></script>
<script src="/public/assets/js/app.js"></script>

MVP Mobile Multi-Store

O JetApps deve nascer com uma trilha minima para gerar apps publicados em Android, iOS e Windows Store.

Diretriz

o app web deve ser PWA-first
o mobile deve ser wrapper do mesmo nucleo funcional
o backend e os fluxos continuam compartilhados

Estrutura minima recomendada

/mobile
  /android
  /ios
  /windows
  capacitor.config.*
  manifest.json
  service-worker.js

MVP por plataforma

Android: Capacitor ou TWA para empacotar o PWA
iOS: Capacitor com WKWebView e build via Xcode
Windows Store: PWA empacotado com WebView2/MSIX

Escopo minimo do MVP mobile JetApps:

login
dashboard
notificacoes
sincronizacao com API do app
branding por app

Assets Compartilhados

O base.hsn.com.br continua sendo a fonte oficial de:

Argon customizado
Bootstrap bundle compartilhado
icones, fontes e imagens globais
documentacao viva da estrutura JetApps

Regras para Novos Apps

todo novo app deve partir da base JetApps
o layout base nao deve ser recriado do zero sem motivo tecnico claro
assets globais devem vir do base.hsn.com.br
customizacoes locais devem ficar no proprio app
modulos reaproveitaveis devem ser promovidos para a camada JetApps
o Tendas e a principal referencia de app administrativo da base

Prompt Base

Estou iniciando um novo app dentro do ecossistema HSN.

Este app deve usar a base estrutural JetApps, tomando o Tendas como referencia pratica de layout, autenticacao, organizacao de pastas e integracao com o base.hsn.com.br.

Preciso que voce me ajude a:
1. Definir as tabelas especificas do app.
2. Criar os endpoints da API.
3. Criar as telas iniciais usando o layout padrao JetApps.
4. Separar o que e core reutilizavel do que e especifico do app.
5. Preparar o app para futura embalagem Android, iOS e Windows Store.

Nome do app: [NOME]
Objetivo: [DESCRICAO CURTA]
Funcionalidade principal inicial: [DESCRICAO]

Documentos Relacionados

MVP padrao JetApps README Repositorio sugerido MVP mobile

Documentacao