chore: add initial CHANGELOG.md content

CHANGELOG.md

@@ -1,15 +1,36 @@
-# Change Log
+# Changelog
 
-- All notable changes to this project are documented in this file.
-- The format is based on [Keep a Changelog](https://keepachangelog.com/).
-- This project adheres to [Semantic Versioning](https://semver.org/).
+All notable changes to this project will be documented in this file.
 
-## Version 1.0.0 - TBD
+This project adheres to [Semantic Versioning](http://semver.org/).
 
-### Added
+The format is based on [Keep a Changelog](http://keepachangelog.com/).
 
-### Changed
+## Version 1.0.0 - not yet released
 
-### Fixed
+### Added
 
-### Removed
+- Initial version of the project
+- CAP Java plugin for integrating SAP Alert Notification Service (ANS) with CAP Java applications
+- `@notification` annotation on CDS events to define notification types with title, subtitle, and grouped title templates
+- Support for email templates via `template.email.subject` and `template.email.html` fields
+- Mustache syntax (`{{variableName}}`) for dynamic content substitution in templates
+- i18n support via `{i18n>KEY}` placeholders in all template fields with automatic language detection per recipient
+- Automatic notification type provisioning to ANS at application startup (`NotificationTypeAutoProvisionerHandler`)
+- Local mode operation: logs notifications to console without requiring an ANS service binding (`LocalHandler`)
+- Production mode operation: sends notifications to SAP Alert Notification Service (`ProductionHandler`)
+- Mode toggled via `cds.environment.production.enabled` configuration property
+- Programmatic notification emission by injecting the generated `NotificationService` in CAP event handlers
+- Declarative notification triggering via `@notifications` annotation on CDS entities for `CREATE`, `UPDATE`, and `DELETE` events
+- Support for static and dynamic notification priorities (`#LOW`, `#NEUTRAL`, `#MEDIUM`, `#HIGH`) evaluated via CDS expressions at runtime
+- Conditional notification emission using `where` clauses with CDS expression language
+- `parameters` field in `@notifications` for explicit entity field mapping to event properties
+- Recipient support for single strings, arrays of strings, and structured recipient objects (email mapped to `RecipientId`, UUID to `GlobalUserId`)
+- Batch notification processing: emit multiple notifications of the same type in a single call
+- Multi-channel delivery configuration: Web and/or Email with `enabled` and `defaultPreference` flags
+- Navigation target support via `@Common.SemanticObject` and `@Common.SemanticObjectAction` annotations for SAP Fiori Launchpad integration
+- Recipient language resolution via Identity Authentication Service (IAS) destination `Identity_Authentication_Connectivity_IDS`
+- Persistent outbox integration for guaranteed in-order delivery with automatic retry on failure
+- Automatic registration of `NotificationProviderService` and `NotificationTypeProviderService` as OData v2 remote services
+- Support for SAP ANS standalone service binding (`business-notifications` plan) and SAP Work Zone credentials
+- Sample application demonstrating programmatic and declarative notification patterns with integration tests for Java 17 and 21