Estudo de Caso: Arquitetura Multiplataforma para Gerenciamento de Serviços com .NET 8, Web API, ASP.NET Core MVC e .NET MAUI
Autor: Lucas Menezes
Curso: Análise e Desenvolvimento de Sistemas — Universidade Paulista (UNIP)
Projeto: TechService (PIM IV)
Data: 11/09/2026
1. Introdução e Contextualização
Na gestão operacional de manutenção e serviços técnicos, a agilidade na troca de informações entre a equipe administrativa e os técnicos atuando em campo é um fator importante para a eficiência das atividades.
Este artigo apresenta a arquitetura, a modelagem e o desenvolvimento do TechService, uma solução desenvolvida para o gerenciamento de Ordens de Serviço (OS). O projeto foi concebido como parte integrante do Projeto Integrado Multidisciplinar IV (PIM IV) do curso de Análise e Desenvolvimento de Sistemas da UNIP, integrando desenvolvimento Web, Mobile, APIs RESTful e Banco de Dados Relacional.
2. Visão Geral da Arquitetura do Sistema
A solução foi projetada com uma arquitetura centralizada na Web API, permitindo o desacoplamento das camadas de apresentação e a centralização das regras de negócio. Dessa forma, as aplicações cliente não acessam o banco de dados diretamente.
[ TechServiceWeb (ASP.NET Core MVC) ] ────┐
│
▼
[ TechServiceApi ] ──► [ MySQL / MariaDB ]
▲
│
[ TechServiceMaui (.NET MAUI Mobile) ] ───┘
O ecossistema é dividido em três módulos principais:
TechServiceApi (Backend/API): Desenvolvida em .NET 8, atua como o núcleo da aplicação. Gerencia autenticação por meio de tokens JWT (JSON Web Token), validações de negócio, dados utilizados pelos dashboards e integração com o banco de dados utilizando Entity Framework Core. A documentação e os testes das rotas da API são disponibilizados por meio do Swagger.
TechServiceWeb (Frontend Administrativo): Desenvolvida em ASP.NET Core MVC e voltada para os gestores. Permite a visualização do dashboard, gerenciamento de clientes e técnicos, além da criação e do acompanhamento das Ordens de Serviço.
TechServiceMaui (Mobile Cross-Platform): Aplicação mobile multiplataforma desenvolvida em .NET MAUI para utilização pelos técnicos em campo, permitindo login, consulta detalhada das Ordens de Serviço e atualização do status dos atendimentos.
**3. Modelagem de Dados Relacional e Regras de Banco
**
A persistência dos dados foi estruturada utilizando o SGBD MySQL/MariaDB, na base techservice_db. A modelagem foi desenvolvida buscando garantir integridade referencial, consistência dos dados e histórico das alterações realizadas no sistema.
Principais entidades:
Clientes, Técnicos e Usuários;
Ordens de Serviço e Itens de Serviço;
Histórico de Alterações de Status.
Recursos utilizados no SGBD:
Além do Mapeamento Objeto-Relacional (ORM) realizado por meio do Entity Framework Core, o sistema utiliza recursos nativos do banco de dados para auxiliar na integridade e no controle das informações.
Procedures: utilizadas para operações específicas que envolvem regras ou consultas no banco de dados.
Triggers: utilizadas para registrar automaticamente o histórico de alterações de status das Ordens de Serviço, permitindo maior rastreabilidade das operações realizadas.
4. Segurança, API REST e Comunicação HTTP
A comunicação entre as aplicações Web e Mobile e a API ocorre por meio de rotas RESTful, utilizando dados estruturados no formato JSON.
Destaques técnicos da implementação:
Autenticação Stateless: utilização de tokens JWT para autenticação e controle de acesso às rotas restritas da aplicação.
Padrão RESTful: utilização dos principais verbos HTTP, como GET, POST, PUT e DELETE, além do tratamento de códigos de resposta HTTP, como 200 OK, 201 Created, 401 Unauthorized e 404 Not Found.
Documentação da API: integração com Swagger/OpenAPI para visualização e teste dos endpoints disponíveis, facilitando também a integração das aplicações Web e Mobile com a API.
5. Resultados e Lições Aprendidas
O desenvolvimento do TechService possibilitou aplicar e consolidar conceitos importantes relacionados ao desenvolvimento de sistemas e à integração entre diferentes aplicações.
Principais aprendizados:
A importância do desacoplamento da camada de dados por meio de APIs RESTful;
A possibilidade de reutilização do ecossistema .NET 8 no desenvolvimento de uma API, aplicação Web em ASP.NET Core MVC e aplicação mobile multiplataforma utilizando .NET MAUI;
A importância da autenticação e do controle de acesso na comunicação entre diferentes aplicações;
O uso de triggers no banco de dados para manter o histórico das alterações realizadas nas Ordens de Serviço;
A importância de manter uma arquitetura organizada, permitindo que aplicações diferentes utilizem a mesma camada de serviços.
6. Conclusão
O TechService demonstrou, na prática, como alinhar requisitos funcionais de gestão a uma arquitetura integrada, segura e organizada. O desenvolvimento permitiu aplicar de forma conjunta conceitos abordados no PIM IV, envolvendo aplicações Web e Mobile, API RESTful, autenticação, modelagem de dados e banco de dados relacional.
A utilização de uma API centralizada também permitiu integrar diferentes tipos de aplicação mantendo as regras de negócio concentradas em uma única camada, facilitando a organização, manutenção e evolução do sistema.