micuarto-community

Plataforma de moradia compartilhada (classificados de quartos) construída com PHP puro, sem frameworks.

micuarto.net é um projeto real em produção. Esta Community Edition é uma versão open-source para demonstração de arquitetura e código.

Stack

• Backend: PHP 8.3 com tipos estritos, PDO/SQLite em WAL mode (concorrência de leitura e escrita)
• Frontend: CSS/JS vanilla, responsivo, sem dependências de framework
• Infra: Nginx + PHP-FPM, SQLite WAL, GitHub Actions
• Integrações: Google OAuth, OpenStreetMap Nominatim (geocoding), OpenRouter (tradução automática via IA), Cloudflare R2 (storage), Resend (email)

Arquitetura

Framework MVC próprio (~10 classes no namespace App\Core):

• Router: wrapper sobre nikic/fast-route com suporte a grupos de middleware
• Database: singleton PDO com SQLite, WAL mode, busy_timeout=5000, transações aninhadas
• Auth: sessão + remember token + rate limiting de login
• Response/Request: abstração HTTP: JSON, HTML, redirect, file streaming, ETag
• Middleware pipeline: CSRF, RateLimit, Locale, Auth, Admin, SecurityHeaders

Funcionalidades

• Cadastro e login (email + Google OAuth)
• CRUD de anúncios com imagens, geolocalização, tradução automática
• Busca com filtros (cidade, preço, gênero, tipo, comodidades)
• Dashboard do usuário (meus anúncios, favoritos)
• Painel administrativo
• Internacionalização (pt-BR, es, en)
• Rate limiting, CSRF, proteção de sessão

Como rodar localmente

git clone git@github.com:{seu-user}/micuarto-community.git
cd micuarto-community
cp .env.example .env
composer install
php src/Commands/migrate.php
php src/Commands/seed.php
php -S localhost:9090 -t public

Testes

composer test

Licença

MIT