---
title: "Arquitetura de Software & Sistemas - José DA COSTA"
description: "Arquitetura de software e sistemas, na minha prática, e a arte de **escolher as fronteiras certas** entre subsistemas, os **contratos certos** entre eles e a **forma operacional certa**. E onde SOLID,"
locale: "pt"
canonical: "https://portfolio.josedacosta.info/pt/habilidades/arquitetura-de-software-sistemas"
source: "https://portfolio.josedacosta.info/pt/habilidades/arquitetura-de-software-sistemas.md"
html_source: "https://portfolio.josedacosta.info/pt/habilidades/arquitetura-de-software-sistemas"
author: "José DA COSTA"
type: "skill"
slug: "system-architecture-design"
generated_at: "2026-04-26T21:15:54.694Z"
---

# Arquitetura de Software & Sistemas

Ícone: 🏛️

## Minha definição

Arquitetura de software e sistemas, na minha prática, e a arte de **escolher as fronteiras certas** entre subsistemas, os **contratos certos** entre eles e a **forma operacional certa**. E onde SOLID, design patterns, design de API REST e DDD encontram as realidades da nuvem, da observabilidade e das topologias de equipe. Uma boa arquitetura faz a codebase crescer **linearmente em vez de exponencialmente**; uma ma arquitetura transforma cada nova feature em divida estrutural.

### Contexto

Pratico arquitetura em **4 escalas** diferentes conforme o contexto. **Modulo**: SOLID, hexagonal, domain-driven design. **Sistema**: REST + async + event-driven, contratos inter-services, gestao de erros. **Plataforma**: monorepo Turborepo, packages compartilhados, ambientes Terraform multi-tenants. **Ecossistema**: integração B2B, fornecedores externos, contratos versionados. **11 anos** de prática continua, do **monolito PHP** (Joomla, Zend, Symfony 2-7, Magento 1-2) ao **SaaS moderno TypeScript** (Next.js 16, Prisma, Payload CMS), com **28 referencias** no portfolio (Top 4 em frequencia bruta) e o **Master ESIEA Expert em Engenharia de Software** como base teorica.

### Relevância

