# Refactoring Plan: API CRUD V3

**Goal:** Modularize `app/routers/api_crud_v3.py` to improve maintainability, readability, and reusability. The file currently mixes route definitions, security enforcement, data sanitization, and helper utilities.

## Phase 1: Extract Helpers & Core Logic (Safest) - COMPLETED
**Objective:** Move pure functions and business logic out of the router file.

1.  **Create `app/lib_api_crud_v3.py`**: DONE
2.  **Update `app/routers/api_crud_v3.py`**: DONE (All endpoints now use `sanitize_payload`).

## Phase 2: Separate Child/Nested Routes - COMPLETED
**Objective:** Reduce file size by splitting standard CRUD from relational CRUD.

1.  **Create `app/routers/api_crud_v3_nested.py`**: DONE
2.  **Update `app/routers/api_crud_v3.py`**: DONE (Included via `router.include_router`)

## Phase 3: Schema Introspection - PLANNED

1.  **Create `app/lib_schema_v3.py` (or similar)**:
    *   Move the logic inside `get_obj_schema` (SQL `DESCRIBE` parsing, Pydantic introspection) to a helper function.

## Execution Strategy
We will execute **Phase 1** first as it provides immediate value (removing code duplication for sanitization) with minimal risk to routing logic.

### Testing
After each move:
1.  Run `tests/test_v3_router_filtering.py` (requires update to import from new location if we test the lib directly).
2.  Verify application startup.