MX-263: Create Offices Self Service endpoints

Author: IOhacker

AGENTS.md

@@ -61,7 +61,7 @@ Copy JAR to $TOMCAT_HOME/webapps/fineract-provider/WEB-INF/lib/
 
 ### File Structure
 ```text
-src/main/java/org/apache/fineract/selfservice/
+src/main/java/org/apache/fineract/savings/
   - security/          # Authentication and authorization
   - useradministration/ # User management
   - client/           # Client operations
@@ -152,7 +152,7 @@ public class ExampleDataValidator {
 
 ## Debugging Tips
 
-- Enable debug logging: `logging.level.org.apache.fineract.selfservice=DEBUG`
+- Enable debug logging: `logging.level.org.apache.fineract.savings=DEBUG`
 - Use Spring Boot Actuator endpoints for monitoring
 - Check application logs for security-related issues
 - Verify database migrations in development

CONTRIBUTING.md

@@ -18,8 +18,8 @@ Thank you for your interest in contributing! This guide will get you set up and
 ### Build
 
 ```bash
-git clone https://github.com/openMF/selfservice-plugin.git
-cd selfservice-plugin
+git clone https://github.com/openMF/savings-plugin.git
+cd savings-plugin
 ./mvnw clean package -Dmaven.test.skip=true
 ```
 
@@ -33,14 +33,14 @@ If you're building a project that depends on this plugin:
 ```xml
 <dependency>
     <groupId>community.mifos</groupId>
-    <artifactId>selfservice-plugin</artifactId>
+    <artifactId>savings-plugin</artifactId>
     <version>1.15.0-SNAPSHOT</version>
 </dependency>
 ```
 
 **Gradle:**
 ```groovy
-implementation 'community.mifos:selfservice-plugin:1.15.0-SNAPSHOT'
+implementation 'community.mifos:savings-plugin:1.15.0-SNAPSHOT'
 ```
 
 ---

README.md

@@ -1,6 +1,6 @@
 # Mifos® Self Service Plugin for Apache Fineract®
 
-[![Java CI](https://github.com/openMF/selfservice-plugin/actions/workflows/maven-build.yml/badge.svg)](https://github.com/openMF/selfservice-plugin/actions/workflows/maven-build.yml)
+[![Java CI](https://github.com/openMF/savings-plugin/actions/workflows/maven-build.yml/badge.svg)](https://github.com/openMF/savings-plugin/actions/workflows/maven-build.yml)
 [![License: MPL 2.0](https://img.shields.io/badge/License-MPL_2.0-brightgreen.svg)](https://opensource.org/licenses/MPL-2.0)
 ![Java 21](https://img.shields.io/badge/Java-21-blue)
 ![Spring Boot 3](https://img.shields.io/badge/Spring_Boot-3-6DB33F)
@@ -103,12 +103,12 @@ Apache Fineract is an open-source core banking platform. Out of the box, its API
 ### Build from Source
 
 ```bash
-git clone https://github.com/openMF/selfservice-plugin.git
-cd selfservice-plugin
+git clone https://github.com/openMF/savings-plugin.git
+cd savings-plugin
 ./mvnw clean package -Dmaven.test.skip=true
 ```
 
-This produces a JAR at `target/selfservice-plugin-1.15.0-SNAPSHOT.jar`.
+This produces a JAR at `target/savings-plugin-1.15.0-SNAPSHOT.jar`.
 
 ### Deploy with Fineract (Docker)
 
@@ -117,7 +117,7 @@ This produces a JAR at `target/selfservice-plugin-1.15.0-SNAPSHOT.jar`.
 mkdir -p /opt/fineract/plugins
 
 # Copy the built plugin
-cp target/selfservice-plugin-*.jar /opt/fineract/plugins/
+cp target/savings-plugin-*.jar /opt/fineract/plugins/
 
 # Start Fineract with the plugin on the classpath
 java -Dloader.path=/opt/fineract/plugins/ -jar fineract-provider.jar
@@ -127,7 +127,7 @@ java -Dloader.path=/opt/fineract/plugins/ -jar fineract-provider.jar
 
 ```bash
 # Copy the JAR into Fineract's library directory
-cp target/selfservice-plugin-*.jar $TOMCAT_HOME/webapps/fineract-provider/WEB-INF/lib/
+cp target/savings-plugin-*.jar $TOMCAT_HOME/webapps/fineract-provider/WEB-INF/lib/
 
 # Restart Tomcat
 $TOMCAT_HOME/bin/shutdown.sh && $TOMCAT_HOME/bin/startup.sh
@@ -139,7 +139,7 @@ The plugin auto-registers its endpoints, runs its own Liquibase migrations again
 
 Pre-built snapshots are published to JFrog Artifactory:
 
