How thiagoocms/taxify-service works
Taxify is a multi-tenant tax and fiscal-document backend for accounting firms and their companies. Users authenticate and manage firm, company, subscription, and product fiscal-rule data through REST APIs. The main fiscal workflow downloads or imports fiscal XML, parses and stores document metadata and files, then supports search/export, product-rule divergence analysis, and optional XML rectification with audit logging. SIEG is the external XML provider. The sampled excerpts establish the import, storage, access-control, divergence, rectification, and token paths; unsampled API and scheduler wiring is represented only where the tree identifies those components.
Main entry points: rest REST endpoints · FiscalXmlIntegrationService.java XML workflow service · FiscalXmlRectificationService.java XML rectification · repository Fiscal records
Components 26
REST and identity
- REST endpoints
src/main/java/br/com/cshub/taxify/rest - Authentication
src/main/java/br/com/cshub/taxify/service/AuthService.java - JWT service
src/main/java/br/com/cshub/taxify/service/TokenService.java - Request security
src/main/java/br/com/cshub/taxify/config/SecurityConfig.java - API error mapping
src/main/java/br/com/cshub/taxify/rest/exception/GlobalExceptionHandler.java
Tenant and plans
- Firm and company APIs
src/main/java/br/com/cshub/taxify/rest - Plans and subscriptions
src/main/java/br/com/cshub/taxify/rest - Tenant access checks
src/main/java/br/com/cshub/taxify/common/TenantAccessService.java - Current user lookup
src/main/java/br/com/cshub/taxify/common/CurrentUserService.java - Account services
src/main/java/br/com/cshub/taxify/service
Fiscal documents
- Fiscal XML API
src/main/java/br/com/cshub/taxify/rest/FiscalXmlResource.java - XML workflow service
src/main/java/br/com/cshub/taxify/service/FiscalXmlIntegrationService.java - Sync control
src/main/java/br/com/cshub/taxify/service/FiscalXmlSyncControlService.java - XML sync scheduler
src/main/java/br/com/cshub/taxify/service/FiscalXmlSyncScheduler.java - XML parse and extract
src/main/java/br/com/cshub/taxify/integration/fiscalxml - XML file storage
src/main/java/br/com/cshub/taxify/integration/sieg/FiscalXmlFileStorage.java - Fiscal records
src/main/java/br/com/cshub/taxify/repository - Fiscal rule API
src/main/java/br/com/cshub/taxify/rest/ProductFiscalRuleResource.java - Product fiscal rules
src/main/java/br/com/cshub/taxify/service/ProductFiscalRuleService.java - Divergence analysis
src/main/java/br/com/cshub/taxify/service/ProductFiscalDivergenceService.java - XML rectification
src/main/java/br/com/cshub/taxify/service/FiscalXmlRectificationService.java - Invoice audit logs
src/main/java/br/com/cshub/taxify/repository/InvoiceAuditLogRepository.java
External integration
- SIEG XML provider
src/main/java/br/com/cshub/taxify/integration/sieg/SiegFiscalXmlProvider.java - SIEG token client
src/main/java/br/com/cshub/taxify/integration/sieg/SiegTokenService.java
Other components
- Accounting user
- SIEG service
Connections 34
- Accounting user → REST endpoints: calls API
- REST endpoints → Authentication: authenticates
- Authentication → JWT service: generates token
- Accounting user → Request security: presents token
- Request security → REST endpoints: authorizes requests
- REST endpoints → API error mapping: formats failures
- REST endpoints → Firm and company APIs: routes account requests
- REST endpoints → Plans and subscriptions: routes plan requests
- Firm and company APIs → Account services: invokes services
- Plans and subscriptions → Account services: invokes services
- Account services → Tenant access checks: checks firm boundary
- Tenant access checks → Current user lookup: resolves principal
- Current user lookup → Fiscal records: reads user
- REST endpoints → Fiscal XML API: routes XML requests
- Fiscal XML API → XML workflow service: invokes workflow
- XML sync scheduler → XML workflow service: starts sync
- XML workflow service → SIEG XML provider: downloads XML
- SIEG XML provider → SIEG service: requests XML
- SIEG XML provider → SIEG token client: obtains token
- SIEG token client → SIEG service: requests JWT
- XML workflow service → Sync control: updates sync state
- XML workflow service → XML parse and extract: extracts and parses
- XML workflow service → XML file storage: writes XML files
- XML workflow service → Fiscal records: stores document data
- REST endpoints → Fiscal rule API: routes rule requests
- Fiscal rule API → Product fiscal rules: invokes rules
- Product fiscal rules → Fiscal records: persists rules
- REST endpoints → Divergence analysis: requests comparison
- Divergence analysis → Fiscal records: reads items and rules
- REST endpoints → XML rectification: requests correction
- XML rectification → Fiscal records: reads and updates document
- XML rectification → Product fiscal rules: applies product rules
- XML rectification → XML file storage: writes corrected XML
- XML rectification → Invoice audit logs: records correction