How leandrotsampa/fatorsimples works
FatorSimples is a desktop app for service businesses to calculate Simples Nacional and Fator R, plan monthly transfers, compare outcomes, and maintain a tax history. Users enter company details and monthly revenue/payroll, then review the calculation and save or import records. The app also supports PDF and JSON transfer, print-ready reports, onboarding, settings, and updated tax tables. The calculation, storage, Electron, and remote-table paths are supported by sampled source references; some feature wiring is unsampled, so those links are shown as unverified.
Main entry points: App.tsx App coordinator · taxCalculations.ts Tax calculations · MonthApurationView.tsx Monthly calculation · ImportDocumentModal.tsx PGDAS document import
Components 20
App experience
- App coordinator
src/App.tsx - Welcome and setup
src/components/Welcome.tsx - Monthly calculation
src/components/MonthApurationView.tsx - Fator R comparison
src/components/ComparisonView.tsx - Company and tax settings
src/components/SettingsModal.tsx - Printable report
src/components/ReportPrintView.tsx
Tax domain
- Tax calculations
src/utils/taxCalculations.ts - Tax domain types
src/types/tax.ts - Official tax tables
src/utils/taxTablesRegistry.ts
Records and transfer
- Monthly history
src/components/HistoryTable.tsx - Add or edit month
src/components/AddMonthModal.tsx - PGDAS document import
src/components/ImportDocumentModal.tsx - Document parsing
src/utils/documentImport.ts - JSON data transfer
src/utils/dataTransfer.ts
Desktop storage
- Storage adapter
src/utils/storageAdapter.ts - Electron main process
electron/main.cjs - Local SQLite database
electron/main.cjs
Tax table updates
- Remote table updates
src/utils/remoteTables.ts
Other components
- Business owner
- GitHub tables
Connections 20
- Business owner → App coordinator: uses
README.md - App coordinator → Welcome and setup: offers onboarding
src/App.tsx - App coordinator → Monthly calculation: renders
src/App.tsx - App coordinator → Fator R comparison: offers
src/App.tsx - App coordinator → Monthly history: offers
src/App.tsx - App coordinator → Company and tax settings: renders
src/App.tsx - App coordinator → PGDAS document import: renders
src/App.tsx - App coordinator → Tax calculations: generates sample data
src/App.tsx - Monthly calculation → Tax calculations: calculates
src/components/MonthApurationView.tsx - Add or edit month → Tax calculations: calculates
src/components/AddMonthModal.tsx - Tax calculations → Tax domain types: uses types
src/utils/taxCalculations.ts - Tax calculations → Official tax tables: reads tables
src/utils/taxCalculations.ts - PGDAS document import → Document parsing: parses documents
- App coordinator → Storage adapter: loads and saves
src/App.tsx - Storage adapter → Local SQLite database: reads and writes
src/utils/storageAdapter.ts - Electron main process → Local SQLite database: queries
electron/main.cjs - App coordinator → Remote table updates: loads and applies
src/App.tsx - Remote table updates → GitHub tables: checks for updates
README.md - Business owner → JSON data transfer: exports or imports
- Business owner → Printable report: prints or saves
README.md