-👉 [Download latest JAR](https://mifos.jfrog.io/ui/native/libs-snapshot-local/community/mifos/selfservice-plugin/1.15.0-SNAPSHOT/)
+👉 [Download latest JAR](https://mifos.jfrog.io/ui/native/libs-snapshot-local/community/mifos/savings-plugin/1.15.0-SNAPSHOT/)
 
 ## API Reference
 

TESTING.md

@@ -1,4 +1,4 @@
-# Testing Guide — Selfservice Plugin
+# Testing Guide — Savings Plugin
 
 ## Test Pyramid
 
@@ -19,7 +19,7 @@ Tier 1 │ *Test.java             │ Mockito unit tests
 ./mvnw clean verify
 
 # Run a single integration test class
-./mvnw verify -Dit.test=SelfServiceAuthenticationIntegrationTest
+./mvnw verify -Dit.test=AuthenticationIntegrationTest
 
 # Skip spotless formatting check (useful during local development)
 ./mvnw verify -Dspotless.check.skip=true
@@ -42,15 +42,15 @@ Coverage reports are written to:
 ## Adding a New Integration Test
 
 1. Create your test file with the `*IntegrationTest.java` suffix.
-2. Extend `SelfServiceIntegrationTestBase`.
-3. Inject `@LocalServerPort int port` and use `SelfServiceTestUtils.requestSpec(port)` for RestAssured calls.
+2. Extend `SavingsIntegrationTestBase`.
+3. Inject `@LocalServerPort int port` and use `SavingsTestUtils.requestSpec(port)` for RestAssured calls.
 
 ```java
-class MyFeatureIntegrationTest extends SelfServiceIntegrationTestBase {
+class MyFeatureIntegrationTest extends SavingsIntegrationTestBase {
 
     @Test
     void myEndpoint_withNoAuth_returns401() {
-        given(SelfServiceTestUtils.requestSpec(port))
+        given(SavingsTestUtils.requestSpec(port))
             .when().get("/api/v1/self/my-endpoint")
             .then().statusCode(401);
     }

agent.yaml

@@ -9,8 +9,8 @@ domain: "banking-fintech"
 framework: "spring-ai-agent-skills"
 
 # Agent identification
-agent_id: "mifos-selfservice-plugin"
-namespace: "org.apache.fineract.selfservice"
+agent_id: "mifos-savings-plugin"
+namespace: "org.apache.fineract.savings"
 
 # Runtime configuration
 runtime:
@@ -77,7 +77,7 @@ features:
 
 # Development metadata
 repository:
-  url: "https://github.com/openMF/selfservice-plugin"
+  url: "https://github.com/openMF/savings-plugin"
   license: "MPL-2.0"
   organization: "Mifos Initiative"
 

pom.xml

@@ -9,7 +9,7 @@
     <!-- lookup parent from repository -->
   </parent>
   <groupId>community.mifos</groupId>
-  <artifactId>selfservice-plugin</artifactId>
+  <artifactId>savings-plugin</artifactId>
   <version>1.15.0-SNAPSHOT</version>
   <name>savings-plugin</name>
   <description>Mifos Savings Plugin for Apache Fineract</description>

skills.md

@@ -22,13 +22,13 @@ All Java files must include the standard MPL-2.0 license header:
  * License, v. 2.0. If a copy of the MPL was not distributed with this
  * file, You can obtain one at https://mozilla.org/MPL/2.0/.
  */
-package org.apache.fineract.selfservice.example;
+package org.apache.fineract.savings.example;
 ```
 
 ### Package Structure
 Follow the established package structure:
 ```text
-org.apache.fineract.selfservice.*
+org.apache.fineract.savings.*
   - security/           # Authentication, authorization, security context
   - useradministration/ # User management and roles
   - client/            # Client operations and data
@@ -108,10 +108,10 @@ Inject and use the security context properly:
 ```java
 @RequiredArgsConstructor
 public class SelfSavingsService {
-    private final PlatformSelfServiceSecurityContext securityContext;
+    private final PlatformSecurityContext securityContext;
 
     public void validateAccess(Long accountId) {
-        securityContext.validateSelfServiceUserAccess(accountId);
+        securityContext.validateUserAccess(accountId);
     }
 }
 ```
@@ -251,7 +251,7 @@ class SelfSavingsServiceImplTest {
 @SpringBootTest
 @AutoConfigureTestDatabase(replace = AutoConfigureTestDatabase.Replace.NONE)
 @Testcontainers
-class SelfSavingsApiResourceIntegrationTest extends SelfServiceIntegrationTestBase {
+class SavingsApiResourceIntegrationTest extends IntegrationTestBase {
 
     @Container
     static PostgreSQLContainer<?> postgres = new PostgreSQLContainer<>("postgres:15")
@@ -272,8 +272,8 @@ class SelfSavingsApiResourceIntegrationTest extends SelfServiceIntegrationTestBa
 ### Application Properties
 ```properties
 # Self Service Plugin Configuration
-fineract.selfservice.enabled=true
-fineract.selfservice.base-path=/v1/self
+fineract.savings.enabled=true
+fineract.savings.base-path=/v1/self
 fineract.security.basicauth.enabled=true
 fineract.security.oauth.enabled=false
 ```
@@ -282,10 +282,10 @@ fineract.security.oauth.enabled=false
 ```java
 @Configuration
 @EnableWebSecurity
-public class SelfServiceSecurityConfig {
+public class SecurityConfig {
 
     @Bean
-    public SecurityFilterChain selfServiceFilterChain(HttpSecurity http) throws Exception {
+    public SecurityFilterChain filterChain(HttpSecurity http) throws Exception {
         // Security configuration
     }
 }