feat: add PJ (Pessoa Jurídica) basic registration

- Add Company model with all 34 required fields (SQLModel ORM + Pydantic schemas)
- Add Alembic migration for company table with unique CNPJ index
- Add CRUD functions (create_company, get_company_by_cnpj)
- Add POST /api/v1/companies/ endpoint (authenticated)
- Regenerate OpenAPI client with CompaniesService
- Add frontend registration form page at /companies with field validation
- Add 'Cadastro PJ' link to sidebar navigation
- Add backend tests for create, missing field (422), and duplicate CNPJ (400)

Co-Authored-By: bot_apk <apk@cognition.ai>

Author: devin-ai-integration[bot]

backend/app/alembic/versions/a1b2c3d4e5f6_create_company_table.py

@@ -0,0 +1,65 @@
+"""Create company table
+
+Revision ID: a1b2c3d4e5f6
+Revises: fe56fa70289e
+Create Date: 2026-03-23 18:20:00.000000
+
+"""
+import sqlalchemy as sa
+import sqlmodel.sql.sqltypes
+from alembic import op
+
+# revision identifiers, used by Alembic.
+revision = "a1b2c3d4e5f6"
+down_revision = "fe56fa70289e"
+branch_labels = None
+depends_on = None
+
+
+def upgrade():
+    op.create_table(
+        "company",
+        sa.Column("cnpj", sqlmodel.sql.sqltypes.AutoString(length=20), nullable=False),
+        sa.Column("razao_social", sqlmodel.sql.sqltypes.AutoString(length=255), nullable=False),
+        sa.Column("representante_legal", sqlmodel.sql.sqltypes.AutoString(length=255), nullable=False),
+        sa.Column("data_abertura", sa.Date(), nullable=False),
+        sa.Column("nome_fantasia", sqlmodel.sql.sqltypes.AutoString(length=255), nullable=False),
+        sa.Column("porte", sqlmodel.sql.sqltypes.AutoString(length=100), nullable=False),
+        sa.Column("atividade_economica_principal", sqlmodel.sql.sqltypes.AutoString(length=255), nullable=False),
+        sa.Column("atividade_economica_secundaria", sqlmodel.sql.sqltypes.AutoString(length=255), nullable=False),
+        sa.Column("natureza_juridica", sqlmodel.sql.sqltypes.AutoString(length=255), nullable=False),
+        sa.Column("logradouro", sqlmodel.sql.sqltypes.AutoString(length=255), nullable=False),
+        sa.Column("numero", sqlmodel.sql.sqltypes.AutoString(length=20), nullable=False),
+        sa.Column("complemento", sqlmodel.sql.sqltypes.AutoString(length=255), nullable=False),
+        sa.Column("cep", sqlmodel.sql.sqltypes.AutoString(length=10), nullable=False),
+        sa.Column("bairro", sqlmodel.sql.sqltypes.AutoString(length=255), nullable=False),
+        sa.Column("municipio", sqlmodel.sql.sqltypes.AutoString(length=255), nullable=False),
+        sa.Column("uf", sqlmodel.sql.sqltypes.AutoString(length=2), nullable=False),
+        sa.Column("endereco_eletronico", sqlmodel.sql.sqltypes.AutoString(length=255), nullable=False),
+        sa.Column("telefone_comercial", sqlmodel.sql.sqltypes.AutoString(length=20), nullable=False),
+        sa.Column("situacao_cadastral", sqlmodel.sql.sqltypes.AutoString(length=100), nullable=False),
+        sa.Column("data_situacao_cadastral", sa.Date(), nullable=False),
+        sa.Column("cpf_representante_legal", sqlmodel.sql.sqltypes.AutoString(length=14), nullable=False),
+        sa.Column("identidade_representante_legal", sqlmodel.sql.sqltypes.AutoString(length=20), nullable=False),
+        sa.Column("logradouro_representante_legal", sqlmodel.sql.sqltypes.AutoString(length=255), nullable=False),
+        sa.Column("numero_representante_legal", sqlmodel.sql.sqltypes.AutoString(length=20), nullable=False),
+        sa.Column("complemento_representante_legal", sqlmodel.sql.sqltypes.AutoString(length=255), nullable=False),
+        sa.Column("cep_representante_legal", sqlmodel.sql.sqltypes.AutoString(length=10), nullable=False),
+        sa.Column("bairro_representante_legal", sqlmodel.sql.sqltypes.AutoString(length=255), nullable=False),
+        sa.Column("municipio_representante_legal", sqlmodel.sql.sqltypes.AutoString(length=255), nullable=False),
+        sa.Column("uf_representante_legal", sqlmodel.sql.sqltypes.AutoString(length=2), nullable=False),
+        sa.Column("endereco_eletronico_representante_legal", sqlmodel.sql.sqltypes.AutoString(length=255), nullable=False),
+        sa.Column("telefones_representante_legal", sqlmodel.sql.sqltypes.AutoString(length=40), nullable=False),
+        sa.Column("data_nascimento_representante_legal", sa.Date(), nullable=False),
+        sa.Column("banco_cc_cnpj", sqlmodel.sql.sqltypes.AutoString(length=100), nullable=False),
+        sa.Column("agencia_cc_cnpj", sqlmodel.sql.sqltypes.AutoString(length=20), nullable=False),
+        sa.Column("id", sa.Uuid(), nullable=False),
+        sa.Column("created_at", sa.DateTime(timezone=True), nullable=True),
+        sa.PrimaryKeyConstraint("id"),
+    )
+    op.create_index(op.f("ix_company_cnpj"), "company", ["cnpj"], unique=True)
+
+
+def downgrade():
+    op.drop_index(op.f("ix_company_cnpj"), table_name="company")
+    op.drop_table("company")

