langgenius/dify

[Chore/Refactor] Native Support for Dataclasses Mapped as ORM Models

Open

#23,579 opened on Aug 7, 2025

View on GitHub
 (12 comments) (2 reactions) (2 assignees)TypeScript (141,412 stars) (22,210 forks)batch import
good first issue💪 enhancement

Description

Self Checks

  • I have read the Contributing Guide and Language Policy.
  • This is only for refactoring, if you would like to ask a question, please head to Discussions.
  • I have searched for existing issues search for existing issues, including closed ones.
  • I confirm that I am using English to submit this report, otherwise it will be closed.
  • 【中文用户 & Non English User】请使用英语提交，否则会被关闭 ：）
  • Please do not modify this template :) and fill in all the required fields.

Description

continue of https://github.com/langgenius/dify/issues/22652

Motivation

https://docs.sqlalchemy.org/en/20/changelog/whatsnew_20.html#native-support-for-dataclasses-mapped-as-orm-models

Additional Context

example #24999

Contributor guide

Tech stack
pythonsql
Domain
backenddatabase
Issue type
refactor
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
3
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
half day
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
mostly clear
Prerequisites
Python dataclassesSQLAlchemy ORM
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
40
Research direction
Review the linked discussions #22652 and #24999 for context. Examine the current ORM model definitions in the codebase (likely in backend Python files) and identify where SQLAlchemy's native dataclass support can replace existing mappings. Consult SQLAlchemy 2.0 documentation on ORM mapped dataclasses. Ensure backward compatibility and test coverage.