SynchTask Backend

SynchTask Backend is a collaborative task management API built with Kotlin (JVM) and Spring Boot 3.

It serves as the backend core of the SynchTask ecosystem and is developed as engineering-focused backend project

Current stable release: v1.0.0

This version establishes a contract-stable and security-hardened backend baseline.

Scope (v1.0)

• Monolithic backend (no microservices)
• Stateless JWT security (RS256 + JWKS)
• Hybrid authorization (global roles + membership-based access)
• Validation-hardened HTTP contract
• Backend-only repository (frontend under development)

Trade-offs & Design Decisions

See: Engineering Decisions (v1.0)

Tech stack

• Kotlin + Spring Boot 3
• MySQL + Redis
• OAuth2 Resource Server with RS256 JWT
• OpenAPI / Swagger UI
• Bruno integration test suites

Run locally

1. Configure environment variables:

cp .envrc.example .envrc
# edit values for your local environment

If you use direnv:

direnv allow

2. Run the application:

./gradlew bootRun

3. Run with dev profile:

SPRING_PROFILES_ACTIVE=dev ./gradlew bootRun

4. Open API docs:

• Swagger UI: http://localhost:8081/swagger-ui/index.html
• OpenAPI JSON: http://localhost:8081/v3/api-docs

Testing & quality

./gradlew test
./gradlew detekt
./gradlew jacocoTestReport

Documentation map

• Architecture
• Configuration
• HTTP Error Semantics
• Database
• Engineering Decisions (v1.0)
• OpenAPI Export
• Bruno Test Suites

Roadmap

v1.1 (Planned)

• Pagination & sorting standardization
• Observability improvements (structured logging + metrics exposure)
• Membership query performance optimization
• OpenAPI schema enrichment (error models + examples)
• Extended integration tests for authorization edge cases

Longer-term

• Event-driven extensions
• Modularization of bounded contexts
• Public demo deployment

License

Licensed under the terms in LICENSE.md.