backend/app/api/main.py

@@ -1,13 +1,14 @@
 from fastapi import APIRouter
 
-from app.api.routes import items, login, private, users, utils
+from app.api.routes import companies, items, login, private, users, utils
 from app.core.config import settings
 
 api_router = APIRouter()
 api_router.include_router(login.router)
 api_router.include_router(users.router)
 api_router.include_router(utils.router)
 api_router.include_router(items.router)
+api_router.include_router(companies.router)
 
 
 if settings.ENVIRONMENT == "local":

backend/app/api/routes/companies.py

@@ -0,0 +1,26 @@
+from typing import Any
+
+from fastapi import APIRouter, HTTPException
+
+from app.api.deps import CurrentUser, SessionDep
+from app.crud import create_company, get_company_by_cnpj
+from app.models import CompanyCreate, CompanyPublic
+
+router = APIRouter(prefix="/companies", tags=["companies"])
+
+
+@router.post("/", response_model=CompanyPublic)
+def create_company_route(
+    *, session: SessionDep, current_user: CurrentUser, company_in: CompanyCreate  # noqa: ARG001
+) -> Any:
+    """
+    Create new company (PJ).
+    """
+    existing_company = get_company_by_cnpj(session=session, cnpj=company_in.cnpj)
+    if existing_company:
+        raise HTTPException(
+            status_code=400,
+            detail="A company with this CNPJ already exists.",
+        )
+    company = create_company(session=session, company_in=company_in)
+    return company

backend/app/crud.py

@@ -4,7 +4,15 @@
 from sqlmodel import Session, select
 
 from app.core.security import get_password_hash, verify_password
-from app.models import Item, ItemCreate, User, UserCreate, UserUpdate
+from app.models import (
+    Company,
+    CompanyCreate,
+    Item,
+    ItemCreate,
+    User,
+    UserCreate,
+    UserUpdate,
+)
 
 
 def create_user(*, session: Session, user_create: UserCreate) -> User:
@@ -66,3 +74,16 @@ def create_item(*, session: Session, item_in: ItemCreate, owner_id: uuid.UUID) -
     session.commit()
     session.refresh(db_item)
     return db_item
+
+
+def get_company_by_cnpj(*, session: Session, cnpj: str) -> Company | None:
+    statement = select(Company).where(Company.cnpj == cnpj)
+    return session.exec(statement).first()
+
+
+def create_company(*, session: Session, company_in: CompanyCreate) -> Company:
+    db_company = Company.model_validate(company_in)
+    session.add(db_company)
+    session.commit()
+    session.refresh(db_company)
+    return db_company

