polish 😁

README.md

@@ -394,9 +394,13 @@ make manifests  # Generate CRD and RBAC
 make generate   # Generate deepcopy code
 ```
 
-## Architecture Decisions
+## Documentation
 
-See [future-considerations.md](specs/001-selfhost-supabase-operator/future-considerations.md) for deferred features and architectural flexibility.
+- **[Architecture Guide](docs/architecture.md)**: Detailed architecture documentation covering system design, controller patterns, component deployment, status management, and design decisions
+- **[API Reference](docs/api-reference.md)**: Complete API reference for the SupabaseProject CRD with field descriptions, examples, and validation rules
+- **[Database Initialization](docs/database-initialization.md)**: PostgreSQL setup requirements and initialization details
+- **[Quick Start](docs/quick-start.md)**: Getting started guide with step-by-step instructions
+- **[Future Considerations](specs/001-selfhost-supabase-operator/future-considerations.md)**: Deferred features and architectural flexibility
 
 ## Contributing
 

cmd/main.go

@@ -21,6 +21,7 @@ import (
 
 	supabasev1alpha1 "github.com/strrl/supabase-operator/api/v1alpha1"
 	"github.com/strrl/supabase-operator/internal/controller"
+	internalwebhook "github.com/strrl/supabase-operator/internal/webhook"
 	// +kubebuilder:scaffold:imports
 )
 
@@ -163,12 +164,20 @@ func main() {
 	}
 
 	if err := (&controller.SupabaseProjectReconciler{
-		Client: mgr.GetClient(),
-		Scheme: mgr.GetScheme(),
+		Client:   mgr.GetClient(),
+		Scheme:   mgr.GetScheme(),
+		Recorder: mgr.GetEventRecorderFor("supabase-operator"),
 	}).SetupWithManager(mgr); err != nil {
 		setupLog.Error(err, "unable to create controller", "controller", "SupabaseProject")
 		os.Exit(1)
 	}
+
+	if err := (&internalwebhook.SupabaseProjectWebhook{
+		Client: mgr.GetClient(),
+	}).SetupWebhookWithManager(mgr); err != nil {
+		setupLog.Error(err, "unable to create webhook", "webhook", "SupabaseProject")
+		os.Exit(1)
+	}
 	// +kubebuilder:scaffold:builder
 
 	if err := mgr.AddHealthzCheck("healthz", healthz.Ping); err != nil {