#' Load Continuous PNAD Data
#'
#' This function downloads PNADC data and applies panel identification algorithms
#'
#' @param save_to A \code{character} with the directory in which to save the downloaded files.
#' @param years A \code{numeric} indicating for which years the data will be loaded, in the format YYYY. Can be any vector of numbers, such as 2010:2012.
#' @param quarters The quarters within those years to be downloaded. Can be a numeric vector or a list of vectors, for different quarters per year.
#' @param panel A \code{character} choosing the panel algorithm to apply ("none", "basic", or "advanced"). For details, check \code{vignette("BUILD_PNADC_PANEL")}
#' @param raw_data A \code{logical} setting the return of raw (\code{TRUE}) or processed (\code{FALSE}) variables.
#' @param save_options A \code{logical} vector of length 2. Controls whether quarterly
#'   files are saved and in which format all files are saved. Panel files are
#'   always saved. There are four possible combinations:
#'   \itemize{
#'     \item \code{c(TRUE, TRUE)}: saves quarterly and panel files in
#'       \code{.rds} format. This is the default.
#'     \item \code{c(TRUE, FALSE)}: saves quarterly and panel files in
#'       \code{.parquet} format.
#'     \item \code{c(FALSE, TRUE)}: does not save quarterly files; panel files
#'       are saved in \code{.rds} format.
#'     \item \code{c(FALSE, FALSE)}: does not save quarterly files; panel files
#'       are saved in \code{.parquet} format.
#'   }
#' @param vars A \code{character} vector of additional variable names to be
#'   downloaded, following the same convention as the \code{vars} parameter in
#'   \code{\link[PNADcIBGE]{get_pnadc}}. Each name must match a column in the
#'   PNADC microdata exactly as published by IBGE (e.g. \code{"VD4019"},
#'   \code{"V2009"}).
#'
#'   Note that \code{\link[PNADcIBGE]{get_pnadc}} always returns a set of
#'   structural columns regardless of this argument, these include survey
#'   design weights (\code{V1027}, \code{V1028}, \code{V1028001}, \code{V1028200},
#'   \code{posest}, \code{posest_sxi}), deflator variables (\code{Habitual},
#'   \code{Efetivo}), and identifiers such as \code{UF}, \code{Estrato},
#'   \code{V1029}, \code{V1033}, \code{ID_DOMICILIO}, totalling around 233
#'   columns. The \code{vars} argument adds \emph{on top of} those columns;
#'   it does not restrict them. Use \code{NULL} (the default) to download all
#'   available microdata columns.
#'
#'   If \code{panel} is not \code{"none"}, any columns required by the panel
#'   identification algorithm that are missing from \code{vars} will be added
#'   automatically and a \code{\link{warning}} will list the columns that were
#'   added. The required columns per algorithm are:
#'   \itemize{
#'     \item \code{"basic"}: \code{UPA}, \code{V1008}, \code{V1014},
#'       \code{V2007}, \code{V20082}, \code{V20081}, \code{V2008}.
#'     \item \code{"advanced"}: all of the above, plus \code{V2003}.
#'   }
#'   Note that several of these (\code{UPA}, \code{V1008}, \code{V1014}) are
#'   part of the structural columns always returned by
#'   \code{\link[PNADcIBGE]{get_pnadc}}, so in practice only \code{V2007},
#'   \code{V20082}, \code{V20081}, \code{V2008} (and \code{V2003} for
#'   \code{"advanced"}) are likely to be auto-added.
#'
#' @return A message indicating the successful save of panel files.
#'
#' @import PNADcIBGE
#' @importFrom magrittr `%>%`
#'
#' @examplesIf interactive()
#' ### DO NOT RUN ###
#' load_pnadc(
#'   save_to = tempdir(),
#'   years = 2016,
#'   quarters = 1:4,
#'   panel = "advanced",
#'   raw_data = FALSE,
#'   save_options = c(FALSE, FALSE)
#' )
#' @export

