chore(v2): restructure monorepo to src/ layout with uv

Aligns the repo with the python-project-spec-design.md template chosen
for V2.0.0. Big move, no logic changes. The 3 pre-existing test
failures (test_recipes::test_update_recipe, test_recipes::
test_recipe_versioning, test_tasks::test_reorder_tasks, plus the
client test_save_measurement_proxy) survive unchanged.

Layout changes
- server/        -> src/backend/
- server/middleware/ -> src/backend/api/middleware/
- server/routers/    -> src/backend/api/routers/
- server/models/     -> src/backend/models/orm/
- server/schemas/    -> src/backend/models/api/
- server/uploads/    -> uploads/ (project root, mounted volume)
- server/tests/      -> src/backend/tests/
- client/            -> src/frontend/flask_app/ (Flask kept; React
  deroga is documented in CLAUDE.md, justified by tablet UX, USB
  caliper/barcode workflow and Fabric.js integration)

Tooling
- pyproject.toml: monorepo with [project] core deps and
  optional-dependencies server / client / dev. Replaces both
  server/requirements.txt and client/requirements.txt.
- uv.lock + .python-version (3.11) committed for reproducible builds.
- Dockerfile (root, backend) and Dockerfile.frontend rewritten to use
  uv sync --frozen --no-dev --extra server|client; legacy Dockerfiles
  preserved as Dockerfile.legacy for reference but excluded from build
  context via .dockerignore.
- docker-compose.dev.yml + docker-compose.yml: build context now ".",
  dockerfile pointing to the root files.

Code adjustments forced by the move
- Every "from config|database|models|schemas|services|routers|middleware
  import ..." rewritten to its src.backend.* equivalent (50+ files
  including indented inline imports inside test bodies).
- src/backend/migrations/env.py: insert project root into sys.path so
  alembic can resolve src.backend.* imports regardless of cwd.
- src/backend/config.py: env_file ../../.env (was ../.env), upload_path
  resolves project root via parents[2].
- src/backend/tests/conftest.py + tests: import ... from src.backend.*
  instead of bare names; old per-directory pytest.ini files removed in
  favor of root pyproject.toml [tool.pytest.ini_options].
- .gitignore: uploads/ at root, src/frontend/flask_app/static/css/
  tailwind.css path; .dockerignore tightened.
- CLAUDE.md: rewrote sections "Layout del repository", "Comandi di
  Sviluppo", "Database & Migrations", "Test", "i18n", and all path
  references throughout the architecture sections.

Verified
- uv lock resolves 77 packages; uv sync --extra server --extra client
  --extra dev installs cleanly.
- uv run pytest: 171 passed, 4 pre-existing failures.
- uv run alembic -c src/backend/migrations/alembic.ini check loads
  config and metadata (errors only on the absent local MySQL).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
