Development Setup

Prerequisites

Tool	Version	Purpose
GraalVM JDK	21	Runtime, compilation, and optional native image
Maven	3.8+	Build system
Git	2.x	Version control
IDE	IntelliJ IDEA recommended	Development

Clone & Build

git clone https://gitcode.com/qiusls/firmiana.git
cd firmiana
mvn compile

Run

mvn exec:java

Server starts on http://localhost:8899.

Windows Classpath Approach

The exec:java plugin may not work on Windows. Use:

mvn dependency:build-classpath -q -DincludeScope=runtime -Dmdep.outputFile=target/cp.txt
java -cp "target/classes;$(cat target/cp.txt)" com.firmiana.matrix.Application

Run Tests

mvn test

Expected: 244 tests, 0 failures.

IDE Setup (IntelliJ IDEA)

Open the project as a Maven project
Enable annotation processing: Settings > Build > Compiler > Annotation Processors > Enable
Install the Lombok plugin if not already present
Import code style from the project settings (if available)

Project Structure

firmiana/
├── pom.xml                          # Maven build config
├── src/main/java/com/firmiana/matrix/
│   ├── Application.java             # Entry point
│   ├── config/                      # Configuration classes
│   ├── controller/                  # HTTP controllers (43+)
│   │   ├── auth/                    # Login, register, logout
│   │   ├── room/                    # Room operations
│   │   ├── user/                    # Profile, presence
│   │   ├── device/                  # Device management
│   │   └── media/                   # Media upload/download
│   ├── entity/                      # Data entities
│   ├── exception/                   # Error handling
│   ├── federation/                  # Server-Server API
│   ├── repository/                  # Data repositories
│   ├── request/                     # Request DTOs
│   ├── response/                    # Response DTOs
│   ├── security/                    # Auth, tokens, UIAA
│   └── service/                     # Business logic
├── src/main/resources/
│   ├── application.yml              # Configuration
│   ├── logback.xml                  # Logging config
│   └── db/migration/               # Flyway SQL migrations
├── src/test/java/                   # Test classes
├── docs/plan/                       # Implementation plans
└── data/                            # H2 database files (gitignored)

Key Dependencies

Dependency	Purpose
`micronaut-http-server-netty`	HTTP server
`micronaut-data-jdbc`	Data access
`micronaut-security`	Authentication
`h2`	Embedded database
`flyway-core`	Schema migrations
`lombok`	Code generation
`jackson-databind`	JSON serialization

#Development Setup

#Prerequisites

#Clone & Build

#Run

#Windows Classpath Approach

#Run Tests

#IDE Setup (IntelliJ IDEA)

#Project Structure

#Key Dependencies

Development Setup

Prerequisites

Clone & Build

Run

Windows Classpath Approach

Run Tests

IDE Setup (IntelliJ IDEA)

Project Structure

Key Dependencies