feat: sprint 1 — auth + CRUD engagements
Ship the first feature end-to-end on the UI: users log in with JWT,
admins manage user accounts, and any authenticated user (per RBAC)
can create, list, view, edit, and delete engagements.
Backend (Flask + SQLAlchemy + SQLite, 63 pytest)
- User / Engagement models, Alembic 0001 initial schema
- argon2 password hashing, JWT bearer (60-min TTL), @login_required
and @role_required decorators
- 13 API endpoints under /api/*, including last-admin protection on
DELETE/PATCH user and JSON 404 on unknown /api/* paths
- `flask create-admin` CLI with duplicate / short-password handling
Frontend (React + Vite + Tailwind + TanStack Query, 20 vitest)
- Inter font bundled locally (no CDN), DESIGN.md tokens in Tailwind
- LoginPage / EngagementsList / EngagementForm / EngagementDetail /
UsersAdmin pages with role-aware UI
- Layout, ProtectedRoute, StatusBadge, FormField, LoadingState,
ErrorState, EmptyState, Toast + provider
- Axios client: Bearer interceptor, 401 → purge + /login + "Session
expirée" toast, 403 → "Accès refusé" toast (declarative <Navigate>
for already-authed users, Fragment-keyed admin user rows)
Deployment
- Single multistage Dockerfile (node:20-alpine → python:3.12-slim)
- docker/entrypoint.sh runs `flask db upgrade` before `flask run`
- Makefile: build/start/stop/restart/update/logs/create-admin/
update-mitre/test-{backend,frontend,e2e}/clean
- .env.example documenting MIMIC_JWT_SECRET / MIMIC_DB_PATH / MIMIC_PORT
- SQLite at /data/mimic.sqlite on named volume mimic-data
Acceptance suite (Playwright, 36 tests, all 27 ACs)
- e2e/ scaffold with playwright.config + auth/api fixtures
- One spec per user story (us1-bootstrap through us6-deployment)
- Portable via MIMIC_CONTAINER_CMD / MIMIC_BASE_URL (docker or podman)
Docs
- README.md with quick-start and architecture overview
- CHANGELOG.md updated with Sprint 1 deliverables
- pyrightconfig.json so the Python LSP sees backend/.venv and
resolves the `backend.app.*` absolute imports
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-26 09:37:53 +02:00
|
|
|
"""Flask application factory."""
|
|
|
|
|
from __future__ import annotations
|
|
|
|
|
|
|
|
|
|
import os
|
|
|
|
|
from pathlib import Path
|
|
|
|
|
|
|
|
|
|
from flask import Flask, jsonify, send_from_directory
|
|
|
|
|
|
2026-05-26 10:59:14 +02:00
|
|
|
from backend.app.api import auth_bp, engagements_bp, simulations_bp, users_bp
|
feat: sprint 1 — auth + CRUD engagements
Ship the first feature end-to-end on the UI: users log in with JWT,
admins manage user accounts, and any authenticated user (per RBAC)
can create, list, view, edit, and delete engagements.
Backend (Flask + SQLAlchemy + SQLite, 63 pytest)
- User / Engagement models, Alembic 0001 initial schema
- argon2 password hashing, JWT bearer (60-min TTL), @login_required
and @role_required decorators
- 13 API endpoints under /api/*, including last-admin protection on
DELETE/PATCH user and JSON 404 on unknown /api/* paths
- `flask create-admin` CLI with duplicate / short-password handling
Frontend (React + Vite + Tailwind + TanStack Query, 20 vitest)
- Inter font bundled locally (no CDN), DESIGN.md tokens in Tailwind
- LoginPage / EngagementsList / EngagementForm / EngagementDetail /
UsersAdmin pages with role-aware UI
- Layout, ProtectedRoute, StatusBadge, FormField, LoadingState,
ErrorState, EmptyState, Toast + provider
- Axios client: Bearer interceptor, 401 → purge + /login + "Session
expirée" toast, 403 → "Accès refusé" toast (declarative <Navigate>
for already-authed users, Fragment-keyed admin user rows)
Deployment
- Single multistage Dockerfile (node:20-alpine → python:3.12-slim)
- docker/entrypoint.sh runs `flask db upgrade` before `flask run`
- Makefile: build/start/stop/restart/update/logs/create-admin/
update-mitre/test-{backend,frontend,e2e}/clean
- .env.example documenting MIMIC_JWT_SECRET / MIMIC_DB_PATH / MIMIC_PORT
- SQLite at /data/mimic.sqlite on named volume mimic-data
Acceptance suite (Playwright, 36 tests, all 27 ACs)
- e2e/ scaffold with playwright.config + auth/api fixtures
- One spec per user story (us1-bootstrap through us6-deployment)
- Portable via MIMIC_CONTAINER_CMD / MIMIC_BASE_URL (docker or podman)
Docs
- README.md with quick-start and architecture overview
- CHANGELOG.md updated with Sprint 1 deliverables
- pyrightconfig.json so the Python LSP sees backend/.venv and
resolves the `backend.app.*` absolute imports
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-26 09:37:53 +02:00
|
|
|
from backend.app.cli import register_cli
|
|
|
|
|
from backend.app.config import Config, TestConfig
|
|
|
|
|
from backend.app.errors import register_error_handlers
|
|
|
|
|
from backend.app.extensions import db, migrate
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
def create_app(config_object: object | None = None) -> Flask:
|
|
|
|
|
"""Application factory.
|
|
|
|
|
|
|
|
|
|
`config_object` is an *instance* (not a class) of Config or a subclass.
|
|
|
|
|
If None, picks TestConfig when MIMIC_TESTING=1, otherwise Config.
|
|
|
|
|
"""
|
|
|
|
|
static_folder = str(Path(__file__).parent / "static")
|
|
|
|
|
app = Flask(__name__, static_folder=static_folder, static_url_path="/static")
|
|
|
|
|
|
|
|
|
|
if config_object is None:
|
|
|
|
|
config_object = TestConfig() if os.environ.get("MIMIC_TESTING") == "1" else Config()
|
|
|
|
|
app.config.from_object(config_object)
|
|
|
|
|
|
|
|
|
|
db.init_app(app)
|
|
|
|
|
migrations_dir = str(Path(__file__).parent.parent / "migrations")
|
|
|
|
|
migrate.init_app(app, db, directory=migrations_dir)
|
|
|
|
|
|
|
|
|
|
# Ensure models are imported so Alembic/metadata see them.
|
|
|
|
|
from backend.app import models # noqa: F401
|
|
|
|
|
|
|
|
|
|
app.register_blueprint(auth_bp)
|
|
|
|
|
app.register_blueprint(users_bp)
|
|
|
|
|
app.register_blueprint(engagements_bp)
|
2026-05-26 10:59:14 +02:00
|
|
|
app.register_blueprint(simulations_bp)
|
|
|
|
|
|
|
|
|
|
from backend.app.services import mitre as mitre_svc
|
|
|
|
|
mitre_svc.load_bundle()
|
feat: sprint 1 — auth + CRUD engagements
Ship the first feature end-to-end on the UI: users log in with JWT,
admins manage user accounts, and any authenticated user (per RBAC)
can create, list, view, edit, and delete engagements.
Backend (Flask + SQLAlchemy + SQLite, 63 pytest)
- User / Engagement models, Alembic 0001 initial schema
- argon2 password hashing, JWT bearer (60-min TTL), @login_required
and @role_required decorators
- 13 API endpoints under /api/*, including last-admin protection on
DELETE/PATCH user and JSON 404 on unknown /api/* paths
- `flask create-admin` CLI with duplicate / short-password handling
Frontend (React + Vite + Tailwind + TanStack Query, 20 vitest)
- Inter font bundled locally (no CDN), DESIGN.md tokens in Tailwind
- LoginPage / EngagementsList / EngagementForm / EngagementDetail /
UsersAdmin pages with role-aware UI
- Layout, ProtectedRoute, StatusBadge, FormField, LoadingState,
ErrorState, EmptyState, Toast + provider
- Axios client: Bearer interceptor, 401 → purge + /login + "Session
expirée" toast, 403 → "Accès refusé" toast (declarative <Navigate>
for already-authed users, Fragment-keyed admin user rows)
Deployment
- Single multistage Dockerfile (node:20-alpine → python:3.12-slim)
- docker/entrypoint.sh runs `flask db upgrade` before `flask run`
- Makefile: build/start/stop/restart/update/logs/create-admin/
update-mitre/test-{backend,frontend,e2e}/clean
- .env.example documenting MIMIC_JWT_SECRET / MIMIC_DB_PATH / MIMIC_PORT
- SQLite at /data/mimic.sqlite on named volume mimic-data
Acceptance suite (Playwright, 36 tests, all 27 ACs)
- e2e/ scaffold with playwright.config + auth/api fixtures
- One spec per user story (us1-bootstrap through us6-deployment)
- Portable via MIMIC_CONTAINER_CMD / MIMIC_BASE_URL (docker or podman)
Docs
- README.md with quick-start and architecture overview
- CHANGELOG.md updated with Sprint 1 deliverables
- pyrightconfig.json so the Python LSP sees backend/.venv and
resolves the `backend.app.*` absolute imports
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-26 09:37:53 +02:00
|
|
|
|
|
|
|
|
register_error_handlers(app)
|
|
|
|
|
register_cli(app)
|
|
|
|
|
|
|
|
|
|
static_root = Path(static_folder)
|
|
|
|
|
|
|
|
|
|
@app.get("/api/health")
|
|
|
|
|
def health():
|
|
|
|
|
return {"status": "ok"}, 200
|
|
|
|
|
|
|
|
|
|
# Serve the built frontend (Vite output copied into app/static at image build time).
|
|
|
|
|
@app.get("/")
|
|
|
|
|
def index():
|
|
|
|
|
index_path = static_root / "index.html"
|
|
|
|
|
if index_path.exists():
|
|
|
|
|
return send_from_directory(static_folder, "index.html")
|
|
|
|
|
return {"status": "ok", "message": "Mimic API running. Frontend not built."}, 200
|
|
|
|
|
|
|
|
|
|
@app.get("/<path:path>")
|
|
|
|
|
def spa_fallback(path: str):
|
|
|
|
|
# Unknown /api/* paths must stay JSON 404 — never shadowed by index.html.
|
|
|
|
|
if path.startswith("api/"):
|
|
|
|
|
return jsonify({"error": "Not found"}), 404
|
|
|
|
|
# Serve static assets if present; otherwise hand back index.html for client routing.
|
|
|
|
|
candidate = static_root / path
|
|
|
|
|
if candidate.is_file():
|
|
|
|
|
return send_from_directory(static_folder, path)
|
|
|
|
|
index_path = static_root / "index.html"
|
|
|
|
|
if index_path.exists():
|
|
|
|
|
return send_from_directory(static_folder, "index.html")
|
|
|
|
|
return jsonify({"error": "Not found"}), 404
|
|
|
|
|
|
|
|
|
|
return app
|