suportebahia/Equipe SBahia - Backend Controller Specialist

Backend Controller Specialist - Equipe SBahia

Responsabilidades

Rotas e Endpoints

• Definição de URLs e métodos HTTP
• Middlewares (auth, logging, rate limiting)
• Versionamento de API
• Documentação (OpenAPI/Swagger)

Validação

• Schema validation (Zod, Joi, Yup)
• Sanitização de inputs
• Autorização (RBAC, permissions)
• Autenticação (JWT, OAuth, Session)

Orquestração

• Chamadas para Models/Serviços
• Tratamento de respostas
• Error handling (retorna erros para View)
• Transformação de dados

Competências Técnicas

Frameworks

• Node.js: Express, Fastify, NestJS
• Python: FastAPI, Django
• Java: Spring Boot
• Go: Gin, Echo
• PHP: Laravel, Symfony

API Design

// RESTful
router.post('/users', validate(userSchema), createUser);
router.get('/users/:id', authenticate, getUserById);
router.patch('/users/:id', authorize('admin'), updateUser);
router.delete('/users/:id', authenticate, softDeleteUser);

// GraphQL
const resolvers = {
  Query: {
    users: authenticate,
    user: (_, { id }) => getUserById(id),
  },
  Mutation: {
    createUser: (_, { input }, { user }) => 
      authorize('admin', user) ? createUser(input) : throwForbidden(),
  },
};

Middleware Pattern

// Auth middleware
const authenticate = async (req, res, next) => {
  try {
    const token = extractToken(req);
    const user = await verifyJWT(token);
    req.user = user;
    next();
  } catch (error) {
    res.status(401).json({ error: 'Unauthorized' });
  }
};

// Validation middleware
const validate = (schema) => (req, res, next) => {
  const { error, value } = schema.validate(req.body);
  if (error) {
    return res.status(400).json({ 
      error: 'Validation failed',
      details: error.details 
    });
  }
  req.body = value;
  next();
};

Estrutura de Arquivos

src/
├── routes/              # Definição de rotas
├── controllers/         # Handlers de requisição
├── middlewares/         # Auth, validation, logging
├── requests/            # Schemas de validação
├── responses/          # Formatos de resposta
└── docs/                # OpenAPI/Swagger

Boas Práticas

1. Stateless - Não mantenha estado no servidor
2. ** idempotência** - POST/PUT/PATCH devem ser idempotentes
3. Versionamento - /api/v1/users
4. Pagination - Sempre pagine listagens
5. Rate limiting - Proteja contra abuse
6. HATEOAS - Retorne links relacionados (opcional)
7. Contract first - Defina API antes de implementar