Directory Restructuring - Modern src/ Layout

[iAmGiG]

Goal

Restructure project to modern Python package layout with proper separation of concerns.

Current Issues

• Inconsistent naming: anomaly-detection vs classification
• Mixed concerns: models, logs, lime outputs in module dirs
• No tests/ directory
• No proper package structure

Target Structure

project/
├── src/                           # All source code
│   ├── anomaly_detection/         # Renamed from anomaly-detection
│   │   ├── models/
│   │   ├── training/
│   │   ├── evaluation/
│   │   └── utils/
│   ├── classification/
│   ├── federated_learning/        # NEW
│   ├── data/                      # Data utilities
│   │   ├── loaders/
│   │   ├── preprocessing/
│   │   └── validation/
│   ├── common/                    # Shared utilities
│   └── analysis/
├── tests/                         # NEW
│   ├── unit/
│   └── integration/
├── outputs/                       # All outputs (gitignored)
│   ├── models/
│   ├── logs/
│   └── lime_explanations/
└── ...

Migration Tasks

• Create new directory structure
• Create all init.py files
• Migrate anomaly-detection → src/anomaly_detection
• Migrate classification → src/classification
• Create federated_learning module structure
• Create data utilities module
• Create common utilities module
• Move outputs to outputs/ directory
• Update ALL import paths throughout codebase
• Create setup.py / pyproject.toml
• Test that everything still works

Breaking Changes

This will change all import paths:

# OLD
from anomaly-detection.train_autoencoder import train

# NEW
from src.anomaly_detection.training.train import train_autoencoder

Related

• Part of MODERNIZATION_ROADMAP.md Phase 1.2
• Blocks Directory Restructuring - Modern src/ Layout #26 (Dependency Modernization)
• Related to Modernization Roadmap for main branch #17 (Modernization Roadmap)

Priority

HIGH - Required before most other modernization work

[iAmGiG]

Sprint 1 Prerequisite Complete ✅

Sprint 1 (#25) is now complete and merged to main:

• ✅ 11 architecture diagrams generated
• ✅ Clear naming: current_* (2020) vs target_* (2025)
• ✅ Comprehensive planning documentation
• ✅ Environment: Python 3.12.12, TensorFlow 2.19.1, Flower 1.22
• ✅ Commit: d56d93e
• ✅ Pushed to GitHub

Ready to begin Sprint 2 (Directory Restructuring).

Diagrams Available:

• Current system visualization shows existing issues
• Target system shows modern src/ layout we'll implement

See: docs/MODERNIZATION_ROADMAP.md for complete plan.