Em 2026, a arquitetura entra numa nova fase: os SaaS verticais regulados (clinico, defesa, energia, contabilidade) repousam em arquiteturas **AI-native** onde os workflows são expressos em ações e restricoes em vez de telas. O moat já não está na stack, mas em **dado governado + workflows embarcados + integrações profundas**. o que Rob Saker analisa precisamente em [AI is Eating Enterprise SaaS](https://medium.com/@rsaker/ai-is-eating-enterprise-saas-1259d352f193). A arquitetura se torna a aposta tecnica mais defensavel de um CTO: feature-driven, observabilidade por padrao, contratos inter-services rastreaveis e fronteiras modulo/core sobreviventes aos upgrades.

## Minhas evidências

### Arquitetura feature-driven do SaaS contabil ACCENSEO

**Contexto:** Quando comecei o SaaS contabil da ACCENSEO no inicio de 2025, eu sabia que ficaria sozinho codando por 14 meses em **mais de 200 mil linhas de código**, num dominio regulado que não perdoa atalhos (PCG, CGI, e-fatura 2026-2027). A armadilha classica nesse tipo de codebase e comecar com um split por camada tecnica (controllers / services / repositories) que vira ingerivel passados 30 modulos. Eu precisava de uma arquitetura que aguentasse 2 anos sem divida estrutural.

**Ação:** Apostei numa **arquitetura feature-driven** desde o primeiro commit: **42 modulos autonomos** em `src/features/` (banco, faturamento, contabilidade, fiscal, folha, assistente IA, reporting, juridico, OCR...), cada um com seus proprios componentes, hooks, services, models e types. `src/app/` so contem o roteamento Next.js, nunca lógica de negocio. Do lado dos dados, **91 modelos Prisma** organizados em torno das entidades de dominio (não em torno das tabelas SQL), com **63 enums** tipados, e **6 papeis** diferenciados controlados pelo Better Auth. Para os contratos cross-feature, expus um `index.ts` por feature definindo a superficie pública consumivel - todo o resto fica interno ao modulo.

**Resultado:** **382 rotas API** geradas, novas features adicionadas **em dias em vez de semanas**, e as fronteiras modulo/feature sobreviveram a varios refactorings importantes (upgrade Next.js 16, migracao React 19, adicao da extensao Chrome Teledec) sem precisar mexer na estrutura geral.

**Valor agregado:** O que validei nesse projeto e que **uma boa arquitetura torna o crescimento linear** em vez de exponencial: na 30a feature eu estava tao rápido quanto na 5a. E exatamente a promessa que preciso sustentar no próximo papel CTO scale-up - e já a estressei em solo, o que torna a transposicao para um time muito mais credivel.

### Reescrita v2 Rebirth do extranet European Sourcing

**Contexto:** O **extranet European Sourcing** era o back-office central do maior salao online europeu de objetos publicitarios - **15 sub-projetos interconectados**, base MySQL compartilhada de **15 GB em 97 tabelas**, **7 linguas**, **800 fornecedores**, e alguns catalogos como SOL's traziam **15.000 variacoes para um único produto**. A v1, escrita em 2008-2013 num framework MVC PHP caseiro, não acompanhava mais o ritmo: cada adicao de negocio custava cada vez mais.

**Ação:** Em 14 de marco de 2016, comecamos a **v2 "Rebirth"** em **Symfony 3.1**, com **PostgreSQL** no lugar do MySQL, **RabbitMQ** para mensageria assincrona, e principalmente 2 bundles compartilhados - **ESCoreBundle** (entidades, auth, sistema de arquivos) e **ESSourcingBundle** (lógica de negocio) - para consolidar o que os 15 sub-projetos duplicavam. Para industrializar as telas de admin, montei um sistema de **listas genericas (EntityList)** com colunas configuraveis, ações em massa, ações por linha e paginacao. No lado dos formularios, entreguei **mais de 70 Form Types Symfony** cobrindo produtos, variantes, marcacoes estaticas e dinamicas com perfis, atributos simples / multiplos / grupos, categorias, palavras-chave, labels com sinonimos, assinaturas e workflows de import-export.

**Resultado:** A v2 rodou **mais de 5 anos em produção** (2016-2021), alimentando **37 conectores de import automatizados** (Pixika, Makito, Midocean, BIC, Paul Stricker, Clipper, TopTex, Cybernecard...), e a pattern library posta nessa ocasiao foi **reutilizada por todos os apps a jusante** sem precisar reescrever a arquitetura uma única vez.

**Valor agregado:** Esse projeto me ensinou a **compartilhar sem acoplar**: os bundles compartilhados ficaram estaveis enquanto cada sub-projeto evoluia no próprio ritmo. E o padrao que rejogo hoje no monorepo Turborepo da ACCENSEO e que vou impor na próxima plataforma scale-up - o custo de uma boa fatoracao e baixo, o custo de uma ma fatoracao e toxico em 10 anos.

### Arquitetura Magento Enterprise multi-loja na Fleurance Nature

**Contexto:** Na refatoracao da Fleurance Nature em 2017 na Smile, herdei uma plataforma **Magento Enterprise Edition 1.10** carregada até o limite: **1.040 arquivos PHP** modificados, **60 modulos custom** acumulados, **3 storefronts** (Fleurance Nature France, International, Mincifine) para servir com uma **matriz tarifaria EAV** compartilhada entre **4 grupos de clientes** (anonimos, geral, assinantes fieis, comites de empresa) - ou seja, 12 combinacoes tarifarias ativas. As proprias specs passaram por **7 versoes em 2 meses** (de 30 a 50 paginas) a medida que descobriamos as regras de negocio escondidas no código legado.

**Ação:** Recusei a tentacao do big-bang. Coloquei um **split limpo backend/frontend** nos 3 storefronts, **portei ElasticSearch para o Magento EE 1.10** substituindo Solr (autocomplete, navegacao por facetas, categorias virtuais), e impus em cada modulo custom o respeito aos padroes **Observer/Strategy** para permanecer **PCI-aware** sem tocar no core do Magento. Para garantir os deploys, montei uma **suite de regressao completa nos 3 sites** antes de cada release, porque mexer num modulo podia impactar potencialmente as 12 matrizes tarifarias.

**Resultado:** A plataforma refatorada se manteve **mais de 5 anos em produção** sem nova reescrita arquitetural, **zero incidente de seguranca major** durante e apos a migracao, e o **cache Varnish** ficou operacional ao longo de todo o processo apesar da sensibilidade do site live.

**Valor agregado:** O que aprendi nesse projeto e que as **fronteiras modulo/core** são o que faz uma codebase sobreviver as trocas de prestador e aos upgrades - não a qualidade do código em si. Em cada auditoria de CTO advisory que conduzo hoje na ACCENSEO, e a primeira coisa que olho na codebase do cliente.

## Minha autocrítica

### Grau de domínio

Nível **Expert (5/5)**. 11 anos de prática arquitetural, do monolito PHP ao SaaS moderno TypeScript passando pelas plataformas de integração ESB. Master ESIEA como base teorica, **28 referencias portfolio** como volume de prática.

Cobertura confirmada nas 4 escalas:

- **modulo**: SOLID, DDD, hexagonal
- **sistema**: REST, async, event-driven, CQRS parcial
- **plataforma**: monorepo Turborepo, packages compartilhados, Terraform multi-env
- **ecossistema**: integração B2B

O que falta fortalecer: event sourcing puro e service mesh em larga escala.

### Importância no meu perfil

Coracao da minha credibilidade como CTO. Sem arquitetura solida, o produto não sustenta o crescimento, a equipe não escala e a divida vira existencial em 18 meses. E também o que distingue o CTO operacional do CTO advisory: saber traduzir uma intencao de negocio em fronteiras tecnicas, contratos inter-equipes e plano de migracao concreto.

### Conselhos (para mim e para os outros)

### Meus principios de arbitragem

Para mim mesmo: *escrever um ADR para cada decisão irreversivel* e manter um diagrama de sistema vivo. Aos outros: preferir simplicidade até prova em contrario, recusar o pattern por autoridade ("fazemos assim porque a Netflix faz") e exigir o criterio de negocio que o justifique. Sempre simular o custo operacional de um split antes de valida-lo. *um microservico e também um pipeline, um dashboard e um plantao*.

## Minha evolução nesta competência

### Papel no meu projeto profissional

A arquitetura e o que transforma uma intuicao CTO em **plataforma defensavel a 3 anos**. No plano de 24 meses, ela torna possiveis as arbitragens *build vs buy* pesadas, as migracoes maiores **sem interrupcao de produto** e a disciplina de equipe (revisao de código, ADRs, contratos inter-servicos). Sem ela, a organização pode crescer mas a divida acaba matando a cadencia.

### Nível almejado a médio prazo

O objetivo e a **extensao event-driven e service mesh**: desenhar e implementar uma transicao monolito -> modulos autonomos **sem interrupcao de produto**, e defender essa trajetoria diante de um board em linguagem business (risco, ciclo, OPEX). Manter o dominio Expert sem decaimento e a base, o esforco vai para as fronteiras onde ainda não operei em produção.

### Formações em andamento

Leitura continua: Martin Kleppmann *Designing Data-Intensive Applications* (relido anualmente), Neal Ford / Mark Richards *Software Architecture: The Hard Parts*, Sam Newman *Building Microservices*. Prática diaria nas codebases ACCENSEO. Master Expert em Engenharia de Software ativo até 2026.

### Formações futuras

Conferencia [QCon Paris 2026](https://qconferences.com/paris), possivel programa Domain-Driven Design avancado (Vlad Khononov ou masterclass Eric Evans) em 2027. Certificacao AWS Solutions Architect Professional considerada conforme contexto CTO alvo.

## Progressão ao longo da trajetória

Está competência foi desenvolvida em 13 trajetórias diferentes.

- **1999** - [CTO · Founder · diretor técnico](https://portfolio.josedacosta.info/pt/trajetoria/celiane-founder.md) (entrepreneurship) - Confidence: 2/5
- **2009** - [Software Engineer · desenvolvedor PHP Zend Framework](https://portfolio.josedacosta.info/pt/trajetoria/european-sourcing-engineer.md) (experience) - Confidence: 3/5
- **2013** - [Senior Software Engineer · Lead desenvolvedor PHP Symfony](https://portfolio.josedacosta.info/pt/trajetoria/medialeads-senior-engineer.md) (experience) - Confidence: 3/5
- **2016** - [Technical Project Manager · Co-founder · Early-Stage Startup](https://portfolio.josedacosta.info/pt/trajetoria/adspower-cofounder.md) (entrepreneurship) - Confidence: 4/5
- **2017** - [Senior Software Engineer · Lead desenvolvedor PHP Magento](https://portfolio.josedacosta.info/pt/trajetoria/smile-senior-engineer.md) (experience) - Confidence: 4/5
- **2019** - [Engineering Manager · Project Manager / Product Owner · Technical Lead](https://portfolio.josedacosta.info/pt/trajetoria/pichet-group.md) (experience) - Confidence: 5/5
- **2019** - [Technical Lead · Fluxos e Produtos: conteúdos e integração empresarial](https://portfolio.josedacosta.info/pt/trajetoria/pichet-technical-lead.md) (experience) - Confidence: 4/5
- **2020** - [Empreendedor · diversos domínios de atividade](https://portfolio.josedacosta.info/pt/trajetoria/auto-entrepreneur-jdc.md) (entrepreneurship) - Confidence: 4/5
- **2021** - [Project Manager / Product Owner · Fluxos e Produtos: PIM & DAM & ESB](https://portfolio.josedacosta.info/pt/trajetoria/pichet-project-manager.md) (experience) - Confidence: 4/5
- **2023** - [MBA Gestão Estratégica de Projetos](https://portfolio.josedacosta.info/pt/trajetoria/mba-strategic-project-management.md) (education) - Confidence: 5/5
- **2023** - [Mestrado em Engenharia de Software](https://portfolio.josedacosta.info/pt/trajetoria/master-software-engineering.md) (education) - Confidence: 5/5
- **2023** - [Engineering Manager · Integração de Aplicações Empresariais](https://portfolio.josedacosta.info/pt/trajetoria/pichet-engineering-manager.md) (experience) - Confidence: 5/5
- **2024** - [CTO · Founder · diretor técnico](https://portfolio.josedacosta.info/pt/trajetoria/accenseo-founder.md) (entrepreneurship) - Confidence: 5/5

## Realizações relacionadas

- [Intelligent Accounting SaaS Platform](https://portfolio.josedacosta.info/pt/realizacoes/plateforme-comptabilite-saas.md) - Feature-Driven architecture with 42 autonomous modules and 91 database models. 382 REST API routes with multi-role access control (6 profiles) and DGFIP v3.1 e-invoicing readiness
- [European B2B Search Engine for Promotional Products (European Sourcing)](https://portfolio.josedacosta.info/pt/realizacoes/moteur-de-recherche-europeen-b2b-objets-publicitaires.md) - Decomposed the SQLI monolith into a microservices ecosystem (API, search, flux, translate, export, stats, supplierbo) with shared Symfony bundles (ESCoreBundle, ESSourcingBundle) and WSSE stateless inter-service authentication. Built a REST JSON API on Symfony 2.4 + Propel with WSSE stateless authentication (nonce + timestamp + digest), JMS Serializer, CORS, and multi-database connections (europeansourcing + tendanceobjet) - Applied microservices, MVC, SPA (AngularJS), Strategy pattern for 26+ heterogeneous supplier connectors (CSV/XML/API), and Doctrine behaviors (Sluggable, Sortable, Timestampable, Translatable, Blameable)
- [Partner Lead Reception API Platform (alias PSR)](https://portfolio.josedacosta.info/pt/realizacoes/plateforme-api-reception-leads-partenaires.md) - End-to-end architecture: API gateway, normalization, enrichment layer, CRM routing, Partner-facing REST endpoints, data contracts and 5 API versions
- [E-Commerce Platform Redesign Magento Enterprise Edition (alias Fleurance Nature)](https://portfolio.josedacosta.info/pt/realizacoes/refonte-ecommerce-magento-fleurancenature.md) - Multi-site architecture (3 storefronts), Solr to ElasticSearch migration with faceted search, ERP bidirectional flows redesign, 8-environment deployment topology - Magento XML rewrites pattern, MVC, Observer and Strategy patterns applied across 60+ modules without touching core code
- [ETL Pipeline for Real Estate Listing Syndication (alias Ligneurs)](https://portfolio.josedacosta.info/pt/realizacoes/pipeline-etl-syndication-immobiliere.md) - Designed the complete ETL architecture: modular per-partner pipeline, batch over real-time, centralized multi-format image pre-generation - Integrated PIM Akeneo v2 REST API for data extraction and several dozen partner endpoints (REST APIs and FTP/SFTP file drops)
- [PIM Extranet for B2B Promotional Products Search Engine (European Sourcing)](https://portfolio.josedacosta.info/pt/realizacoes/extranet-pim-b2b-objets-publicitaires.md) - PIM/data model bigger than Akeneo: 32+ fields per variant, 36 per marking option, 50+ pricing grids, 97 MySQL tables on 15 GB, European Sourcing REST API consumed by the Supplier BO SPA and downstream services across 7 languages. Shared Symfony bundles (ESCoreBundle, ESSourcingBundle), 70+ Form Types, generic EntityList system, MVC + SPA + ETL
- [Flux - Supplier Data Synchronization](https://portfolio.josedacosta.info/pt/realizacoes/flux-synchronisation-fournisseurs.md) - Designed scalable ETL framework with multi-protocol integration (FTP, HTTP, REST) and connector pattern. Integrated diverse supplier APIs and data formats (CSV/XML/JSON) with automated daily synchronization
- [E-Commerce Site Generator with Customization CMS (alias MyEasyWeb)](https://portfolio.josedacosta.info/pt/realizacoes/generateur-sites-ecommerce-avec-cms.md) - Designed multi-tenant SaaS architecture serving 400+ branded reseller sites with domain-based detection, Built REST APIs on Symfony 2.4 (FOSRestBundle, JMSSerializer, WSSE) for cross-application synchronization
- [SaaS platform for mortgage credit brokers powered by AI](https://portfolio.josedacosta.info/pt/realizacoes/plateforme-saas-courtiers-credit-immobilier.md) - Designed monorepo architecture with 7 apps, 14 shared packages, and 98 database models
- [AI Chat Export - Multi-Platform AI Conversation Export Extension](https://portfolio.josedacosta.info/pt/realizacoes/ai-chat-export.md) - Architected modular extension with Strategy pattern and AbstractExtractor
- [Gradient Generator - Advanced CSS Gradient Creation Tool](https://portfolio.josedacosta.info/pt/realizacoes/gradient-generator-css.md) - Architected 8 interconnected Zustand stores, feature-driven component structure, and dual-storage backend
- [Atlassian Forge Developer - Intelligent IDE Plugin](https://portfolio.josedacosta.info/pt/realizacoes/atlassian-forge-developer-ide-plugin.md) - Designed modular plugin architecture with IntelliJ Platform SDK extension points, PSI tree manipulation, and schema-driven validation
- [Multi-Supplier Product Data Import System](https://portfolio.josedacosta.info/pt/realizacoes/import-european-sourcing.md) - Evolved from legacy PHP monolith to Symfony-based async import system with queue processing
- [Food Truck & Mobile Concept Platform - French manufacturer (alias MCR)](https://portfolio.josedacosta.info/pt/realizacoes/plateforme-food-truck-concepts-mobiles.md) - Designed the monolithic full-stack architecture: Next.js App Router + Payload CMS v3 + PostgreSQL, 15 collections, 24 content blocks - every structural decision owned end-to-end
- [Centralized Multilingual Translation Management Platform](https://portfolio.josedacosta.info/pt/realizacoes/plateforme-gestion-traductions-multilingues.md) - Designed PO/MO file management system with MySQL catalog integration and multi-project synchronization
- [tailwindcss-obfuscator - Open Source CSS Obfuscation Tool](https://portfolio.josedacosta.info/pt/realizacoes/tailwindcss-obfuscator.md) - Designed modular pipeline architecture (extractors, transformers, plugins) supporting 10 frameworks and 4 bundlers
- [Supplier Back-Office - B2B Self-Service Portal](https://portfolio.josedacosta.info/pt/realizacoes/supplier-backoffice-european-sourcing.md) - Designed decoupled SPA architecture with 14 custom directives forming a reusable UI framework
- [MagicPlaylist - Android Music Discovery & Playlist Generator](https://portfolio.josedacosta.info/pt/realizacoes/magicplaylist-android-music-discovery.md) - Designed MVVM architecture with 5-strategy mapping pipeline, BFS expansion algorithm, and 3-level chunking
- [Collaborative Project Management Platform](https://portfolio.josedacosta.info/pt/realizacoes/plateforme-gestion-projets-collaboratif.md) - Designed 3-tier SPA architecture with layered backend (Controller/Service/Repository), DTOs, and 7-table database with triggers
- [Engineering Manager - Enterprise Integration Platform (alias ESB)](https://portfolio.josedacosta.info/pt/realizacoes/engineering-manager-integration-entreprise.md) - Supervised the architecture of 100+ production flows across 20+ enterprise systems, iPaaS evaluation
- [AI Machine Learning SaaS Platform for Ad Optimization (alias AdsPower)](https://portfolio.josedacosta.info/pt/realizacoes/plateforme-publicitaire-machine-learning.md) - Integrated Google AdWords, Bing Ads, and Facebook Ads APIs for multi-platform campaign management

Versão interativa com navegação: https://portfolio.josedacosta.info/pt/habilidades/arquitetura-de-software-sistemas