load_pnadc <- function(save_to, years,
                       quarters = 1:4, panel = "advanced",
                       raw_data = FALSE, save_options = c(TRUE, TRUE),
                       vars = NULL) {
  
  if (missing(save_to) || is.null(save_to) || !nzchar(save_to)) {
    stop("'save_to' must be a non-empty path to an existing directory.", call. = FALSE)
  }
  if (!dir.exists(save_to)) {
    stop("Directory '", save_to, "' does not exist. Please create it first.", call. = FALSE)
  }
  
  # Check if PNADcIBGE namespace is already attached
  if (!"PNADcIBGE" %in% .packages()) {
    # If not attached, attach it
    attachNamespace("PNADcIBGE") # without this, an error appears
    # I believe this is a problem with the PNADcIBGE package
    # If you run PNADcIBGE::get_pnad(...) without library(PNADcIBGE)
    # you get the same error
  }
  
  # if (!requireNamespace("PNADcIBGE", quietly = TRUE)) {
  #   stop(
  #     "Please run library(PNADcIBGE) before using this function.",
  #     call. = FALSE
  #   )
  # }
  
  ###########################
  ## Bind Global Variables ##
  ###########################
  
  year <- . <- V1014 <- Ano <- Trimestre <- NULL
  
  #############################
  ## Define Basic Parameters ##
  #############################
  
  # The param list contains the various objects that will be used as parameters for this function
  param <- list()
  param$years     <- years     # the years the user would like to download
  param$quarters  <- quarters  # the quarters within those years to be downloaded
  param$panel     <- panel     # which panel algorithm (none, basic or advanced) should be applied to this data, check our READ-ME for greater explanation
  param$raw_data  <- raw_data  # A command to define if the user would like to download the raw data from the IBGE website directly
  param$save_to   <- save_to   # the directory in which the user desires to save the files downloaded
  param$save_quarters <- save_options[1] # whether to save quarterly files to disk
  param$rds           <- save_options[2] # if TRUE, saves as .rds; if FALSE, saves as .parquet
  
  # Check if quarter is a list; if not, wrap it in a list and repeat it for each year
  if (!is.list(quarters)) {
    param$quarters <- rep(list(quarters), length(years))
  }
  
  # Calculate the lengths of quarters for each year
  n_quarters <- lapply(param$quarters, length)
  
  # Map2: Repeat each year based on the corresponding lengths in n_quarters, so we can have two parallel vectors of years and quarters to loop over
  param$years <- purrr::map2(
    years, n_quarters,
    function(year, n) {
      rep(year, n)
    }
  )
  
  # generaring these two paralell vectors of years and quarter to loop over
  
  param$years    <- unlist(param$years)
  param$quarters <- unlist(param$quarters)
  
  #####################
  ## vars validation ##
  #####################
  
  # Columns required to run the panel identification algorithms.
  # These must always be present in the data regardless of the user's selection.
  panel_required_basic    <- c("UPA", "V1008", "V1014", "V2007", "V20082", "V20081", "V2008")
  panel_required_advanced <- c(panel_required_basic, "V2003")
  
  if (!is.null(vars) && param$panel != "none") {
    required_cols <- if (param$panel == "advanced") panel_required_advanced else panel_required_basic
    missing_cols  <- setdiff(required_cols, vars)
    if (length(missing_cols) > 0) {
      warning(
        "The following columns required for panel identification were not in `vars` ",
        "and have been added automatically: ",
        paste(missing_cols, collapse = ", "),
        ".\n",
        "Note: PNADcIBGE::get_pnadc() always returns ~210 structural columns (weights, ",
        "deflators, identifiers) regardless of `vars`. The `vars` argument only adds ",
        "columns on top of those, it does not restrict them.",
        call. = FALSE
      )
      vars <- c(vars, missing_cols)
    }
  }
  
  ##################
  ## Loading data ##
  ##################
  
  # store info on all panels and column names
  
  panel_list <- c()
  cnames     <- NULL
  
  # download all quarters into a list of data frames
  
  source_files <- purrr::map2(
    param$years, param$quarters, # looping over the two parallel vector of years and quarters (this was previoulsy done in a "for" structure, but qwe optimized it)
    
    function(year, quarter) {
      base::message(paste0("Downloading PNADC ", year, " Q", quarter, "\n"))
      
      df <- get_pnadc(year = year, quarter = quarter, labels = FALSE, design = FALSE, vars = vars)
      
      if (is.null(df)) {
        return(NULL)
        
      } else {
        # turns everything into numeric
        df <- df %>%
          dplyr::mutate(dplyr::across(dplyr::everything(), as.numeric))
        
        panel_list <<- c(panel_list, unique(df$V1014)) # registering, for every quarter, the panel's which the quarter's observations are included (every OBS is just included in one panel, but the data for a quarter contains observations of many panels)
        #<<- stabilishing a variable inside the function that continues to exist outside the function, it is not just local to the function's current context
        
        # runs data cleaning if desired
        if (!param$raw_data) {
          df <- treat_pnadc(df)
        }
        
        cnames <<- names(df)
        
        # tag each row with its year and quarter for later reference
        df$Ano       <- year
        df$Trimestre <- quarter
        
        return(df)
      }
    }
  )
  
  # Remove NULL entries (failed downloads)
  source_files <- purrr::compact(source_files)
  
  # bind all quarters into one data frame
  all_quarters <- purrr::list_rbind(source_files)
  
  # save quarterly files to disk if requested
  if (param$save_quarters) {
    if (param$rds) {
      # RDS: write one flat file per year-quarter
      purrr::map2(
        param$years, param$quarters,
        function(y, q) {
          quarter_df <- all_quarters %>% dplyr::filter(Ano == y, Trimestre == q)
          file_path <- file.path(
            param$save_to, paste0("pnadc_", y, "_", q, ".rds")
          )
          base::message(paste0("Saving ", y, " Q", q, " to\n", file_path, "\n"))
          saveRDS(quarter_df, file_path)
        }
      )
    } else {
      # Parquet: write a partitioned dataset grouped by Ano/Trimestre
      quarters_dir <- file.path(param$save_to, "pnadc_quarters")
      base::message(paste0(
        "Saving quarterly parquet dataset to\n", quarters_dir, "\n"
      ))
      all_quarters %>%
        dplyr::group_by(Ano, Trimestre) %>%
        arrow::write_dataset(
          path = quarters_dir,
          format = "parquet"
        )
    }
  }
  
  ## Return Raw Data
  
  if (param$panel == "none") {
    return(paste("Quarters saved to", param$save_to))
  }
  
  #################
  ## Panel Files ##
  #################
  
  if (param$panel != "none") {
    ## Split data into panels
    
    panel_list <- unique(panel_list) # listing all the panels included in the quarters downloaded
    
    # Apply panel identification to each panel's data
    
    identified_panels <- purrr::map(
      panel_list,
      function(p) {
        base::message(paste("Compiling panel", p, "\n"))
        dat <- all_quarters %>% dplyr::filter(V1014 == p)
        
        message(paste("Running", param$panel, "identification on panel", p, "\n"))
        df <- dat %>%
          build_pnadc_panel(panel = param$panel)
        
        return(df)
      }
    )
    
    # save panel files
    
    if (param$rds) {
      # RDS: write one flat file per panel
      purrr::map2(
        identified_panels, panel_list,
        function(df, p) {
          path <- file.path(param$save_to, paste0("Panel_", p, ".rds"))
          message(paste("Saving panel to", path, "\n"))
          saveRDS(df, path)
        }
      )
    } else {
      # Parquet: bind all panels and write a partitioned dataset grouped by V1014
      all_panels <- purrr::list_rbind(identified_panels)
      panels_dir <- file.path(param$save_to, "pnadc_panels")
      message(paste(
        "Saving partitioned panel parquet dataset to", panels_dir, "\n"
      ))
      all_panels %>%
        dplyr::group_by(V1014) %>%
        arrow::write_dataset(
          path = panels_dir,
          format = "parquet"
        )
    }
  }
  
  ####################
  ## Returning Data ##
  ####################
  
  return(paste("Panel files saved to", param$save_to))
}

