# Essencia Documentation

Welcome to the Essencia framework documentation. This guide covers all aspects of building secure medical and business applications with Essencia.

## Table of Contents

### Getting Started
- [Installation Guide](installation.md) - Setup and requirements
- [Quick Start](quickstart.md) - Build your first application
- [Project Structure](structure.md) - Understanding the codebase

### Core Concepts
- [Models and Database](models.md) - Working with MongoDB
- [Security](security.md) - Encryption, authentication, and authorization
- [Services and Patterns](services.md) - Service layer architecture
- [Middleware](middleware.md) - Request/response processing

### Domain-Specific Features
- [Medical System](medical.md) - Healthcare-specific components
- [Laboratory System](laboratory_system.md) - Lab test data management
- [Financial Models](financial.md) - Financial record management
- [Brazilian Support](brazilian.md) - CPF, CNPJ, and local validators

### Advanced Topics
- [Caching Strategies](caching.md) - Redis integration and patterns
- [Async Operations](async.md) - Using Motor for async MongoDB
- [UI Components](ui.md) - Flet-based user interfaces
- [Performance](performance.md) - Optimization techniques

### API Reference
- [Models API](api/models.md) - Complete model reference
- [Fields API](api/fields.md) - Field types and validators
- [Services API](api/services.md) - Service layer reference
- [Utils API](api/utils.md) - Utility functions

### Development
- [Contributing](../CONTRIBUTING.md) - How to contribute
- [Testing](testing.md) - Writing and running tests
- [Publishing](../PUBLISHING.md) - PyPI release process
- [Migration Guide](../MIGRATION.md) - Version migration

### Security
- [Security Policy](../SECURITY.md) - Reporting vulnerabilities
- [Best Practices](security-best-practices.md) - Security guidelines
- [LGPD Compliance](lgpd.md) - Brazilian data protection

## Quick Links

- **Source Code**: [GitHub Repository](https://github.com/essencia/essencia)
- **Issue Tracker**: [Report Issues](https://github.com/essencia/essencia/issues)
- **PyPI Package**: [essencia on PyPI](https://pypi.org/project/essencia/)

## Version Information

Current stable version: 1.6.0

See [CHANGELOG.md](../CHANGELOG.md) for version history.

## Support

For questions and support:
1. Check the relevant documentation section
2. Search existing [GitHub Issues](https://github.com/essencia/essencia/issues)
3. Create a new issue with the question tag

## License

Essencia is released under the MIT License. See [LICENSE](../LICENSE) for details.