Skip to content

Repository files navigation

Tax Obligations Management Dashboard

A full-stack application for managing tax obligations, compliance deadlines and company obligations.

Developed as a technical assessment using .NET 9, React, TypeScript, PostgreSQL, Docker and AI-assisted development.

Highlights

  • Full Stack Application (.NET 9 + React + PostgreSQL)
  • Docker Compose environment
  • Swagger API documentation
  • CSV Export
  • Status Filtering
  • AI-Assisted Development

Features

Company Management

  • Register companies
  • List companies
  • Delete companies
  • Tax regime classification

Tax Obligations

  • Generate obligations based on tax regime rules
  • View obligations by company
  • Mark obligations as delivered
  • Track obligation status

Dashboard

  • Total companies
  • Total obligations
  • Pending obligations
  • Delivered obligations
  • Overdue obligations

Compliance Alerts

  • Overdue obligations
  • Upcoming obligations due within the next 30 days

Additional Features

  • Status filtering
  • CSV export
  • Docker Compose environment

Technology Stack

Backend

  • .NET 9
  • ASP.NET Core Minimal APIs
  • Entity Framework Core
  • PostgreSQL 16

Frontend

  • React
  • TypeScript
  • Vite
  • Ant Design
  • Axios

Infrastructure

  • Docker
  • Docker Compose
  • Nginx

Architecture

React Frontend
      |
      v
.NET 9 REST API
      |
      v
PostgreSQL

Fica melhor no GitHub.

---

### 3. Adicionar Docker Compose na execução

Depois de:

```bash
docker compose up --build

This command starts:

- PostgreSQL Database
- .NET 9 API
- React Frontend (served by Nginx)

The application follows a layered architecture:

* Domain
* Application
* Infrastructure
* API

---

## Running the Project

### Prerequisites

* Docker Desktop

### Start Application

```bash
docker compose up --build

Access URLs

Frontend

http://localhost:5173

Swagger

http://localhost:5073/swagger


Business Rules

Supported Tax Regimes

  • Simples Nacional
  • Lucro Presumido
  • Lucro Real
  • Imunidade / Isenção

Obligation Generation

Obligations are generated automatically according to the selected tax regime.

Alert Rules

Alerts are generated for:

  • Overdue obligations
  • Pending obligations due within the next 30 days

Screenshots

Dashboard Overview

Dashboard

Obligations Management

Obligations

Alerts and Status Filtering

Alerts and Filters

API Documentation (Swagger)

Swagger


AI-Assisted Development

This project was developed using an AI-assisted workflow.

AI was used to accelerate:

  • Architecture discussions
  • Frontend implementation
  • Docker configuration
  • Documentation
  • Troubleshooting and code review

All business rules, architectural decisions, testing, debugging and final validation were performed manually.

The goal was not to replace engineering judgment, but to improve productivity and focus on delivering a better solution.

This approach allowed faster delivery while maintaining engineering quality, business rule validation and architectural consistency.

Author

Edemar Costa Oliveira

Senior Full Stack Software Engineer

https://github.com/edemarcosta

About

A full-stack application for managing tax obligations, compliance deadlines and company obligations.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages