Privactivity Activity Store

A multi-module Spring Boot application for storing and analyzing fitness activities from Garmin FIT files, GPX files, and TCX files. The application has a domain-driven modular architecture with separate storage engines and a unified Angular frontend.

Features

• Import and store activities from Garmin FIT, GPX, and TCX file formats
• Query and filter activities by distance, ascent, location, and more
• Export activities in multiple formats (GPX, CSV)
• Analyze metrics: power, heart rate, cadence, elevation
• Interactive map visualization with Leaflet
• GeoJSON support for advanced geospatial queries
• JWT-based authentication with role-based access control
• EclipseStore for high-performance object persistence
• Full REST API for programmatic access

Quick Start

Prerequisites

• JDK 25+
• Gradle 9.6+ (included via gradlew)
• Node.js 24+ (Gradle downloads and manages it)
• Optional: Docker for container deployment

Installation

1. Clone the repository:

   git clone https://github.com/your-org/privactivity-activity-store.git
   cd privactivity-activity-store

2. Build the application:

   ./gradlew build

3. Configure storage: Create application-dev.properties in privactivity-app/src/main/resources/ with:

   privactivity.store.activity.storage-directory=${HOME}/privactivity-storage/activity
   privactivity.fit.import.directory=${HOME}/privactivity-import
   privactivity.bootstrap.admin-password-file.path=${HOME}/privactivity-secrets/admin-password.txt
   server.port=8090

   On first startup, the application reads the initial admin password from the file above and uses it to create the default admin account in users.json if that file does not already exist.

4. Run locally:

   ./bootRun.sh

   This starts the application in development mode at http://localhost:8090 with hot-reload enabled. To use hot-reload web-frontend:

   ./gradlew ngServe

Installation using the Docker image

1. Build the image:

   ./build-docker-image.sh

   This creates the org.privactivity/activity-store:latest image in the registry configured by DOCKER_REGISTRY (localhost by default).

2. Prepare persistent files and directories: The Docker profile expectes application data under /privactivity. Create a local directory /path/to/privactivity for it.

3. Initial admin password: Create a file /path/to/privactivity/admin-password.txt and add a line with the initial password for the admin user.

4. Generate the JWT key pair: The Docker profile expects PEM-encoded RSA keys at /privactivity/jwt/app.key and /privactivity/jwt/app.pub. Generate them once:

   mkdir -p /path/to/privactivity/jwt
   openssl genpkey -algorithm RSA -out /path/to/privactivity/jwt/app.key -pkeyopt rsa_keygen_bits:2048
   openssl rsa -pubout -in /path/to/privactivity/jwt/app.key -out /path/to/privactivity/jwt/app.pub

5. Run the container:

   docker run --rm \
     -p 8090:8090 \
     -e SPRING_PROFILES_ACTIVE=docker \
     -v /path/to/privactivity:/privactivity \
     localhost/org.privactivity/activity-store:latest

   The application is then available at http://localhost:8090.

Documentation

• DEVELOPMENT.md — Architecture, layering, workflow, and testing conventions
• .github/copilot-instructions.md — AI coding agent guidelines

Development

Build & Run

./bootRun.sh                    # Development server with hot-reload
./gradlew build                 # Full build (all modules + Angular frontend)
./gradlew :angular:ngServe      # Start Angular dev server only
./build-docker-image.sh         # Build and push Docker image

Technology Stack

• Backend: Spring Boot 4, EclipseStore, JUnit 5
• Frontend: Angular 21, Material UI, Leaflet
• Build: Gradle multi-project, Node.js (managed by Gradle)
• Storage: EclipseStore (object database, not SQL)

Contributing

Please refer to DEVELOPMENT.md for detailed architecture, layering principles, and coding conventions.

License

See LICENSE file for details.