Reorganize codebase structure: consolidate routers, middleware, and tasks under src/

[Copilot]

Pull Request

Description

Codebase structure inconsistent with documented organization in FOLDER_STRUCTURE.md. Core modules (routers/, middleware/, tasks/) scattered in root directory instead of consolidated under src/. Duplicate encryption.py file causing import ambiguity.

Type of Change

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to not work as expected)
• Documentation update
• Code refactoring
• Performance improvement
• Test coverage improvement

Related Issues

Addresses general code organization and maintainability.

Changes Made

Directory Consolidation

• Moved routers/ → src/routers/ (14 files)
• Moved middleware/ → src/middleware/ (10 files)
• Moved tasks/ → src/tasks/ (4 files)
• Removed duplicate encryption.py from root

Import Path Updates

• Updated 50+ files to use src. prefix consistently:
  • src/integration_server.py (main FastAPI server)
  • All router, middleware, and task modules
  • Demo scripts (4 files)
  • Test suite (9 files)

Documentation

• Updated FOLDER_STRUCTURE.md to reflect actual structure

Before:

from routers.auth import router
from middleware.auth import get_current_user
from tasks import scan_invoice_async

After:

from src.routers.auth import router
from src.middleware.auth import get_current_user
from src.tasks import scan_invoice_async

Testing

• Unit tests pass locally
• Integration tests pass locally
• Manual testing completed
• Docker build succeeds

Test Commands

# Syntax validation
python3 -m py_compile src/**/*.py demos/*.py

# Security scan
codeql analyze  # 0 alerts

Screenshots

N/A - structural changes only

Checklist

• My code follows the project's code style
• I have performed a self-review of my code
• I have commented my code, particularly in hard-to-understand areas
• I have made corresponding changes to the documentation
• My changes generate no new warnings
• I have added tests that prove my fix is effective or that my feature works
• New and existing unit tests pass locally with my changes
• Any dependent changes have been merged and published

Additional Notes

No functional changes - only import path reorganization. All modules retain identical behavior.

Benefits:

• Standardized import pattern across codebase
• Matches documented structure in FOLDER_STRUCTURE.md
• Improved package management compatibility with setup.py
• Cleaner root directory

Final Structure:

src/
├── routers/       # API endpoints
├── middleware/    # Auth, logging, rate limiting
├── tasks/         # Celery background tasks
└── *.py          # Core modules

Deployment Notes

• Database migrations required
• Environment variables added/changed
• Configuration changes needed
• Dependencies updated

Import paths changed - any external tooling or scripts importing these modules will need updates.

---

Reviewer Notes:
Verify alembic migrations and integration server startup post-merge.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
micro-cfo	Error		Jan 29, 2026 9:16pm
micro-cfo-8ik7	Error		Jan 29, 2026 9:16pm

[netlify]

❌ Deploy Preview for spectacular-strudel-d144b2 failed.

Name	Link
🔨 Latest commit	423b8c7
🔍 Latest deploy log	https://app.netlify.com/projects/spectacular-strudel-d144b2/deploys/697bcac0f106d200083a2a91