Sistema MEI Web 📊

Sistema web moderno construído sob os conceitos de Clean Architecture direcionado para Frontend utilizando Vanilla JS, focado no gerenciamento das receitas brutas anuais para microempreendedores individuais. Este software utiliza o design system avançado Antigravity.

📋 Sobre o Projeto

O Sistema MEI Web é um dashboard completo, sem dependência de banco de dados e servidor rodando via API, feito puramente para funcionar de forma client-side offline, com foco em simplicidade, persistência segura por LocalStorage e agilidade para o fechamento mensal e relatório anual do Simples Nacional.

🎯 Funcionalidades

• Registro Simplificado: Adicione receitas com classificação automática segundo base tributária MEI (Comércio, Indústria, Serviços).
• Armazenamento 100% Local: Sem conexão com banco de dados externo ou servidor. Uso integral de localStorage (mei_dados).
• Exportação e Importação (JSON): Realize o backup e o restore de dados a qualquer momento como arquivos literais, garantindo privacidade e controle total.
• Relatório Automático: Tabela gerada perfeitamente dimensionada para transcrever para o Relatório Mensal Oficial do Governo.

🏗️ Estrutura Técnica (Client-Side Architecture)

• index.html: UI & Camada de View com Theme Antigravity.
• styles.css: Classes de estilo escalável (Design System + Variables CSS).
• script.js: Controllers, Camadas Lógicas e Adapters.

📊 Diagrama de Arquitetura

graph TD
    User([Microempreendedor]) --> View[UI / index.html]
    View --> Events[JavaScript Event Listeners]
    Events --> Controllers[script.js - App Logic]
    Controllers --> Persist[Export/Import JSON]
    Controllers --> Storage[LocalStorage Adapter]
    Storage -.-> Browser[(Armazenamento Local)]

Loading

🔒 Segurança (OWASP)

• Zero Back-End: Aplicação puramente client-side anula riscos de SQL Injection e vazamentos por servidores mal configurados. Toda privacidade repousa no controle de sessão do próprio usuário (navegador local).
• Tratamento de Input: Formulários restritos a entradas HTML formatadas e bloqueio preventivo via JS (sanitização de regex) limitam que payloads perigosos sejam inseridos (XSS).

🚀 Como Executar

1. Clone este repositório na sua máquina local:

   git clone https://github.com/amaurell/mei_web.git

2. Para que o navegador libere acesso funcional pleno ao LocalStorage e aos inputs assíncronos, é recomendado abrir o projeto via acesso num Servidor Web Local (e não via duplo-clique de protocolo file://).
3. Use a extensão Live Server via VS Code ou use ferramentas como o npx serve na respectiva pasta:

   npx serve .

---

MEI Web System 📊

Modern web system built using Frontend-focused Clean Architecture principles, targeting the management of annual gross revenues for individual microentrepreneurs (MEI in Brazil). This software uses the advanced Antigravity design system.

📋 About The Project

The MEI Web System is a complete dashboard with no database or backend server dependencies, made to work entirely client-side, focusing on simplicity, secure persistence via LocalStorage, and agility for the monthly closing and annual Simples Nacional report.

🎯 Features

• Simplified Tracking: Log income properly classified according to the MEI tax base (Commerce, Industry, Services).
• 100% Local Storage: No external SQL or database server connection. Entirely driven by browser storage (mei_dados).
• Data Export & Import (JSON): Backup and restore your data at any time as literal JSON files, maintaining absolute local privacy.
• Automated Reporting: Perfectly sized tables auto-generated for easy transcription to the official Federal Revenue Monthly Report.

🏗️ Technical Structure (Client-Side Architecture)

• index.html: UI & View layer based on the Antigravity Theme.
• styles.css: Scalable style classes (Design System + CSS Variables).
• script.js: Main Controller, Logic layers, and Component Adapters.

📊 Architecture Diagram

graph TD
    User([Microentrepreneur]) --> View[UI / index.html]
    View --> Events[JavaScript Event Listeners]
    Events --> Controllers[script.js - App Logic]
    Controllers --> Persist[Export/Import JSON]
    Controllers --> Storage[LocalStorage Adapter]
    Storage -.-> Browser[(Browser Local Environment)]

Loading

🔒 Security (OWASP)

• Zero Back-End: Pure client-side application prevents risks of SQL Injection and data leaks due to misconfigured servers. All privacy rests on the user's localized physical machine boundary.
• Input Sanitization: Reg-ex masked inputs and proper type validation prevent harmful user payloads, heavily decreasing Cross-Site Scripting (XSS) scenarios.

🚀 Running The App

1. Clone this repository locally.

   git clone https://github.com/amaurell/mei_web.git

2. As it heavily uses browser-restricted LocalStorage environments, it is recommended to launch the application using a lightweight local web server to prevent default cross-origin blocking typically applied to raw file:// protocols via double-clicks.
3. Access your local files using extensions such as Live Server (on VS Code) or by running a local HTTP server inside the folder:

   npx serve .