Esta página explica a organização do projeto projeto-template/. A ideia é enxergar o template como uma aplicação web em camadas: algumas pastas guardam telas, outras guardam regras de negócio, outras centralizam acesso ao banco e outras reaproveitam pedaços comuns da interface.

Use o menu lateral para navegar pelas partes da arquitetura.

A árvore abaixo mostra a separação das responsabilidades no template. A organização não é apenas estética: ela ajuda a encontrar erros, reaproveitar código e impedir que as páginas virem arquivos enormes misturando HTML, regra de negócio e SQL.

Cada pasta tem um papel específico. Quando você criar o seu próprio projeto, a troca de tema não deve acontecer só no nome dos arquivos: a modelagem, as entidades, os repositories e as telas precisam fazer sentido para o novo domínio.

Quando o usuário abre uma página, o navegador faz uma requisição HTTP. O PHP executa o arquivo, carrega dependências, consulta o banco se necessário e devolve HTML para o navegador.

require_once __DIR__ . '/../includes/auth.php';
require_once __DIR__ . '/../repository/PokemonRepository.php';

$repo = new PokemonRepository();
$pokemons = $repo->listarPorUsuario($_SESSION['usuario_id']);

require_once __DIR__ . '/../includes/header.php';

A pasta pages/ é a parte mais visível para o usuário. Pense nela como um conjunto de janelas: cada arquivo abre uma tela ou executa uma ação específica da aplicação.

O banco do template é pequeno de propósito. Ele tem duas tabelas: usuario e pokemon. Um usuário pode ter vários pokémons, mas cada pokémon pertence a um único usuário.

CREATE TABLE IF NOT EXISTS usuario (
    id        INT          NOT NULL AUTO_INCREMENT,
    nome      VARCHAR(100) NOT NULL,
    email     VARCHAR(150) NOT NULL,
    senha     CHAR(64)     NOT NULL,
    criado_em DATETIME     NOT NULL DEFAULT CURRENT_TIMESTAMP,
    PRIMARY KEY (id),
    UNIQUE KEY uq_email (email)
);

CREATE TABLE IF NOT EXISTS pokemon (
    id         INT          NOT NULL AUTO_INCREMENT,
    nome       VARCHAR(100) NOT NULL,
    tipo       VARCHAR(50)  NOT NULL,
    nivel      INT          NOT NULL DEFAULT 1,
    usuario_id INT          NOT NULL,
    PRIMARY KEY (id),
    CONSTRAINT fk_pokemon_usuario
        FOREIGN KEY (usuario_id) REFERENCES usuario(id)
        ON DELETE CASCADE
);

Para entender o projeto sem se perder, leia os arquivos nesta ordem. Ela acompanha o caminho natural de uma aplicação: banco, conexão, autenticação, tela, repository e entidade.