RamonRDR · RamonRDR · Sep 2, 2026 · Aug 31, 2026 · Aug 31, 2026 · Aug 31, 2026
diff --git a/.github/workflows/quality-checks.yml b/.github/workflows/quality-checks.yml
@@ -52,3 +52,26 @@ jobs:
 
       - name: Validate repository structure
         run: python scripts/validate_repository_structure.py
+
+  file-organizer-windows:
+    name: File Organizer Windows
+    runs-on: windows-latest
+    timeout-minutes: 10
+
+    steps:
+      - name: Check out repository
+        uses: actions/checkout@v6
+
+      - name: Set up Python
+        uses: actions/setup-python@v6
+        with:
+          python-version: "3.13"
+
+      - name: Show Python version
+        run: python --version
+
+      - name: Install test dependency
+        run: python -m pip install --disable-pip-version-check "pytest>=9.1,<9.2"
+
+      - name: Run File Organizer tests on Windows
+        run: python -m pytest -q practical-projects/06-file-organizer/tests
diff --git a/docs/learning-path.en.md b/docs/learning-path.en.md
@@ -135,11 +135,11 @@ Phase 9 is complete with four reviewed chapters. The sequence moves from tabular
 3. ✅ [User Registration](../practical-projects/03-user-registration/README.md)
 4. ✅ [CSV Analyzer](../practical-projects/04-csv-analyzer/README.md)
 5. ✅ [Report Generator](../practical-projects/05-report-generator/README.md)
-6. ⏳ File Organizer
+6. 🚧 [File Organizer](../practical-projects/06-file-organizer/README.md)
 7. ⏳ Fictional Reconciliation Workflow
 8. ⏳ Simulated Automation Flow
 
-Phase 10 is in progress. Project 01 integrates validated data modeling, exact `Decimal` money, collections, JSON persistence, CSV export, deterministic temporary-file handling, and automated pytest coverage. Project 02 adds configurable grade policies, exact weighted aggregation, explicit progress-versus-final state, structured reporting, and boundary-focused tests. Project 03 adds canonical identity-like data, Unicode and IDNA normalization, duplicate prevention, secondary lookup indexes, safe indexed-field updates, explicit lifecycle transitions, and mutation-focused tests without introducing authentication. Project 04 adds schema-aware CSV ingestion, typed conversion, row-level rejection diagnostics, structural failures, duplicate identifier checks, deterministic filtering, and aggregation using the standard library. Project 05 adds explicit reporting windows, deterministic summaries, exact two-decimal metrics, immutable report boundaries, TXT/Markdown rendering, format-aware escaping, and UTF-8 file output.
+Phase 10 is in progress. Project 01 integrates validated data modeling, exact `Decimal` money, collections, JSON persistence, CSV export, deterministic temporary-file handling, and automated pytest coverage. Project 02 adds configurable grade policies, exact weighted aggregation, explicit progress-versus-final state, structured reporting, and boundary-focused tests. Project 03 adds canonical identity-like data, Unicode and IDNA normalization, duplicate prevention, secondary lookup indexes, safe indexed-field updates, explicit lifecycle transitions, and mutation-focused tests without introducing authentication. Project 04 adds schema-aware CSV ingestion, typed conversion, row-level rejection diagnostics, structural failures, duplicate identifier checks, deterministic filtering, and aggregation using the standard library. Project 05 adds explicit reporting windows, deterministic summaries, exact two-decimal metrics, immutable report boundaries, TXT/Markdown rendering, format-aware escaping, and UTF-8 file output. Project 06 adds deterministic shallow file discovery, suffix classification, immutable dry-run planning, explicit collision policies, symlink boundaries, `(device, inode)` identity checks, source/category/root anchoring, bounded staging names, and platform-aware atomic no-replace commit behavior with Linux `renameat2(RENAME_NOREPLACE)`.
 
 ## Useful navigation
 

diff --git a/docs/learning-path.es.md b/docs/learning-path.es.md
@@ -135,11 +135,11 @@ La Fase 9 está completada con cuatro capítulos revisados. La secuencia avanza
 3. ✅ [Registro de Usuarios](../practical-projects/03-user-registration/README.es.md)
 4. ✅ [Analizador CSV](../practical-projects/04-csv-analyzer/README.es.md)
 5. ✅ [Generador de Informes](../practical-projects/05-report-generator/README.es.md)
-6. ⏳ Organizador de Archivos
+6. 🚧 [Organizador de Archivos](../practical-projects/06-file-organizer/README.es.md)
 7. ⏳ Flujo Ficticio de Conciliación
 8. ⏳ Flujo Simulado de Automatización
 
