Anderson LimaSoftware Engineer & Architect
4 de outubro de 2026
3 min de leitura
29 visualizações
Interface Segregation Principle (ISP) diz: clientes不应该 ser forçados a depender de interfaces que não usam. Traduzindo para o dia-a-dia: não crie contratos que carregam 47 campos quando o consumidor precisa de 3.
Esse princípio, que parece óbvio, é quebrado sistematicamente em sistemas médios e grandes. O resultado é acoplamento fantasma: mudar um campo quebra consumidores que nem usam aquele campo.
interface User {
id: string;
name: string;
email: string;
avatar: string;
bio: string;
followersCount: number;
followingCount: number;
postsCount: number;
isVerified: boolean;
preferences: UserPreferences;
settings: UserSettings;
// ... 30+ campos
}
async function getUserAvatar(userId: string): Promise<string> {
const user = await api.users.get(userId);
return user.avatar;
}
O endpoint /users/:id retorna User obesa. Para mostrar avatar, você busca 30 campos. Banco faz query pesada, rede transmite JSON grande, JS parseia objeto gigante, e você usa 1 campo.
interface UserSummary {
id: string;
name: string;
avatar: string;
}
interface UserProfile extends UserSummary {
bio: string;
followersCount: number;
followingCount: number;
postsCount: number;
}
interface UserSettings {
preferences: UserPreferences;
settings: UserSettings;
}
// Endpoint específico
app.get('/users/:id/summary', async (req, res) => {
const user = await db.users.findSummary(req.params.id);
res.json(user);
});
app.get('/users/:id/profile', async (req, res) => {
const user = await db.users.findProfile(req.params.id);
res.json(user);
});
Cada endpoint retorna só o que precisa. Cliente escolhe granularidade.
{
user(id: "123") {
name
avatar
}
}
Cliente pede exatamente o que precisa. Backend entrega. ISP nativo.
// ❌ Errado
function UserCard({ user }: { user: User }) {
return <div>{user.name}</div>;
}
// ✅ Certo
interface UserCardProps {
name: string;
avatar: string;
}
function UserCard({ name, avatar }: UserCardProps) {
return (
<div>
<img src={avatar} />
<span>{name}</span>
</div>
);
}
// Uso
<UserCard name={user.name} avatar={user.avatar} />
Componente declara exatamente o que precisa. Não força caller a buscar User inteira.
const selectUserName = (state: RootState) => state.user.name;
const selectUserAvatar = (state: RootState) => state.user.avatar;
function UserCard() {
const name = useSelector(selectUserName);
const avatar = useSelector(selectUserAvatar);
return <div><img src={avatar} />{name}</div>;
}
Componente depende de selectors mínimos. Mudança em state.user.bio não rerenderiza UserCard.
ISP tem custo. Aplicar sempre pode gerar overengineering.
ISP não é dogma. É heurística útil para evitar acoplamento fantasma. Quando você tem dúvida se deve segregar, considere o custo da segregação versus o custo do overfetching/acoplamento.
Na dúvida, comece segregado. Refatore para unificar se a segregação causar mais fricção que benefício.
Produtos gratuitos e pagos para transformar ideias em uma base que você consegue executar.
13 produtos disponíveis
nextjs · boilerplate
Boilerplate de API em Python com FastAPI, organizado em Clean Architecture (router, service, repository e adapters por módulo). Inclui autenticação JWT com hashing bcrypt, MongoDB, testes com pytest e cobertura, Dockerfile e docker-compose para subir localmente, e documentação Swagger/OpenAPI automática. Repositório de origem privado; snapshot técnico verificado antes da publicação.
Ver produto
react · boilerplate
Base React Native para apps iOS e Android com Expo, Clean Architecture, MVVM, Firebase e módulos nativos. Referência técnica do VaiDeFut, com distribuição pública no Google Play e fluxo de publicação para iOS documentado.
Ver produto
nextjs · boilerplate
Kit gratuito e open source para começar com agentes de código em Claude Code, Codex, Gemini, Copilot e OpenCode. A licença MIT está confirmada no repositório público.
Ver produto
nextjs · boilerplate
Fundação AI-first white-label para lançar produtos SaaS com Next.js, chat, RAG, memória, tenants e documentação. O snapshot verificado documenta Supabase, não MongoDB; essa limitação está explícita. MongoDB, Redis e RabbitMQ exigem integração/configuração compatível.
Ver produtonextjs · boilerplate
Edição avançada da base white-label e multi-tenant AI-first para acelerar produtos com Next.js, chat, RAG, memória e documentação. O snapshot verificado ainda não comprova uma camada Ultra distinta; a oferta mantém essa limitação transparente e explicita as trocas de provider, cache e filas.
Ver produtonextjs · boilerplate
Base white-label e multi-tenant para transformar uma ideia em um SaaS AI-first com Next.js, chat, RAG, memória e segurança documentados. O snapshot verificado usa Supabase; o nome identifica o repositório de origem. Provider, cache e filas ficam explícitos; Redis e RabbitMQ são integrações configuráveis.
Ver produto
react · portfolio
Uma contribuição única para apoiar conteúdo técnico gratuito, pesquisa e a continuidade de projetos relevantes publicados por Anderson Lima. Você escolhe o valor; não é uma assinatura.
Ver produto
react · boilerplate
Starter React gratuito para criar uma suíte de testes confiável desde o primeiro commit, com Vitest, Testing Library, Playwright, Vite, TypeScript, Zustand, React Query, MirageJS e PWA. O repositório não declara uma licença SPDX; revise os termos antes de uso comercial.
Ver produto
react · portfolio
Monorepo público em React, TypeScript e Vite para explorar uma biblioteca de componentes com linguagem visual inspirada em interfaces nativas. O README atual é enxuto e não declara uma licença SPDX; trate como preview gratuito.
Ver produto
nextjs · saas
Boilerplate SaaS AI-first com Next.js, Supabase, Stripe e provider routing para começar do primeiro prompt e acelerar o caminho até um deploy real. As adaptações de IA, banco, e-mail, cache e filas ficam explícitas; Redis e RabbitMQ são integrações configuráveis.
Ver produto
react · saas
Starter kit React + TypeScript para SaaS multi-tenant com Firebase, Atomic Design, temas, PWA, telas de produto, MirageJS e chat com Gemini extensível a outros providers. Valide requisitos de produção, custos e integrações antes de publicar.
Ver produto
react · boilerplate
Starter React público com TypeScript, Zustand, React Query, Tailwind CSS, PWA e integrações de IA documentadas. O repositório não declara uma licença SPDX; revise os termos antes de uso comercial.
Ver produto
nextjs · saas
Landing page SaaS para Next.js, TypeScript e Tailwind CSS com SEO, temas, i18n, PWA e pontos de integração para auth, Stripe e IA. Uma base clara para sair da tela vazia e adaptar sua proposta.
Ver produtoContinue explorando tópicos similares
Guia robusto para aplicar Dependency Inversion Principle com ports and adapters, React Context, contract tests e observabilidade de adapters em produção.
A rule, an AI suggestion, and a human agent's decision, for the same synthetic ticket: only one of them can ever change the ticket's state. From that constraint, DeskPilot gains a typed…
DeskPilot's tests were green. A synthetic provider outage, an actual local restore, and a release review exposed what those tests did not establish: whether a support agent can safely use the pilot.
Checklist de 47 pontos para encontrar bugs, riscos de segurança e problemas de performance antes do lançamento.
Templates testados em produção, usados por desenvolvedores. Economize semanas de setup no seu próximo projeto.