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>
51 lines
1.1 KiB
Makefile
51 lines
1.1 KiB
Makefile
PORT ?= 5000
|
|
IMAGE ?= mimic:latest
|
|
CONTAINER ?= mimic
|
|
VOLUME ?= mimic-data
|
|
|
|
.PHONY: build start stop restart update logs create-admin update-mitre test-backend test-frontend test-e2e clean
|
|
|
|
build:
|
|
docker build -f docker/Dockerfile -t $(IMAGE) .
|
|
|
|
start:
|
|
docker run -d --name $(CONTAINER) -p $(PORT):5000 -v $(VOLUME):/data --env-file .env $(IMAGE)
|
|
|
|
stop:
|
|
docker stop $(CONTAINER) && docker rm $(CONTAINER)
|
|
|
|
restart:
|
|
$(MAKE) stop && $(MAKE) start
|
|
|
|
update:
|
|
git pull && $(MAKE) build && $(MAKE) restart
|
|
|
|
logs:
|
|
docker logs -f $(CONTAINER)
|
|
|
|
create-admin:
|
|
ifndef USER
|
|
$(error USER is required: make create-admin USER=alice PASS=p4ssw0rd)
|
|
endif
|
|
ifndef PASS
|
|
$(error PASS is required: make create-admin USER=alice PASS=p4ssw0rd)
|
|
endif
|
|
docker exec $(CONTAINER) flask create-admin $(USER) $(PASS)
|
|
|
|
update-mitre:
|
|
@echo "MITRE update: Sprint 2+"
|
|
|
|
test-backend:
|
|
docker exec $(CONTAINER) pytest -q backend/tests/
|
|
|
|
test-frontend:
|
|
cd frontend && npm run test -- --run
|
|
|
|
test-e2e:
|
|
cd e2e && npx playwright test
|
|
|
|
clean:
|
|
-docker rm -f $(CONTAINER) 2>/dev/null
|
|
-docker volume rm $(VOLUME) 2>/dev/null
|
|
rm -rf backend/__pycache__ frontend/node_modules frontend/dist
|