Documentação do Projeto

O EstoqueCar é uma plataforma SaaS (Software as a Service) desenvolvida para gerenciar o ciclo de vida de reformas automotivas (Car Flipping). O sistema centraliza o controle de estoque, despesas de peças/serviços e o relacionamento com compradores.

Stack Tecnológica

O projeto foi construído utilizando tecnologias nativas para garantir máxima performance e facilidade de hospedagem:

• Backend: PHP 8.0+ (PDO, MVC Pattern Simplificado)
• Database: MySQL / MariaDB
• Frontend: HTML5, CSS3 (Variáveis, Grid/Flexbox), JavaScript Vanilla
• Design: Dark Mode Nativo, Glassmorphism UI

Módulo de Garagem

A estrutura de dados principal. Cada carro é tratado como um "Projeto" isolado, contendo fotos, metadados e status.

Exemplo da estrutura SQL utilizada para isolamento de dados por usuário (Multi-tenant):

CREATE TABLE cars (
    id INT AUTO_INCREMENT PRIMARY KEY,
    user_id INT NOT NULL, -- Chave do Tenant (Dono)
    brand VARCHAR(50),
    model VARCHAR(50),
    status ENUM('available', 'in_restoration', 'sold'),
    purchase_price DECIMAL(10, 2),
    FOREIGN KEY (user_id) REFERENCES users(id)
);

Cálculo de ROI (Break-even)

O diferencial do sistema é o cálculo automático do ponto de equilíbrio. O sistema soma o valor de compra + todas as despesas lançadas na tabela car_expenses.

Lógica aplicada no Backend (PHP):

// 1. Custo do Carro
$purchase = $car['purchase_price'];

// 2. Soma das Reformas
$stmt = $pdo->prepare("SELECT SUM(cost_price) FROM car_expenses WHERE car_id = ?");
$stmt->execute([$id]);
$reforma = $stmt->fetchColumn();

// 3. Custo Total (Break-even Point)
$total_invested = $purchase + $reforma;

// 4. Lucro Líquido
$profit = $sale_price - $total_invested;

Segurança SaaS

Para garantir que um usuário não acesse os dados de outro, todas as consultas SQL utilizam injeção de dependência do user_id da sessão.

Isso previne ataques do tipo IDOR (Insecure Direct Object Reference).