Development

enferno/
├── enferno/
│   ├── app.py             # Application factory, blueprint registration
│   ├── settings.py        # Config from .env
│   ├── extensions.py      # db, migrate, cache, mail, session, CSRF, debug toolbar
│   ├── commands.py        # Flask CLI commands
│   ├── agent_mcp.py       # Read-only MCP server for coding agents
│   ├── public/            # "/" and OAuth handlers, no auth
│   ├── portal/            # "/dashboard/", login required
│   ├── user/              # Admin: users, roles, activity log
│   ├── tasks/             # Celery (optional)
│   ├── utils/base.py      # BaseMixin: save() and delete()
│   ├── static/            # Vendored Vue, Vuetify, axios, Tabler icons, app JS and CSS
│   └── templates/         # layout.html, admin pages, auth pages
├── migrations/            # Alembic revisions
├── tests/                 # pytest suite
├── instance/              # SQLite database
├── setup.sh               # Dependencies and .env with generated secrets
├── vendor.sh              # Pinned frontend library downloads
├── run.py                 # Entry point
├── AGENTS.md              # Instructions for coding agents
└── .agents/skills/        # enferno-dev agent skill

from flask import Blueprint, render_template
from flask_security import auth_required

portal = Blueprint("portal", __name__)


@portal.before_request
@auth_required("session")
def before_request():
    pass


@portal.get("/dashboard/")
def dashboard():
    return render_template("dashboard.html")

from enferno.extensions import db
from enferno.utils.base import BaseMixin


class Post(db.Model, BaseMixin):
    __tablename__ = "posts"

    id = db.Column(db.Integer, primary_key=True)
    title = db.Column(db.String(255), nullable=False)
    content = db.Column(db.Text)
    created_at = db.Column(db.DateTime, server_default=db.func.now())

    def to_dict(self):
        return {"id": self.id, "title": self.title, "content": self.content}

    def from_dict(self, data):
        self.title = data.get("title", self.title)
        self.content = data.get("content", self.content)
        return self

uv run flask db migrate -m "add posts"
uv run flask db upgrade

posts = db.session.scalars(db.select(Post).order_by(Post.created_at.desc())).all()
post = db.get_or_404(Post, 1)
page = db.paginate(db.select(Post), page=1, per_page=25)

from flask_security import current_user

from enferno.user.models import Activity

Activity.register(current_user.id, "Post Update", {"old": old, "new": post.to_dict()})

uv sync --extra full

from enferno.tasks import celery


@celery.task
def send_report(user_id):
    ...

uv run celery -A enferno.tasks worker --loglevel=info

uv run ruff check --fix . && uv run ruff format .
uv run pytest

import logging

logging.getLogger("sqlalchemy.engine").setLevel(logging.INFO)