backend/app/models.py

@@ -1,5 +1,5 @@
 import uuid
-from datetime import datetime, timezone
+from datetime import date, datetime, timezone
 
 from pydantic import EmailStr
 from sqlalchemy import DateTime
@@ -108,6 +108,65 @@ class ItemsPublic(SQLModel):
     count: int
 
 
+# Shared properties for Company (PJ)
+class CompanyBase(SQLModel):
+    cnpj: str = Field(min_length=1, max_length=20)
+    razao_social: str = Field(min_length=1, max_length=255)
+    representante_legal: str = Field(min_length=1, max_length=255)
+    data_abertura: date
+    nome_fantasia: str = Field(min_length=1, max_length=255)
+    porte: str = Field(min_length=1, max_length=100)
+    atividade_economica_principal: str = Field(min_length=1, max_length=255)
+    atividade_economica_secundaria: str = Field(min_length=1, max_length=255)
+    natureza_juridica: str = Field(min_length=1, max_length=255)
+    logradouro: str = Field(min_length=1, max_length=255)
+    numero: str = Field(min_length=1, max_length=20)
+    complemento: str = Field(min_length=1, max_length=255)
+    cep: str = Field(min_length=1, max_length=10)
+    bairro: str = Field(min_length=1, max_length=255)
+    municipio: str = Field(min_length=1, max_length=255)
+    uf: str = Field(min_length=1, max_length=2)
+    endereco_eletronico: str = Field(min_length=1, max_length=255)
+    telefone_comercial: str = Field(min_length=1, max_length=20)
+    situacao_cadastral: str = Field(min_length=1, max_length=100)
+    data_situacao_cadastral: date
+    cpf_representante_legal: str = Field(min_length=1, max_length=14)
+    identidade_representante_legal: str = Field(min_length=1, max_length=20)
+    logradouro_representante_legal: str = Field(min_length=1, max_length=255)
+    numero_representante_legal: str = Field(min_length=1, max_length=20)
+    complemento_representante_legal: str = Field(min_length=1, max_length=255)
+    cep_representante_legal: str = Field(min_length=1, max_length=10)
+    bairro_representante_legal: str = Field(min_length=1, max_length=255)
+    municipio_representante_legal: str = Field(min_length=1, max_length=255)
+    uf_representante_legal: str = Field(min_length=1, max_length=2)
+    endereco_eletronico_representante_legal: str = Field(min_length=1, max_length=255)
+    telefones_representante_legal: str = Field(min_length=1, max_length=40)
+    data_nascimento_representante_legal: date
+    banco_cc_cnpj: str = Field(min_length=1, max_length=100)
+    agencia_cc_cnpj: str = Field(min_length=1, max_length=20)
+
+
+# Properties to receive on company creation
+class CompanyCreate(CompanyBase):
+    pass
+
+
+# Database model, database table inferred from class name
+class Company(CompanyBase, table=True):
+    id: uuid.UUID = Field(default_factory=uuid.uuid4, primary_key=True)
+    cnpj: str = Field(unique=True, index=True, min_length=1, max_length=20)
+    created_at: datetime | None = Field(
+        default_factory=get_datetime_utc,
+        sa_type=DateTime(timezone=True),  # type: ignore
+    )
+
+
+# Properties to return via API, id is always required
+class CompanyPublic(CompanyBase):
+    id: uuid.UUID
+    created_at: datetime | None = None
+
+
 # Generic message
 class Message(SQLModel):
     message: str

backend/tests/api/routes/test_companies.py

