Un modèle est une classe Python qui représente les enregistrements d'une table.

app/models/role.py

from app import db
 
class Role(db.Model):
    __tablename__ = 'roles'
    id   = db.Column(db.Integer,    primary_key=True)
    name = db.Column(db.String(64), unique=True)
 
    def __repr__(self):
        return '<Role %r>' % self.name

app/models/user.py

from app import db
 
class User(db.Model):
    __tablename__ = 'users'
    id       = db.Column(db.Integer,     primary_key=True)
    username = db.Column(db.String(64),  unique=True, index=True)
    email    = db.Column(db.String(200), unique=True)
 
    def __repr__(self):
        return '<User %r>' % self.username
 
    def hello(self):
        print("Hello, my name is %s." % self.name)

Pour un champ de type LONGTEXT sous MySQL/MariaDB :

...
from sqlalchemy.dialects.mysql import LONGTEXT
 
...
 
class Article(db.Model):
    ....
    contenu = db.Column(LONGTEXT)
    ...

Une clé primaire est obligatoire pour chaque table, elle est généralement appelée id.

import datetime
 
class Exemple(db.Model):
    ...
    # Entiers
    id = db.Column(db.Integer, primary_key=True)
    n  = db.Column(db.Integer)
    ...
    # Décimaux
    f1 = db.Column(db.Float, precision=2)
    f2 = db.Column(db.Numeric, precision=2)
    ...
    # Chaînes
    s  = db.Column(db.String(100))
    t  = db.Column(db.Text)
    ...
    # Date et heures
    d1 = db.Column(db.Date, default=datetime.date.today)
    d2 = db.Column(db.DateTime, default=datetime.datetime.now)
    ...

One Role ⇔ Many Users :

class Role(db.Model):
    __tablename__ = 'roles'
    id    = db.Column(db.Integer, primary_key=True)
    name  = db.Column(db.String(200))
    # ...
    users = db.relationship('User', backref='role')
 
class User(db.Model):
    __tablename__ = 'users'
    id    = db.Column(db.Integer, primary_key=True)
    name  = db.Column(db.String(200))
    # ...
    role_id = db.Column(db.Integer, db.ForeignKey('roles.id'))

• Dans le modèle User : roles.id identifie la colonne id de la table roles comme

“clé étrangère” dans la relation.

• Dans le modèle Role : backref ajoute un attribut role au modèle User.

>>> r = Role(nom='Manager')
>>> u = User(nom='Marc', role=r)
 
>>> u.nom
'Marc'
 
>>> u.role.nom
'Manager'

Voir https://stackoverflow.com/questions/19598578/how-do-primaryjoin-and-secondaryjoin-work-for-many-to-many-relationship-in-s

Après avoir créé/modifié les modèles, il faut appliquer les changements dans la base de données (ajout de tables, création de champs, etc.)

Ne rien faire manuellement, mais utiliser les Migrations.