PROJECT_STRUCTURE.md

Project Structure

This document describes the organized structure of the Medical Assistant with Spiritual Support project after the prompt optimization implementation.

📁 Directory Structure

├── src/                                    # Source code
│   ├── config/                            # Configuration and prompt management
│   │   ├── prompt_management/             # NEW: Centralized prompt system
│   │   │   ├── data/                      # Shared component data (JSON)
│   │   │   ├── prompt_controller.py       # Central prompt orchestrator
│   │   │   ├── shared_components.py       # Indicator/Rules/Template catalogs
│   │   │   └── data_models.py            # Data structures
│   │   └── prompts/                       # Prompt text files
│   ├── core/                              # Core business logic
│   └── interface/                         # User interfaces
│       ├── simplified_gradio_app.py       # Main application
│       └── enhanced_prompt_editor.py      # NEW: Enhanced prompt editing UI
│
├── tests/                                 # Organized test structure
│   ├── prompt_optimization/               # NEW: Prompt system tests
│   │   ├── test_enhanced_prompt_editor.py
│   │   ├── test_prompt_controller.py
│   │   ├── test_session_prompt_*.py
│   │   └── test_*_catalog.py
│   ├── integration/                       # End-to-end integration tests
│   │   ├── test_task_*_complete.py
│   │   └── test_integration.py
│   ├── unit/                             # Component unit tests
│   │   ├── test_*_manager.py
│   │   ├── test_*_classifier.py
│   │   └── test_*_system.py
│   ├── verification_mode/                # Verification system tests
│   └── chaplain_feedback/                # Chaplain feedback tests
│
├── scripts/                              # NEW: Utility scripts
│   ├── cleanup_test_data.py              # Data cleanup utilities
│   ├── update_*.py                       # System update scripts
│   └── simple_test.py                    # Quick testing
│
├── .kiro/                                # Kiro IDE configuration
│   └── specs/                            # Project specifications
│       └── prompt-optimization/          # Prompt optimization spec
│
└── [Root Files]
    ├── app.py                            # Main application entry point
    ├── run.sh                            # Launch script
    ├── run_tests.py                      # NEW: Organized test runner
    └── requirements.txt                  # Dependencies

🎯 Key Features Implemented

1. Centralized Prompt Management

• PromptController: Central orchestrator for all prompt operations
• Shared Components: Indicators, rules, templates stored centrally
• Session Overrides: Temporary prompt modifications for testing
• Priority System: Session → Centralized → Default fallbacks

2. Enhanced Edit Prompts Interface

• Real-time editing with session isolation
• Validation system with CSS-optimized display
• Promote to File workflow with automatic backups
• Visual indicators for prompt sources (session vs centralized)

3. Organized Test Structure

• Prompt Optimization Tests: 9 test files covering all prompt system functionality
• Integration Tests: 8 test files for end-to-end workflows
• Unit Tests: 16 test files for individual components
• Proper imports and path handling for moved files

4. Data Management

• Clean shared components (no test data pollution)
• JSON-based storage for indicators, rules, templates
• Automatic cleanup scripts and procedures

🚀 Usage

Running the Application

# Recommended method
./run.sh

# Alternative
python app.py

Running Tests

# All tests with organized output
python run_tests.py

# Specific test suites
python -m pytest tests/prompt_optimization/ -v
python -m pytest tests/integration/ -v
python -m pytest tests/unit/ -v

Utility Scripts

# Clean test data from shared components
python scripts/cleanup_test_data.py

# Quick functionality test
python scripts/simple_test.py

📊 Test Coverage

• Prompt Optimization: 60+ tests covering all new functionality
• Integration: 38+ tests for complete workflows
• Unit Tests: 50+ tests for individual components
• Property-based: Hypothesis testing for correctness guarantees

🔧 Development Workflow

1. Edit Prompts: Use the "🔧 Edit Prompts" tab for real-time testing
2. Session Testing: Make changes that apply only to your session
3. Validation: Use built-in validation before applying changes
4. Promotion: Promote tested changes to permanent files
5. Testing: Run organized test suites to verify functionality

📝 Recent Improvements

• ✅ Organized file structure with logical groupings
• ✅ Fixed import paths for all moved test files
• ✅ CSS-optimized validation display (no more UI overflow)
• ✅ Clean shared components (removed test data pollution)
• ✅ Comprehensive documentation and README files
• ✅ Utility scripts for maintenance and cleanup

🎉 Ready for Production

The system is now fully organized, tested, and ready for production use with:

• Clean, maintainable code structure
• Comprehensive test coverage
• User-friendly prompt editing interface
• Robust data management
• Clear documentation and workflows