Visão geral do projeto

Da ideia a uma base pronta para crescer.

O planejamento, a infraestrutura e a fundação técnica do sistema já estão concluídos e funcionando no servidor.

2incrementos concluídos

100%testes aprovados

OnlineVPS e MySQL

Como tudo se conecta

Cada atualização percorre um caminho seguro até chegar ao ambiente online.

flowchart TD
    DEV["01  Desenvolvimento local  ＋"] --> GIT["02  GitHub
net0x/dbcar  ＋"]
    GIT --> QA["03  Testes automáticos
PHPUnit + PHPStan  ＋"]
    QA --> CD["04  Deploy automático  ＋"]
    CD --> VPS["05  VPS
PHP 8.3 + Apache  ＋"]
    VPS --> APP["06  DBControl online  ＋"]
    VPS --> DB["07  MySQL 8.0
Homologação  ＋"]
    VPS --> LOG["08  Logs e monitoramento  ＋"]

    classDef source fill:#17243a,stroke:#4d6f98,color:#edf4ff,stroke-width:2px;
    classDef process fill:#182b2b,stroke:#64d6ad,color:#edf4ff,stroke-width:2px;
    classDef live fill:#164031,stroke:#70e0b7,color:#ffffff,stroke-width:3px;
    class DEV,GIT source;
    class QA,CD,VPS process;
    class APP,DB,LOG live;

PHP 8.3Aplicação

Apache 2.4Servidor web

MySQL 8.0Banco de dados

GitHub ActionsTestes e deploy

Mapa técnico navegável

Selecione um item do fluxograma ou abra os detalhes abaixo.

Desenvolvimento localAmbiente reproduzível e código-fonte

Estrutura usada para desenvolver e validar a aplicação antes do envio ao GitHub.

docker/
- apache-vhost.conf
Dockerfile
docker-compose.yml
.env.example
composer.json

GitHub e versionamentoHistórico, branches e revisão

O repositório privado centraliza o código, a documentação e todo o histórico das entregas.

Repositórionet0x/dbcar
Homologaçãobranch develop
Produçãobranch main
IntegraçãoPull Requests

Testes automáticosQualidade antes da publicação

Cada pull request e deploy executa verificações independentes no PHP 8.3.

tests/Unit/
- ConfigTest.php
- RouterTest.php
phpunit.xml
phpstan.neon

Deploy automáticoCI/CD, releases e rollback

Versões aprovadas em develop são implantadas automaticamente com verificação de saúde.

.github/workflows/
- deploy.yml
scripts/
- deploy.sh
- migrate.php

Servidor VPSInfraestrutura de homologação

SistemaAlmaLinux 9
Servidor webApache 2.4
RuntimePHP 8.3
SegurançaHTTPS + Cloudflare
PublicaçãoReleases atômicos

Aplicação DBControlNúcleo PHP já implementado

app/Core/
- Application.php
- Router.php
- Request.php
- Response.php
- Config.php
- Database.php
- Logger.php
- MigrationRunner.php
public/
- index.php
- health.php
- assets/
routes/
- web.php
- api.php

Banco MySQLPersistência e migrations

Banco exclusivo de homologação com credenciais protegidas fora do repositório.

database/migrations/
- 001_create_system_metadata.sql
schema_migrations
system_metadata

Logs e monitoramentoSaúde, prontidão e rastreabilidade

Processo/health
MySQL/ready
RastreabilidadeX-Request-Id
Arquivostorage/logs/application.log

Etapas concluídas

Entregas consolidadas até o momento.

Incremento 0

Planejamento e decisões

Escopo, papéis, regras, arquitetura, backlog, ambientes e estratégia de implantação definidos.

Concluído

Infraestrutura

GitHub, Cloudflare e VPS

Domínios, HTTPS, branches, testes e deploy automático de homologação configurados.

Concluído

Incremento 1

Fundação executável

PHP 8.3, rotas, logs, PDO, MySQL, migrations, health checks, Docker e testes funcionando.

Concluído

Incremento 2

Identidade e acesso

Empresas, unidades, usuários, cinco perfis, permissões, login, CSRF, auditoria e sessões por perfil de 30 ou 90 minutos.

Incremento 3

Frota e condutores

Cadastros, CNH, quilometragem, estados operacionais, APIs, telas e auditoria.

Concluído

Próxima etapa

Primeira viagem completa

Abertura e chegada transacionais com validação de veículo, condutor, CNH, horários e quilometragem.

Acesso rápido

Confira o que está online

Os indicadores abaixo consultam a mesma aplicação publicada no VPS.

Abrir aplicação → Estado da aplicação → Conexão com o banco → Código no GitHub ↗