######################
## Data Engineering ##
######################

# define a data cleaning function which is run for each quarter separately

treat_pnadc <- function(df) {
  # binding globals
  UF <- regiao <- V2007 <- VD3004 <- VD4019 <- Habitual <- VD4002 <- V4012 <- NULL
  VD4001 <- V2009 <- ocupado <- desocupado <- forca_trab <- VD4005 <- VD4009 <- NULL
  VD4012 <- V4022 <- V4013 <- cnae_2dig <- V4010 <- cod_2dig <- NULL
  V3002 <- V4074 <- V4074A <- fora_forca_trab <- NULL
  
  # regions
  
  if ("UF" %in% names(df)) {
    df <- df %>%
      dplyr::mutate(
        regiao = substr(UF, 1, 1),
        regiao = dplyr::case_match(
          regiao,
          "1" ~ "Norte",
          "2" ~ "Nordeste",
          "3" ~ "Sudeste",
          "4" ~ "Sul",
          "5" ~ "Centro-Oeste"
        )
      )
    
    # states (depend on UF as well)
    df <- df %>%
      dplyr::mutate(
        sigla_uf = dplyr::case_match(
          UF,
          11 ~ "RO",
          12 ~ "AC",
          13 ~ "AM",
          14 ~ "RR",
          15 ~ "PA",
          16 ~ "AP",
          17 ~ "TO",
          21 ~ "MA",
          22 ~ "PI",
          23 ~ "CE",
          24 ~ "RN",
          25 ~ "PB",
          26 ~ "PE",
          27 ~ "AL",
          28 ~ "SE",
          29 ~ "BA",
          31 ~ "MG",
          32 ~ "ES",
          33 ~ "RJ",
          35 ~ "SP",
          41 ~ "PR",
          42 ~ "SC",
          43 ~ "RS",
          50 ~ "MS",
          51 ~ "MT",
          52 ~ "GO",
          53 ~ "DF"
        )
      )
  }
  
  # sex
  
  if ("V2007" %in% names(df)) {
    df <- df %>%
      dplyr::mutate(
        sexo = dplyr::case_match(
          V2007,
          1 ~ "Homem",
          2 ~ "Mulher"
        )
      )
  }
  
  # age groups
  
  if ("V2009" %in% names(df)) {
    df <- df %>%
      dplyr::mutate(
        faixa_idade = dplyr::case_when(
          V2009 >= 14 & V2009 <= 17 ~ "Entre 14 e 17 anos",
          V2009 >= 18 & V2009 <= 24 ~ "Entre 18 e 24 anos",
          V2009 >= 25 & V2009 <= 29 ~ "Entre 25 e 29 anos",
          V2009 >= 30 & V2009 <= 39 ~ "Entre 30 e 39 anos",
          V2009 >= 40 & V2009 <= 49 ~ "Entre 40 e 49 anos",
          V2009 >= 50 & V2009 <= 59 ~ "Entre 50 e 59 anos",
          V2009 >= 60 ~ "60 anos ou mais"
        )
      )
  }
  
  # education levels
  
  if ("VD3004" %in% names(df)) {
    df <- df %>%
      dplyr::mutate(
        faixa_educ = dplyr::case_match(
          VD3004,
          1 ~ "Sem instru\u00e7\u00e3o",
          2 ~ "1 a 7 anos de estudo",
          3 ~ "8 a 11 anos de estudo",
          4:6 ~ "9 a 14 anos de estudo",
          7 ~ "15 ou mais anos de estudo"
        )
      )
  }
  
  # Labor Market definitions taken from:
  # https://github.com/datazoompuc/datazoom_labour_amazon/blob/main/Labour_Market/code/_definicoes_pnadcontinua_trimestral.do
  
  # habitual income from all occupations
  
  if (all(c("VD4019", "Habitual") %in% names(df))) {
    df <- df %>%
      dplyr::mutate(
        rendimento_habitual = VD4019,
        rendimento_habitual_real = VD4019 * Habitual
      )
  }
  
  # occupied status
  
  if ("VD4002" %in% names(df)) {
    df <- df %>%
      dplyr::mutate(
        ocupado = ifelse(VD4002 == 1, 1, 0),
        desocupado = ifelse(VD4002 == 2, 1, 0)
      )
  }
  
  # formal vs. informal
  # depends on derived columns ocupado/desocupado, so guard on both source and derived
  
  if (all(c("ocupado", "VD4009", "VD4012") %in% names(df))) {
    df <- df %>%
      dplyr::mutate(
        formal = dplyr::case_when(
          ocupado == 1 & VD4009 %in% c(1, 3, 5, 7) ~ 1,
          ocupado == 1 & VD4009 == 9 & VD4012 == 1 ~ 1,
          .default = 0
        ),
        informal = dplyr::case_when(
          ocupado == 1 & VD4009 %in% c(2, 4, 6, 10) ~ 1,
          ocupado == 1 & VD4009 == 9 & VD4012 == 2 ~ 1,
          .default = 0
        )
      )
  }
  
  # public or private sector
  
  if ("V4012" %in% names(df)) {
    df <- df %>%
      dplyr::mutate(
        publico = ifelse(V4012 %in% c(2, 4), 1, 0),
        privado = ifelse(V4012 %in% c(1, 3, 5, 6, 7), 1, 0)
      )
  }
  
  # labor force
  
  if ("VD4001" %in% names(df)) {
    df <- df %>%
      dplyr::mutate(
        fora_forca_trab = ifelse(VD4001 == 2, 1, 0),
        forca_trab = ifelse(VD4001 == 1, 1, 0)
      )
  }
  
  # active population
  
  if (all(c("V2009", "ocupado", "desocupado") %in% names(df))) {
    df <- df %>%
      dplyr::mutate(
        pia = ifelse(V2009 >= 14, 1, 0),
        idade_de_trabalhar = ifelse(V2009 >= 15 & V2009 <= 64, 1, 0),
        pea = ocupado + desocupado
      )
  }
  
  # unemployed
  
  if (all(c("forca_trab", "desocupado") %in% names(df))) {
    df <- df %>%
      dplyr::mutate(
        desempregado = forca_trab * desocupado
      )
  }
  
  if ("VD4005" %in% names(df)) {
    df <- df %>%
      dplyr::mutate(
        desalentado = ifelse(VD4005 == 1, 1, 0)
      )
  }
  
  # neet
  
  if (all(c("desocupado", "forca_trab", "fora_forca_trab", "V3002") %in% names(df))) {
    df <- df %>%
      dplyr::mutate(
        nem_nem = dplyr::case_when(
          desocupado == 1 & forca_trab == 1 & V3002 == 2 &
            (!"V4074"  %in% names(df) | V4074  != 6  | is.na(V4074)) &
            (!"V4074A" %in% names(df) | V4074A != 8  | is.na(V4074A)) ~ 1,
          fora_forca_trab == 1 & V3002 == 2 &
            (!"V4074"  %in% names(df) | V4074  != 6  | is.na(V4074)) &
            (!"V4074A" %in% names(df) | V4074A != 8  | is.na(V4074A)) ~ 1,
          .default = 0
        )
      )
  }
  
  # positions in occupation
  
  if (all(c("VD4009", "VD4012", "V4022") %in% names(df))) {
    df <- df %>%
      dplyr::mutate(
        empregado_sc = ifelse(VD4009 %in% c(2, 4, 6, 10), 1, 0),
        empregado_cc = ifelse(VD4009 %in% c(1, 3, 5), 1, 0),
        conta_propria = ifelse(VD4009 == 9, 1, 0),
        conta_propria_contrib = ifelse(VD4009 == 9 & VD4012 == 1, 1, 0),
        conta_propria_nao_contrib = ifelse(VD4009 == 9 & VD4012 == 2, 1, 0),
        empregador = ifelse(VD4009 == 8, 1, 0),
        militar_estatutario = ifelse(VD4009 == 7, 1, 0),
        home_office = ifelse(V4022 %in% c(4, 5), 1, 0)
      )
  }
  
  # translating sector codes
  
  if ("V4013" %in% names(df)) {
    df <- df %>%
      dplyr::mutate(
        cnae_2dig = substr(V4013, 1, 2),
        cnae_2dig = dplyr::case_match(
          cnae_2dig,
          "00" ~ "Outros",
          "01" ~ "Agricultura",
          "02" ~ "Extra\u00e7\u00e3o florestal",
          "03" ~ "Pesca, ca\u00e7a e aquicultura",
          "05" ~ "Extra\u00e7\u00e3o mineral e de carv\u00e3o, petr\u00f3leo e g\u00e1s",
          "06" ~ "Extra\u00e7\u00e3o mineral e de carv\u00e3o, petr\u00f3leo e g\u00e1s",
          "07" ~ "Extra\u00e7\u00e3o mineral e de carv\u00e3o, petr\u00f3leo e g\u00e1s",
          "08" ~ "Extra\u00e7\u00e3o mineral e de carv\u00e3o, petr\u00f3leo e g\u00e1s",
          "09" ~ "Extra\u00e7\u00e3o mineral e de carv\u00e3o, petr\u00f3leo e g\u00e1s",
          "10" ~ "Alimentos, bebidas e fumo",
          "11" ~ "Alimentos, bebidas e fumo",
          "12" ~ "Pecu\u00e1ria e cria\u00e7\u00e3o de animais",
          "13" ~ "T\u00eaxtil, vestu\u00e1rio, couro e cal\u00e7ados",
          "14" ~ "Pecu\u00e1ria e cria\u00e7\u00e3o de animais",
          "15" ~ "Pesca, ca\u00e7a e aquicultura",
          "16" ~ "Madeira, celulose e papel",
          "17" ~ "Madeira, celulose e papel",
          "18" ~ "Madeira, celulose e papel",
          "19" ~ "Qu\u00edmicos, farmac\u00eauticos, borracha e pl\u00e1stico",
          "20" ~ "Qu\u00edmicos, farmac\u00eauticos, borracha e pl\u00e1stico",
          "21" ~ "Qu\u00edmicos, farmac\u00eauticos, borracha e pl\u00e1stico",
          "22" ~ "Qu\u00edmicos, farmac\u00eauticos, borracha e pl\u00e1stico",
          "23" ~ "Produtos de metal, minerais n\u00e3o-met\u00e1licos e metalurgia",
          "24" ~ "Produtos de metal, minerais n\u00e3o-met\u00e1licos e metalurgia",
          "25" ~ "Produtos de metal, minerais n\u00e3o-met\u00e1licos e metalurgia",
          "26" ~ "Servi\u00e7os jur\u00eddicos",
          "27" ~ "Eletr\u00f4nicos, m\u00e1quinas e equipamentos",
          "28" ~ "Eletr\u00f4nicos, m\u00e1quinas e equipamentos",
          "29" ~ "Autom\u00f3veis e equipamentos de transporte",
          "30" ~ "Autom\u00f3veis e equipamentos de transporte",
          "31" ~ "M\u00f3veis",
          "32" ~ "Outros",
          "33" ~ "Eletr\u00f4nicos, m\u00e1quinas e equipamentos",
          "34" ~ "Servi\u00e7os jur\u00eddicos",
          "35" ~ "Eletr\u00f4nicos, m\u00e1quinas e equipamentos",
          "36" ~ "Eletr\u00f4nicos, m\u00e1quinas e equipamentos",
          "37" ~ "Eletr\u00f4nicos, m\u00e1quinas e equipamentos",
          "38" ~ "Eletr\u00f4nicos, m\u00e1quinas e equipamentos",
          "39" ~ "Eletr\u00f4nicos, m\u00e1quinas e equipamentos",
          "41" ~ "Constru\u00e7\u00e3o",
          "42" ~ "Constru\u00e7\u00e3o",
          "43" ~ "Constru\u00e7\u00e3o",
          "45" ~ "Com\u00e9rcio",
          "48" ~ "Com\u00e9rcio",
          "49" ~ "Transporte e correio",
          "50" ~ "Transporte e correio",
          "51" ~ "Transporte e correio",
          "52" ~ "Transporte e correio",
          "53" ~ "Transporte e correio",
          "55" ~ "Estadia e turismo",
          "56" ~ "Servi\u00e7os de alimenta\u00e7\u00e3o",
          "58" ~ "Servi\u00e7os de informa\u00e7\u00e3o e comunica\u00e7\u00e3o",
          "59" ~ "Servi\u00e7os de informa\u00e7\u00e3o e comunica\u00e7\u00e3o",
          "60" ~ "Servi\u00e7os de informa\u00e7\u00e3o e comunica\u00e7\u00e3o",
          "61" ~ "Servi\u00e7os de informa\u00e7\u00e3o e comunica\u00e7\u00e3o",
          "62" ~ "Servi\u00e7os de informa\u00e7\u00e3o e comunica\u00e7\u00e3o",
          "63" ~ "Servi\u00e7os de informa\u00e7\u00e3o e comunica\u00e7\u00e3o",
          "64" ~ "Servi\u00e7os financeiros e de seguros",
          "65" ~ "Servi\u00e7os financeiros e de seguros",
          "66" ~ "Servi\u00e7os financeiros e de seguros",
          "68" ~ "Atividades profissionais, cient\u00edficas e t\u00e9cnicas",
          "69" ~ "Atividades profissionais, cient\u00edficas e t\u00e9cnicas",
          "70" ~ "Atividades profissionais, cient\u00edficas e t\u00e9cnicas",
          "71" ~ "Atividades profissionais, cient\u00edficas e t\u00e9cnicas",
          "72" ~ "Atividades profissionais, cient\u00edficas e t\u00e9cnicas",
          "73" ~ "Atividades profissionais, cient\u00edficas e t\u00e9cnicas",
          "74" ~ "Atividades profissionais, cient\u00edficas e t\u00e9cnicas",
          "75" ~ "Atividades profissionais, cient\u00edficas e t\u00e9cnicas",
          "78" ~ "Terceiriza\u00e7\u00e3o de m\u00e3o-de-obra",
          "79" ~ "Estadia e turismo",
          "80" ~ "Seguran\u00e7a e edif\u00edcios",
          "81" ~ "Seguran\u00e7a e edif\u00edcios",
          "82" ~ "Seguran\u00e7a e edif\u00edcios",
          "84" ~ "Administra\u00e7\u00e3o p\u00fablica, defesa e seguridade social",
          "85" ~ "Educa\u00e7\u00e3o",
          "86" ~ "Sa\u00fade e assist\u00eancia social",
          "87" ~ "Sa\u00fade e assist\u00eancia social",
          "88" ~ "Sa\u00fade e assist\u00eancia social",
          "90" ~ "Artes, cultura, esportes e recrea\u00e7\u00e3o",
          "91" ~ "Artes, cultura, esportes e recrea\u00e7\u00e3o",
          "92" ~ "Artes, cultura, esportes e recrea\u00e7\u00e3o",
          "93" ~ "Artes, cultura, esportes e recrea\u00e7\u00e3o",
          "94" ~ "Organiza\u00e7\u00f5es religiosas, sindicais e patronais",
          "95" ~ "Servi\u00e7os de informa\u00e7\u00e3o e comunica\u00e7\u00e3o",
          "96" ~ "Servi\u00e7os pessoais (cabelereiros, lavanderias, etc.)",
          "97" ~ "Servi\u00e7os dom\u00e9sticos",
          "99" ~ "Outros"
        ),
        cnae_2dig = dplyr::case_match(
          V4013,
          as.numeric(c(paste0(0, 1201:1209), paste0(0, 1402:1409), "01999")) ~ "Pecu\u00e1ria e cria\u00e7\u00e3o de animais",
          .default = cnae_2dig
        )
      )
  }
  
  # translating occupation codes
  
  if ("V4010" %in% names(df)) {
    df <- df %>%
      dplyr::mutate(
        cod_2dig = substr(V4010, 1, 2),
        cod_2dig = dplyr::case_match(
          cod_2dig,
          "01" ~ "Policiais, bombeiros e for\u00e7as armadas",
          "02" ~ "Policiais, bombeiros e for\u00e7as armadas",
          "04" ~ "Policiais, bombeiros e for\u00e7as armadas",
          "05" ~ "Policiais, bombeiros e for\u00e7as armadas",
          "11" ~ "Trabalhadores no governo",
          "12" ~ "Dirigentes e gerentes",
          "13" ~ "Dirigentes e gerentes",
          "14" ~ "Dirigentes e gerentes",
          "21" ~ "Cientistas e engenheiros",
          "22" ~ "Profissionais da sa\u00fade",
          "23" ~ "Profissionais do ensino",
          "24" ~ "Administradores e especialista em gest\u00e3o",
          "25" ~ "Servi\u00e7os de TI e comunica\u00e7\u00e3o",
          "26" ~ "Servi\u00e7os jur\u00eddicos",
          "31" ~ "Cientistas e engenheiros",
          "32" ~ "Profissionais da sa\u00fade",
          "33" ~ "Servi\u00e7os financeiros e administrativos",
          "34" ~ "Servi\u00e7os jur\u00eddicos",
          "35" ~ "Servi\u00e7os de TI e comunica\u00e7\u00e3o",
          "41" ~ "Escritur\u00e1rios",
          "42" ~ "Atendimento direto ao p\u00fablico",
          "43" ~ "Apoio administrativo",
          "44" ~ "Apoio administrativo",
          "51" ~ "Servi\u00e7os e cuidados pessoais",
          "52" ~ "Vendedores",
          "53" ~ "Servi\u00e7os e cuidados pessoais",
          "54" ~ "Profissionais de seguran\u00e7a",
          "61" ~ "Pecuaristas e criadores de animais",
          "62" ~ "Pecuaristas e criadores de animais",
          "71" ~ "Oper\u00e1rios da constru\u00e7\u00e3o, metalurgia e ind\u00fastria",
          "72" ~ "Oper\u00e1rios da constru\u00e7\u00e3o, metalurgia e ind\u00fastria",
          "73" ~ "Artes\u00f5es e artes gr\u00e1ficas",
          "74" ~ "T\u00e9cnicos de eletricidade e eletr\u00f4nica",
          "75" ~ "Oper\u00e1rios de processamento e instala\u00e7\u00f5es",
          "81" ~ "Oper\u00e1rios de processamento e instala\u00e7\u00f5es",
          "82" ~ "Montadores e condutores de ve\u00edculos",
          "83" ~ "Montadores e condutores de ve\u00edculos",
          "91" ~ "Dom\u00e9sticos",
          "92" ~ "Pecuaristas e criadores de animais",
          "93" ~ "Oper\u00e1rios da constru\u00e7\u00e3o, metalurgia e ind\u00fastria",
          "94" ~ "Profissionais em alimenta\u00e7\u00e3o",
          "95" ~ "Ambulantes",
          "96" ~ "Coletores de lixo"
        ),
        cod_2dig = ifelse(V4010 == 9215, "Extrativistas florestais", cod_2dig)
      )
  }
  
  return(df)
}
