Add structured logging to documentStore methods

To troubleshoot reported issues, we add more debugging outputs in
the logging. This includes detailed, structured logs in the Create
and FindID methods to provide better traceability and debuggability.

These changes help diagnose issues by providing detailed context in
the logs, which should improve the ability to identify and resolve
problems.

See also: #9

stores/filesystem/documents.go

@@ -10,6 +10,7 @@ import (
 	"path/filepath"
 
 	"github.com/oklog/ulid/v2"
+	"github.com/sirupsen/logrus"
 )
 
 type documentStore struct {
@@ -26,12 +27,16 @@ func NewDocumentStore(basePath string) core.DocumentStore {
 
 func (s *documentStore) FindID(ctx context.Context, id string) (*core.Document, error) {
 	filePath := filepath.Join(s.basePath, id)
+	log := logrus.WithField("document_id", id)
 
+	log.WithField("file_path", filePath).Info("Retrieving document by ID")
 	data, err := os.ReadFile(filePath)
 	if err != nil {
 		if os.IsNotExist(err) {
+			log.WithField("error", "document not found").Warn("Document with specified ID not found")
 			return nil, fmt.Errorf("document with id %s not found", id)
 		}
+		log.WithField("error", err).Error("Failed to retrieve document")
 		return nil, err
 	}
 
@@ -39,16 +44,24 @@ func (s *documentStore) FindID(ctx context.Context, id string) (*core.Document,
 		Data: *bytes.NewBuffer(data),
 	}
 
+	log.Info("Document retrieved successfully")
 	return &document, nil
 }
 
 func (s *documentStore) Create(ctx context.Context, document *core.Document) (string, error) {
 	id := ulid.Make().String()
 	filePath := filepath.Join(s.basePath, id)
+	log := logrus.WithFields(logrus.Fields{
+		"document_id": id,
+		"file_path":   filePath,
+	})
+	log.Info("Creating new document")
 
 	if err := os.WriteFile(filePath, document.Data.Bytes(), 0644); err != nil {
+		log.WithField("error", err).Error("Failed to create document")
 		return "", err
 	}
 
+	log.Info("Document created successfully")
 	return id, nil
 }