Search

PythonReactSEOPDF
GitHub Skill

java-standards

Java service standards for Bitso projects. Covers tech stack requirements, project organization, code review guidelines, MapStruct usage, and build verification practices. Use when creating new Java services or reviewing existing code.

bitsoex☆ 35 Repository stars30 Repository forks

Installation

Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.

View source ↗Guides

Skill instructions

Java Standards

Java service standards for Bitso projects.

When to use this skill

  • Creating new Java services or modules
  • Understanding project organization patterns
  • Reviewing Java code for standards compliance
  • Configuring MapStruct for object mapping
  • Verifying builds after code changes

Skill Contents

Sections
Available Resources

📚 references/ - Detailed documentation


Tech Stack

Component Version Notes
Java 21 (LTS) Current LTS version
Gradle 9.2.1 Recommended for all projects
Spring Boot 3.5.9 Latest (min 3.5.9) - preparing for Spring Boot 4
Database Access jOOQ For accessing PostgreSQL
Databases PostgreSQL, Redis Primary data stores
Inter-service Communication gRPC Standard protocol
Object Mapping MapStruct For DTO/domain mapping

For Spring Boot upgrades, use /upgrade-to-recommended-versions.

Project Organization

Projects should be organized with domain-based modules:

root-project/
├── build.gradle
├── settings.gradle
├── docs/                    # Documentation
├── bitso-libs/              # Library modules
│   ├── <subdomain>/         # Domain logic
│   └── <subdomain-proto>/   # Protobuf definitions
└── bitso-services/          # Service modules
    └── <domain>/            # Spring Boot application

Build Verification

After updating Java or Groovy code, verify changes:

# Run tests to verify changes
./gradlew test 2>&1 | grep -E "FAILED|Error" || echo "All tests passed"

# Or run full build with tests
./gradlew build 2>&1 | grep -E "FAILED|Error" || echo "Build successful"

If problems are found, fix them before committing.

References

Reference Description
references/services.md Tech stack, project structure, dependency management, MapStruct
references/code-review.md Java 21 standards, coding style, var keyword usage
references/build-verification.md Build commands and verification practices

Related Rules

  • .cursor/rules/java-services-standards.mdc - Full service standards
  • .cursor/rules/java-code-review-standards.mdc - Code review guidelines
  • .cursor/rules/java-run-build-after-changes.mdc - Build verification

Related Skills

Skill Purpose
gradle-standards Gradle configuration
grpc-standards gRPC service implementation
database-integration jOOQ and Flyway

Examples

Read the usage examples in the source repository.

View source ↗

Source history

Indexed on
2026-01-20
Index updated
2026-01-28
Branch
main

Index and sync dates describe this directory. View the source repository for code history.

GitHub ↗

chat Comments (0)

chat_bubble_outline

No comments yet. Be the first to share your thoughts!