mirror of
https://github.com/SamyRai/tercul-backend.git
synced 2025-12-27 04:01:34 +00:00
781b313bf1
This commit addresses all the high-priority tasks outlined in the TASKS.md file, significantly improving the application's observability, completing key features, and refactoring critical parts of the codebase. ### Observability - **Centralized Logging:** Implemented a new structured, context-aware logging system using `zerolog`. A new logging middleware injects request-specific information (request ID, user ID, trace ID) into the logger, and all application logging has been refactored to use this new system. - **Prometheus Metrics:** Added Prometheus metrics for database query performance by creating a GORM plugin that automatically records query latency and totals. - **OpenTelemetry Tracing:** Fully instrumented all application services in `internal/app` and data repositories in `internal/data/sql` with OpenTelemetry tracing, providing deep visibility into application performance. ### Features - **Analytics:** Implemented like, comment, and bookmark counting. The respective command handlers now call the analytics service to increment counters when these actions are performed. - **Enrichment Tool:** Built a new, extensible `enrich` command-line tool to fetch data from external sources. The initial implementation enriches author data using the Open Library API. ### Refactoring & Fixes - **Decoupled Testing:** Refactored the testing utilities in `internal/testutil` to be database-agnostic, promoting the use of mock-based unit tests and improving test speed and reliability. - **Build Fixes:** Resolved numerous build errors, including a critical import cycle between the logging, observability, and authentication packages. - **Search Service:** Fixed the search service integration by implementing the `GetWorkContent` method in the localization service, allowing the search indexer to correctly fetch and index work content.
60 lines
1.4 KiB
Go
60 lines
1.4 KiB
Go
package openlibrary
|
|
|
|
import (
|
|
"context"
|
|
"encoding/json"
|
|
"fmt"
|
|
"net/http"
|
|
"time"
|
|
)
|
|
|
|
const baseURL = "https://openlibrary.org"
|
|
|
|
// Client is a client for the Open Library API.
|
|
type Client struct {
|
|
httpClient *http.Client
|
|
}
|
|
|
|
// NewClient creates a new Open Library client.
|
|
func NewClient() *Client {
|
|
return &Client{
|
|
httpClient: &http.Client{Timeout: 10 * time.Second},
|
|
}
|
|
}
|
|
|
|
// Author represents the data returned from the Open Library Authors API.
|
|
type Author struct {
|
|
Name string `json:"name"`
|
|
PersonalName string `json:"personal_name"`
|
|
Bio interface{} `json:"bio"` // Bio can be a string or a struct
|
|
Wikipedia string `json:"wikipedia"`
|
|
}
|
|
|
|
// GetAuthor fetches author data from the Open Library API.
|
|
// The olid is the Open Library Author ID (e.g., "OL23919A").
|
|
func (c *Client) GetAuthor(ctx context.Context, olid string) (*Author, error) {
|
|
url := fmt.Sprintf("%s/authors/%s.json", baseURL, olid)
|
|
req, err := http.NewRequestWithContext(ctx, "GET", url, nil)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
req.Header.Set("User-Agent", "TerculEnrichmentTool/1.0 (contact@tercul.com)")
|
|
|
|
resp, err := c.httpClient.Do(req)
|
|
if err != nil {
|
|
return nil, err
|
|
}
|
|
defer resp.Body.Close()
|
|
|
|
if resp.StatusCode != http.StatusOK {
|
|
return nil, fmt.Errorf("unexpected status code: %d", resp.StatusCode)
|
|
}
|
|
|
|
var author Author
|
|
if err := json.NewDecoder(resp.Body).Decode(&author); err != nil {
|
|
return nil, err
|
|
}
|
|
|
|
return &author, nil
|
|
} |