Explore Influent Codebase

This skill helps you navigate and work with the Influent visual analytics application codebase, a large-scale transaction flow visualization system built with Java (backend) and JavaScript (frontend).

What This Skill Does

Provides comprehensive guidance for understanding, building, testing, and modifying the Influent application — a web-based system for exploring transaction patterns across millions of entities and hundreds of millions of transactions.

Step-by-Step Instructions

1. Understand the Project Architecture

**Review the technology stack:**

**Identify the modular structure:**

```

influent-spi/ # Service Provider Interfaces (Avro definitions)

influent-server/ # Java server implementation

influent-client/ # JavaScript client (influent-clientjs)

influent-app/ # Generic example application

bitcoin/kiva/walker/ # Domain-specific example apps

docs/ # Documentation site

```

2. Build the Project

**Full build with tests:**

```bash

mvn clean install

```

**Quick build (skip tests):**

```bash

mvn clean install -DskipTests

```

**Build and run specific example app:**

```bash

cd influent-app && mvn package jetty:run

Access at http://localhost:8080/influent/

cd bitcoin && mvn package jetty:run

Access at http://localhost:8080/bitcoin/

cd kiva && mvn package jetty:run

Access at http://localhost:8080/kiva/

cd walker && mvn package jetty:run

Access at http://localhost:8080/walker/

```

3. Locate Key Code Components

**Server-side REST API:**

```

influent-server/src/main/java/influent/server/rest/

```

**Data access layer:**

```

influent-server/src/main/java/influent/server/dataaccess/

```

**Clustering algorithms:**

```

influent-server/src/main/java/influent/server/clustering/

```

**Search implementations:**

```

influent-server/src/main/java/influent/server/search/

```

**Client JavaScript:**

```

influent-client/influent-clientjs/src/scripts/

```

**SPI (Service Provider Interface) schemas:**

```

influent-spi/src/main/avro/

```

4. Run Tests

**Run all unit tests:**

```bash

mvn test

```

**Run tests for specific module:**

```bash

cd influent-server && mvn test

```

**Run Selenium UI tests:**

```bash

cd influent-selenium-test && mvn test

```

**Client-side tests location:**

```

influent-client/influent-clientjs/test/

```

5. Configure the Application

**Server configuration:**

```

*/src/main/resources/server-config.xml

```

**Client configuration:**

```

*/src/main/resources/client-config.js

```

**Database configuration:**

Check `pom.xml` in each app directory

**Clustering configuration:**

```

influent-server/src/main/resources/influent/server/clustering/

```

6. Understand the SPI Framework

The Service Provider Interface allows plugin-style modules for:

SPIs are defined in Apache Avro format and can be implemented as:

**Key SPI files:**

7. Work with Example Applications

The codebase includes four example domains:

1. **influent-app** - Generic demonstration

2. **bitcoin** - Bitcoin transaction flow analysis

3. **kiva** - Kiva microloan network visualization

4. **walker** - Email communication pattern analysis

Each app demonstrates different data types and use cases for the Influent platform.

Usage Examples

**Explore REST endpoints:**

```bash

Search the REST API implementation

grep -r "@Path" influent-server/src/main/java/influent/server/rest/

```

**Find clustering algorithm implementations:**

```bash

ls influent-server/src/main/java/influent/server/clustering/

```

**Examine Avro SPI definitions:**

```bash

cat influent-spi/src/main/avro/DataAccess_v2.0.avdl

```

**Check external dependencies:**

```bash

Review Aperture JS version requirement

grep "<aperture.version>" pom.xml

```

Important Notes

Constraints