mukimovd/tercul-backend
1
0
Fork 0
mirror of https://github.com/SamyRai/tercul-backend.git synced 2025-12-27 00:31:35 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity
87 Commits 1 Branch 0 Tags 27 MiB
Go 99.9%
c2e9a118e2
Go to file
google-labs-jules[bot] c2e9a118e2 feat(testing): Increase test coverage and fix authz bugs 
This commit significantly increases the test coverage across the application and fixes several underlying bugs that were discovered while writing the new tests.

The key changes include:

- **New Tests:** Added extensive integration and unit tests for GraphQL resolvers, application services, and data repositories, substantially increasing the test coverage for packages like `graphql`, `user`, `translation`, and `analytics`.

- **Authorization Bug Fixes:**
  - Fixed a critical bug where a user creating a `Work` was not correctly associated as its author, causing subsequent permission failures.
  - Corrected the authorization logic in `authz.Service` to properly check for entity ownership by non-admin users.

- **Test Refactoring:**
  - Refactored numerous test suites to use `testify/mock` instead of manual mocks, improving test clarity and maintainability.
  - Isolated integration tests by creating a fresh admin user and token for each test run, eliminating test pollution.
  - Centralized domain errors into `internal/domain/errors.go` and updated repositories to use them, making error handling more consistent.

- **Code Quality Improvements:**
  - Replaced manual mock implementations with `testify/mock` for better consistency.
  - Cleaned up redundant and outdated test files.

These changes stabilize the test suite, improve the overall quality of the codebase, and move the project closer to the goal of 80% test coverage.
2025-10-09 07:03:45 +00:00
.github/workflows feat: restore project state and establish CI pipeline 2025-10-05 11:23:31 +00:00
api This commit introduces a series of significant improvements to bring the codebase closer to a production-ready state. 2025-10-08 17:25:02 +00:00
cmd feat(testing): Increase test coverage and fix authz bugs 2025-10-09 07:03:45 +00:00
content/blog feat: Implement blog schema and example content 2025-09-07 23:22:36 +00:00
deploy I have refactored the background jobs by moving all related logic from the syncjob/, linguistics/, and internal/enrich directories into the new internal/jobs/sync and internal/jobs/linguistics packages. I have also updated their package declarations to be consistent with their new locations. 2025-09-02 15:02:04 +00:00
internal feat(testing): Increase test coverage and fix authz bugs 2025-10-09 07:03:45 +00:00
ops I have refactored the background jobs by moving all related logic from the syncjob/, linguistics/, and internal/enrich directories into the new internal/jobs/sync and internal/jobs/linguistics packages. I have also updated their package declarations to be consistent with their new locations. 2025-09-02 15:02:04 +00:00
pkg/linguistics I have refactored the background jobs by moving all related logic from the syncjob/, linguistics/, and internal/enrich directories into the new internal/jobs/sync and internal/jobs/linguistics packages. I have also updated their package declarations to be consistent with their new locations. 2025-09-02 15:02:04 +00:00
schemas feat: Implement blog schema and example content 2025-09-07 23:22:36 +00:00
test I have refactored the background jobs by moving all related logic from the syncjob/, linguistics/, and internal/enrich directories into the new internal/jobs/sync and internal/jobs/linguistics packages. I have also updated their package declarations to be consistent with their new locations. 2025-09-02 15:02:04 +00:00
.air.toml Initial commit: Tercul Go project with comprehensive architecture 2025-08-13 07:42:32 +02:00
.gitignore wip 2025-09-01 00:43:59 +02:00
.tool-versions wip 2025-09-01 00:43:59 +02:00
AGENTS.md docs: consolidate tasks and clean up legacy files 2025-10-04 23:59:30 +00:00
docker-compose.yml Initial commit: Tercul Go project with comprehensive architecture 2025-08-13 07:42:32 +02:00
Dockerfile Initial commit: Tercul Go project with comprehensive architecture 2025-08-13 07:42:32 +02:00
Dockerfile.dev Initial commit: Tercul Go project with comprehensive architecture 2025-08-13 07:42:32 +02:00
go.mod test: Increase test coverage for internal/platform/cache 2025-10-08 21:28:56 +00:00
go.sum test: Increase test coverage for internal/platform/cache 2025-10-08 21:28:56 +00:00
gqlgen.yml feat: Refactor GORM relations and implement mutations 2025-09-06 12:45:44 +00:00
Makefile Chore: Clean up lint warnings and improve code quality 2025-10-07 13:14:01 +00:00
README.md This commit introduces a series of significant improvements to bring the codebase closer to a production-ready state. 2025-10-08 17:25:02 +00:00
refactor.md This commit updates the TODO.md and refactor.md files to reflect the latest architectural changes. It also removes several temporary and one-off script files to clean up the repository. 2025-10-03 03:02:46 +00:00
requirements.txt Initial commit: Tercul Go project with comprehensive architecture 2025-08-13 07:42:32 +02:00
TASKS.md refactor(app): move composition root to main.go 2025-10-07 14:05:19 +00:00
tools.go feat: Implement analytics features 2025-09-07 16:43:15 +00:00

README.md

The Tercul Project

Welcome to Tercul, a modern platform for literary enthusiasts to discover, translate, and discuss works from around the world. This repository contains the backend services, API, and data processing pipelines that power the platform.

Architecture

The Tercul backend is built using a Domain-Driven Design (DDD-lite) approach, emphasizing a clean separation of concerns between domain logic, application services, and infrastructure. Key architectural patterns include:

  • Command Query Responsibility Segregation (CQRS): Application logic is separated into Commands (for writing data) and Queries (for reading data). This allows for optimized, scalable, and maintainable services.
  • Clean Architecture: Dependencies flow inwards, with inner layers (domain) having no knowledge of outer layers (infrastructure).
  • Dependency Injection: Services and repositories are instantiated at the application's entry point (cmd/api/main.go) and injected as dependencies, promoting loose coupling and testability.

For a more detailed explanation of the architectural vision and ongoing refactoring efforts, please see refactor.md.

Getting Started

Follow these instructions to get the development environment up and running on your local machine.

Prerequisites

  • Go: Version 1.25.0 (as specified in .tool-versions)
  • Docker & Docker Compose: For running external dependencies like PostgreSQL and Weaviate.
  • make: For running common development commands.
  • golangci-lint: For running the linter. Install it with: 
    go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest
    Ensure your Go binary path ($(go env GOPATH)/bin) is in your shell's PATH.

Installation

  1. Clone the repository:

    git clone <repository-url>
cd tercul

  2. Install Go dependencies:

    go mod tidy

Configuration

The application is configured using environment variables. A local docker-compose.yml file is provided to run the necessary services (PostgreSQL, Weaviate, etc.) with default development settings.

The application will automatically connect to these services. For a full list of configurable variables and their default values, see internal/platform/config/config.go.

Running the Application

  1. Start external services:

    docker-compose up -d

  2. Run the API server:

    go run cmd/api/main.go

    The API server will be available at http://localhost:8080. The GraphQL playground can be accessed at http://localhost:8080/playground.

Running Tests

To ensure code quality and correctness, run the full suite of linters and tests:

make lint-test

This command executes the same checks that are run in our Continuous Integration (CI) pipeline.