# {{module_name_pascal}} Module

{{module_description}}

## Environment Variables

This module uses environment variables from the main `.env` file at project root.
Use the naming convention: `{MODULE_NAME}_{VAR_NAME}` in uppercase.

For example, if your module is named `{{module_name}}`:
```bash
# In .env file at project root
{{module_name_upper}}_API_KEY=your_api_key_here
{{module_name_upper}}_SECRET=your_secret_here
```

In your module code:
```python
from .context_factory import get_module_context

context = get_module_context()
api_key = context.get_module_config("API_KEY", "{{module_name}}")  # Looks for {{module_name_upper}}_API_KEY
```

## Installation

This module is automatically loaded by the ChaCC backbone when it's placed in the `plugins/` directory.

## Development

### Running in Standalone Mode

To run this module independently for development:

```bash
cd plugins/{{module_name}}
python -m {{module_name}}_src.dev_context
```

Or use the run_tests.py script:

```bash
cd plugins/{{module_name}}
python run_tests.py
```

### Testing

Run tests using pytest:

```bash
pytest tests/ -v
```

## Configuration

{{module_configuration}}

## API Endpoints

{{module_api_endpoints}}

## Dependencies

- Python 3.12+
- FastAPI
- SQLAlchemy
- Pydantic

See `requirements.txt` for full dependencies.