-La Fase 10 está en progreso. El Proyecto 01 integra modelado de datos validado, dinero exacto con `Decimal`, colecciones, persistencia JSON, exportación CSV, manejo determinista de archivos temporales y cobertura automatizada con pytest. El Proyecto 02 añade políticas de calificación configurables, agregación ponderada exacta, estado de progreso frente a final explícito, informe estructurado y pruebas centradas en límites. El Proyecto 03 añade datos de identidad canónicos, normalización Unicode e IDNA, prevención de duplicados, índices secundarios de lookup, actualizaciones seguras de campos indexados, transiciones explícitas del ciclo de vida y pruebas centradas en mutación sin introducir autenticación. El Proyecto 04 añade ingestión CSV consciente de schema, conversión tipada, diagnóstico de rechazos por fila, fallos estructurales, comprobación de identificadores duplicados, filtros deterministas y agregación mediante la biblioteca estándar. El Proyecto 05 añade ventanas explícitas de informe, resúmenes deterministas, métricas exactas con dos decimales, límites inmutables del informe, renderización TXT/Markdown, escape específico del formato y escritura UTF-8.
+La Fase 10 está en progreso. El Proyecto 01 integra modelado de datos validado, dinero exacto con `Decimal`, colecciones, persistencia JSON, exportación CSV, manejo determinista de archivos temporales y cobertura automatizada con pytest. El Proyecto 02 añade políticas de calificación configurables, agregación ponderada exacta, estado de progreso frente a final explícito, informe estructurado y pruebas centradas en límites. El Proyecto 03 añade datos de identidad canónicos, normalización Unicode e IDNA, prevención de duplicados, índices secundarios de lookup, actualizaciones seguras de campos indexados, transiciones explícitas del ciclo de vida y pruebas centradas en mutación sin introducir autenticación. El Proyecto 04 añade ingestión CSV consciente de schema, conversión tipada, diagnóstico de rechazos por fila, fallos estructurales, comprobación de identificadores duplicados, filtros deterministas y agregación mediante la biblioteca estándar. El Proyecto 05 añade ventanas explícitas de informe, resúmenes deterministas, métricas exactas con dos decimales, límites inmutables del informe, renderización TXT/Markdown, escape específico del formato y escritura UTF-8. El Proyecto 06 añade descubrimiento superficial y determinista de archivos, clasificación por sufijo, planificación dry-run inmutable, políticas explícitas de colisión, fronteras de symlink, identidad `(device, inode)`, anclaje de raíz/categorías, nombres de staging acotados y commit atómico no-replace sensible a la plataforma con `renameat2(RENAME_NOREPLACE)` en Linux.
 
 ## Navegación útil
 

diff --git a/docs/learning-path.pt-BR.md b/docs/learning-path.pt-BR.md
@@ -135,11 +135,11 @@ A Fase 9 está concluída com quatro capítulos revisados. A sequência avança
 3. ✅ [Cadastro de Usuários](../practical-projects/03-user-registration/README.pt-BR.md)
 4. ✅ [Analisador CSV](../practical-projects/04-csv-analyzer/README.pt-BR.md)
 5. ✅ [Gerador de Relatórios](../practical-projects/05-report-generator/README.pt-BR.md)
-6. ⏳ Organizador de Arquivos
+6. 🚧 [Organizador de Arquivos](../practical-projects/06-file-organizer/README.pt-BR.md)
 7. ⏳ Fluxo Fictício de Conciliação
 8. ⏳ Fluxo Simulado de Automação
 
-A Fase 10 está em andamento. O Projeto 01 integra modelagem de dados validada, dinheiro exato com `Decimal`, coleções, persistência JSON, exportação CSV, manipulação determinística de arquivos temporários e cobertura automatizada com pytest. O Projeto 02 adiciona políticas de notas configuráveis, agregação ponderada exata, estado de progresso versus final explícito, relatório estruturado e testes focados em fronteiras. O Projeto 03 adiciona dados de identidade canônicos, normalização Unicode e IDNA, prevenção de duplicidade, índices secundários de lookup, atualizações seguras de campos indexados, transições explícitas de ciclo de vida e testes focados em mutação sem introduzir autenticação. O Projeto 04 adiciona ingestão CSV consciente de schema, conversão tipada, diagnóstico de rejeições por linha, falhas estruturais, verificação de identificadores duplicados, filtros determinísticos e agregação usando a biblioteca padrão. O Projeto 05 adiciona janelas explícitas de relatório, resumos determinísticos, métricas exatas com duas casas decimais, fronteiras imutáveis de relatório, renderização TXT/Markdown, escape específico do formato e escrita UTF-8.
+A Fase 10 está em andamento. O Projeto 01 integra modelagem de dados validada, dinheiro exato com `Decimal`, coleções, persistência JSON, exportação CSV, manipulação determinística de arquivos temporários e cobertura automatizada com pytest. O Projeto 02 adiciona políticas de notas configuráveis, agregação ponderada exata, estado de progresso versus final explícito, relatório estruturado e testes focados em fronteiras. O Projeto 03 adiciona dados de identidade canônicos, normalização Unicode e IDNA, prevenção de duplicidade, índices secundários de lookup, atualizações seguras de campos indexados, transições explícitas de ciclo de vida e testes focados em mutação sem introduzir autenticação. O Projeto 04 adiciona ingestão CSV consciente de schema, conversão tipada, diagnóstico de rejeições por linha, falhas estruturais, verificação de identificadores duplicados, filtros determinísticos e agregação usando a biblioteca padrão. O Projeto 05 adiciona janelas explícitas de relatório, resumos determinísticos, métricas exatas com duas casas decimais, fronteiras imutáveis de relatório, renderização TXT/Markdown, escape específico do formato e escrita UTF-8. O Projeto 06 adiciona descoberta rasa e determinística de arquivos, classificação por sufixo, planejamento dry-run imutável, políticas explícitas de colisão, fronteiras de symlink, identidade `(device, inode)`, ancoragem de raiz/categorias, nomes de staging limitados e commit atômico no-replace sensível à plataforma com `renameat2(RENAME_NOREPLACE)` no Linux.
 
 ## Navegação útil
 