@@ -0,0 +1,98 @@
+from fastapi.testclient import TestClient
+
+from app.core.config import settings
+
+VALID_COMPANY_DATA = {
+    "cnpj": "12345678000199",
+    "razao_social": "Empresa Teste LTDA",
+    "representante_legal": "João da Silva",
+    "data_abertura": "2020-01-15",
+    "nome_fantasia": "Empresa Teste",
+    "porte": "ME",
+    "atividade_economica_principal": "62.01-5-01",
+    "atividade_economica_secundaria": "62.02-3-00",
+    "natureza_juridica": "206-2",
+    "logradouro": "Rua das Flores",
+    "numero": "100",
+    "complemento": "Sala 201",
+    "cep": "01001000",
+    "bairro": "Centro",
+    "municipio": "São Paulo",
+    "uf": "SP",
+    "endereco_eletronico": "contato@empresa.com.br",
+    "telefone_comercial": "1133334444",
+    "situacao_cadastral": "Ativa",
+    "data_situacao_cadastral": "2020-01-15",
+    "cpf_representante_legal": "12345678901",
+    "identidade_representante_legal": "123456789",
+    "logradouro_representante_legal": "Av. Paulista",
+    "numero_representante_legal": "500",
+    "complemento_representante_legal": "Apto 10",
+    "cep_representante_legal": "01310100",
+    "bairro_representante_legal": "Bela Vista",
+    "municipio_representante_legal": "São Paulo",
+    "uf_representante_legal": "SP",
+    "endereco_eletronico_representante_legal": "joao@email.com",
+    "telefones_representante_legal": "11999998888",
+    "data_nascimento_representante_legal": "1985-06-20",
+    "banco_cc_cnpj": "Banco do Brasil",
+    "agencia_cc_cnpj": "1234-5",
+}
+
+
+def test_create_company(
+    client: TestClient, superuser_token_headers: dict[str, str]
+) -> None:
+    response = client.post(
+        f"{settings.API_V1_STR}/companies/",
+        headers=superuser_token_headers,
+        json=VALID_COMPANY_DATA,
+    )
+    assert response.status_code == 200
+    content = response.json()
+    assert content["cnpj"] == VALID_COMPANY_DATA["cnpj"]
+    assert content["razao_social"] == VALID_COMPANY_DATA["razao_social"]
+    assert content["representante_legal"] == VALID_COMPANY_DATA["representante_legal"]
+    assert content["nome_fantasia"] == VALID_COMPANY_DATA["nome_fantasia"]
+    assert content["porte"] == VALID_COMPANY_DATA["porte"]
+    assert content["logradouro"] == VALID_COMPANY_DATA["logradouro"]
+    assert content["cpf_representante_legal"] == VALID_COMPANY_DATA["cpf_representante_legal"]
+    assert content["banco_cc_cnpj"] == VALID_COMPANY_DATA["banco_cc_cnpj"]
+    assert content["agencia_cc_cnpj"] == VALID_COMPANY_DATA["agencia_cc_cnpj"]
+    assert "id" in content
+    assert "created_at" in content
+
+
+def test_create_company_missing_field(
+    client: TestClient, superuser_token_headers: dict[str, str]
+) -> None:
+    incomplete_data = VALID_COMPANY_DATA.copy()
+    del incomplete_data["cnpj"]
+    response = client.post(
+        f"{settings.API_V1_STR}/companies/",
+        headers=superuser_token_headers,
+        json=incomplete_data,
+    )
+    assert response.status_code == 422
+
+
+def test_create_company_duplicate_cnpj(
+    client: TestClient, superuser_token_headers: dict[str, str]
+) -> None:
+    data = VALID_COMPANY_DATA.copy()
+    data["cnpj"] = "99999999000100"
+    response = client.post(
+        f"{settings.API_V1_STR}/companies/",
+        headers=superuser_token_headers,
+        json=data,
+    )
+    assert response.status_code == 200
+
+    response = client.post(
+        f"{settings.API_V1_STR}/companies/",
+        headers=superuser_token_headers,
+        json=data,
+    )
+    assert response.status_code == 400
+    content = response.json()
+    assert content["detail"] == "A company with this CNPJ already exists."

backend/tests/conftest.py

@@ -7,7 +7,7 @@
 from app.core.config import settings
 from app.core.db import engine, init_db
 from app.main import app
-from app.models import Item, User
+from app.models import Company, Item, User
 from tests.utils.user import authentication_token_from_email
 from tests.utils.utils import get_superuser_token_headers
 
@@ -17,6 +17,8 @@ def db() -> Generator[Session, None, None]:
     with Session(engine) as session:
         init_db(session)
         yield session
+        statement = delete(Company)
+        session.execute(statement)
         statement = delete(Item)
         session.execute(statement)
         statement = delete(User)