This commit is contained in:
2026-04-25 12:26:47 +02:00
parent 86df67f2e5
commit 1a0431366f
174 changed files with 2568 additions and 308 deletions
+219
View File
@@ -0,0 +1,219 @@
"""Tests for tasks router (/api/recipes/{id}/tasks, /api/tasks, /api/subtasks)."""
import pytest
from httpx import AsyncClient
from sqlalchemy.ext.asyncio import AsyncSession
from src.backend.models.orm.user import User
from src.backend.tests.conftest import auth_headers, create_test_recipe
class TestListTasks:
"""GET /api/recipes/{recipe_id}/tasks tests."""
async def test_list_tasks(
self,
client: AsyncClient,
maker_user: User,
db_session: AsyncSession,
):
"""Authenticated user can list tasks for a recipe."""
recipe = await create_test_recipe(db_session, maker_user.id)
resp = await client.get(
f"/api/recipes/{recipe.id}/tasks",
headers=auth_headers(maker_user),
)
assert resp.status_code == 200
data = resp.json()
assert isinstance(data, list)
assert len(data) >= 1
assert data[0]["title"] == "Test Task"
assert len(data[0]["subtasks"]) >= 1
class TestCreateTask:
"""POST /api/recipes/{recipe_id}/tasks tests."""
async def test_create_task(
self,
client: AsyncClient,
maker_user: User,
db_session: AsyncSession,
):
"""Maker can add a task (triggers copy-on-write new version)."""
recipe = await create_test_recipe(db_session, maker_user.id)
resp = await client.post(
f"/api/recipes/{recipe.id}/tasks",
headers=auth_headers(maker_user),
json={
"title": "New Task",
"directive": "Inspect surface",
"subtasks": [
{
"marker_number": 1,
"description": "Surface roughness",
"nominal": 5.0,
"utl": 5.5,
"ltl": 4.5,
"unit": "um",
}
],
},
)
assert resp.status_code == 201
data = resp.json()
assert data["title"] == "New Task"
assert len(data["subtasks"]) == 1
assert data["subtasks"][0]["description"] == "Surface roughness"
class TestUpdateTask:
"""PUT /api/tasks/{task_id} tests."""
async def test_update_task(
self,
client: AsyncClient,
maker_user: User,
db_session: AsyncSession,
):
"""Maker can update a task on the current version."""
recipe = await create_test_recipe(db_session, maker_user.id)
# Get task list to find the task ID
tasks_resp = await client.get(
f"/api/recipes/{recipe.id}/tasks",
headers=auth_headers(maker_user),
)
task_id = tasks_resp.json()[0]["id"]
resp = await client.put(
f"/api/tasks/{task_id}",
headers=auth_headers(maker_user),
json={"title": "Updated Task Title"},
)
assert resp.status_code == 200
assert resp.json()["title"] == "Updated Task Title"
class TestDeleteTask:
"""DELETE /api/tasks/{task_id} tests."""
async def test_delete_task(
self,
client: AsyncClient,
maker_user: User,
db_session: AsyncSession,
):
"""Maker can delete a task from the current version."""
recipe = await create_test_recipe(db_session, maker_user.id)
tasks_resp = await client.get(
f"/api/recipes/{recipe.id}/tasks",
headers=auth_headers(maker_user),
)
task_id = tasks_resp.json()[0]["id"]
resp = await client.delete(
f"/api/tasks/{task_id}", headers=auth_headers(maker_user)
)
assert resp.status_code == 204
class TestCreateSubtask:
"""POST /api/tasks/{task_id}/subtasks tests."""
async def test_create_subtask(
self,
client: AsyncClient,
maker_user: User,
db_session: AsyncSession,
):
"""Maker can add a subtask to a task."""
recipe = await create_test_recipe(db_session, maker_user.id)
tasks_resp = await client.get(
f"/api/recipes/{recipe.id}/tasks",
headers=auth_headers(maker_user),
)
task_id = tasks_resp.json()[0]["id"]
resp = await client.post(
f"/api/tasks/{task_id}/subtasks",
headers=auth_headers(maker_user),
json={
"marker_number": 2,
"description": "Width measurement",
"nominal": 20.0,
"utl": 20.5,
"ltl": 19.5,
"unit": "mm",
},
)
assert resp.status_code == 201
data = resp.json()
assert data["marker_number"] == 2
assert data["description"] == "Width measurement"
class TestUpdateSubtask:
"""PUT /api/subtasks/{subtask_id} tests."""
async def test_update_subtask(
self,
client: AsyncClient,
maker_user: User,
db_session: AsyncSession,
):
"""Maker can update a subtask."""
recipe = await create_test_recipe(db_session, maker_user.id)
tasks_resp = await client.get(
f"/api/recipes/{recipe.id}/tasks",
headers=auth_headers(maker_user),
)
subtask_id = tasks_resp.json()[0]["subtasks"][0]["id"]
resp = await client.put(
f"/api/subtasks/{subtask_id}",
headers=auth_headers(maker_user),
json={"description": "Updated description", "nominal": 12.0},
)
assert resp.status_code == 200
assert resp.json()["description"] == "Updated description"
class TestReorderTasks:
"""PUT /api/tasks/reorder tests."""
async def test_reorder_tasks(
self,
client: AsyncClient,
maker_user: User,
db_session: AsyncSession,
):
"""Maker can reorder tasks by providing task IDs in desired order."""
recipe = await create_test_recipe(db_session, maker_user.id)
# Add a second task via copy-on-write
add_resp = await client.post(
f"/api/recipes/{recipe.id}/tasks",
headers=auth_headers(maker_user),
json={"title": "Second Task", "subtasks": []},
)
assert add_resp.status_code == 201
# Get tasks from new version
tasks_resp = await client.get(
f"/api/recipes/{recipe.id}/tasks",
headers=auth_headers(maker_user),
)
tasks = tasks_resp.json()
assert len(tasks) >= 2
task_ids = [t["id"] for t in tasks]
# Reverse the order
reversed_ids = list(reversed(task_ids))
resp = await client.put(
"/api/tasks/reorder",
headers=auth_headers(maker_user),
json={"task_ids": reversed_ids},
)
assert resp.status_code == 200
reordered = resp.json()
assert [t["id"] for t in reordered] == reversed_ids