diff --git a/docs/project-structure.en.md b/docs/project-structure.en.md
@@ -394,15 +394,25 @@ python-study-guide/
 │   │   └── tests/
 │   │       ├── conftest.py
 │   │       └── test_csv_analyzer.py
-│   └── 05-report-generator/
+│   ├── 05-report-generator/
+│   │   ├── README.md
+│   │   ├── README.pt-BR.md
+│   │   ├── README.es.md
+│   │   ├── demo.py
+│   │   ├── report_generator.py
+│   │   └── tests/
+│   │       ├── conftest.py
+│   │       └── test_report_generator.py
+│   └── 06-file-organizer/
 │       ├── README.md
 │       ├── README.pt-BR.md
 │       ├── README.es.md
 │       ├── demo.py
-│       ├── report_generator.py
+│       ├── file_organizer.py
 │       └── tests/
 │           ├── conftest.py
-│           └── test_report_generator.py
+│           ├── test_atomic_move.py
+│           └── test_file_organizer.py
 ├── program-flow/
 │   ├── README.md
 │   ├── README.pt-BR.md
@@ -619,7 +629,7 @@ python-study-guide/
 - `external-libraries/`: complete Phase 9 learning path for third-party packages. It contains reviewed multilingual chapters for pandas 3.0.x, openpyxl 3.1.x, Requests 2.34.x, and pytest 9.1.x, with twenty deterministic executable examples in total. The phase covers tabular transformations, Excel workbook automation, HTTP/API clients, and automated-testing contracts; Phase 10 practical projects come next.
 - `functions/`: complete Phase 5 learning path. Chapters 01–09 cover defining and calling functions, required inputs, returned values, scope and name lookup, type hints for function interfaces, default values including definition-time evaluation and mutable-default safety, variable-length positional and keyword argument collection with `*args` and `**kwargs`, composition through helper and coordinating functions with explicit dependencies and simple call graphs, and explicit data-flow tracing across calls including parameter bindings, rebinding versus mutation, `None`, tuple results, and return-based handoffs, in English, Brazilian Portuguese, and Spanish with deterministic executable examples.
 - `fundamentals/`: complete Phase 1 learning path. Its six chapters teach how Python runs a program, how to use `print()` and `input()`, how assignment and naming work, how to recognize and inspect common built-in data types, and how to convert compatible values deliberately, with aligned multilingual explanations and executable examples.
-- `practical-projects/`: Phase 10 practical-project workspace. Projects 01–05 are available: Expense Tracker integrates validated monetary data and persistence; Grade Calculator adds configurable grading policies and exact weighted aggregation; User Registration adds canonical identity-like data, duplicate prevention, indexed updates, and lifecycle transitions; CSV Analyzer adds strict schema-aware ingestion and partial-success validation; Report Generator adds explicit date windows, deterministic summary metrics, TXT/Markdown rendering, and UTF-8 file output.
+- `practical-projects/`: Phase 10 practical-project workspace. Projects 01–05 are complete and Project 06 File Organizer is in progress. Project 06 adds deterministic shallow discovery, immutable planning, collision policies, symlink boundaries, filesystem identity checks, descriptor-anchored directories, bounded staging names, atomic Linux no-replace commit behavior, a deterministic demo, and focused regression tests.
 - `program-flow/`: complete Phase 4 learning path. Chapters 01–08 teach conditions, comparisons, truth-value testing, membership, identity, Boolean logic, conditional branching with `if`, `elif`, and `else`, structural pattern matching, iterable-driven repetition with `for`, numeric progressions with `range()`, position-aware iteration with `enumerate()`, parallel iteration with `zip()` including explicit equal-length validation with `strict=True`, state-driven repetition with `while`, deliberate loop control with `break`, `continue`, and loop `else`, and how to choose and combine program-flow tools according to intent, in English, Brazilian Portuguese, and Spanish with deterministic executable examples.
 - `scripts/`: dependency-free maintenance tools used locally and by GitHub Actions.
 - `standard-library/`: complete Phase 8 learning path. Chapters 01–09 cover `pathlib` filesystem boundaries, `datetime` date/time modeling, advanced `json` and `csv` contracts, `logging`, specialized `collections`, `itertools`, `decimal`, and `os`/`shutil` contracts for environment state, traversal, metadata, copy, move, recursive removal, platform capabilities, and archive safety, in English, Brazilian Portuguese, and Spanish with deterministic executable examples.