adhit-r/fairmind

Risk taxonomy data model

Aberta

#157 aberto em 22 de mar. de 2026

Ver no GitHubGuia do colaborador
 (1 comentário) (0 reação) (0 responsável)Python (12 forks)auto 404
ai/mlenhancementgood first issue

Métricas do repositório

Stars
 (9 estrelas)
Métricas de merge de PR
 (Mesclagem média 2d 6h) (3 fundiu PRs em 30d)

Description

Parent Issue

Part of #149 — AI Risk: IBM/MIT Risk Template Integration

Description

Define the risk category schema based on IBM AI Risk Atlas and MIT AI Risk Repository. Create database models for risk categories, risk factors, and assessment templates.

Requirements

  • Risk category schema covering: fairness, explainability, robustness, privacy, security, accountability, hallucination
  • Risk factors per category (sub-dimensions)
  • Assessment template model — stores questionnaire structure per taxonomy
  • Schema must be framework-agnostic so new taxonomies (OECD, custom) can be added without a redesign
  • Follow existing SQLAlchemy model patterns in apps/backend/src/infrastructure/db/database/models.py

Deliverables

  • Database models for risk categories and risk factors
  • Assessment template model
  • Alembic migration
  • Seed data for initial IBM/MIT taxonomy
  • Basic Pydantic schemas for the new models

Getting Started

  1. Read apps/backend/src/infrastructure/db/database/models.py to understand existing model patterns
  2. Read apps/backend/src/domain/compliance/ for how compliance models are structured — risk assessment should follow similar patterns
  3. Create models, migration, and seed data
  4. Open a PR against main and link this issue

Guia do colaborador

Direção de pesquisa
Examine os padrões de modelo SQLAlchemy existentes em apps/backend/src/infrastructure/db/database/models.py e a estrutura de domínio de conformidade em apps/backend/src/domain/compliance/ para entender as convenções. Em seguida, crie novos modelos para categorias de risco, fatores de risco e modelos de avaliação seguindo esses padrões.
Pilha de tecnologia
python
Domain
backenddatabase
Tipo Issue
Funcionalidade
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
3
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-2 dias
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
PythonSQLAlchemyAlembicPydantic
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
60