Skip to content
BranchesTags

Repository files navigation

Growth Forge Platform

AI-Powered Marketing Operating System

Version: Phase 1 Foundation

1. Overview

Growth Forge is an AI-native marketing intelligence platform designed to automate and optimize digital marketing workflows.

The vision is to build an enterprise-grade system that combines:

  • SEO intelligence
  • Content automation
  • Marketing campaign management
  • Competitor analysis
  • AI agents
  • Analytics
  • Autonomous marketing workflows

Growth Forge is designed as a platform where humans and AI agents collaborate to execute marketing strategies.

2. Product Vision

Growth Forge is built around a central concept:

Project Knowledge → AI Intelligence → Marketing Execution → Analytics Feedback

Every business, brand, website, campaign, keyword, and content asset becomes part of a connected knowledge system.

Future AI agents will use this knowledge to:

  • Analyze competitors
  • Discover keywords
  • Generate content strategies
  • Optimize SEO
  • Create campaigns
  • Monitor performance
  • Recommend actions

3. Current Implementation Status

Phase 1 Foundation Completed

Implemented:

  • Spring Boot enterprise foundation
  • Common architecture layer
  • Database auditing framework
  • Standard API response model
  • Exception handling framework
  • Repository abstraction
  • Service abstraction
  • Project management module foundation
  • Flyway database migration setup

4. High Level Architecture (HLD)

Architecture Style

Growth Forge follows a:

Modular Monolith Architecture

The initial implementation uses a single Spring Boot application with clearly separated business modules.

This allows:

  • Faster development
  • Easier maintenance
  • Clear domain boundaries
  • Future microservice migration

Future Architecture

                    API Gateway

                         |

              Growth Forge Platform

                         |

 ------------------------------------------------

 Project Engine
 Brand Engine
 SEO Engine
 Content Engine
 Marketing Engine
 AI Engine
 Analytics Engine
 Automation Engine

 ------------------------------------------------

                         |

             PostgreSQL + Vector Database

                         |

                Local / Cloud AI Models

5. Technology Stack

Backend

  • Java 21+
  • Spring Boot 3.x
  • Spring Data JPA
  • Spring Security
  • Hibernate
  • Lombok
  • MapStruct
  • Bean Validation

Database

  • PostgreSQL
  • Flyway Migration
  • Future pgvector integration

AI Layer

Planned:

  • Ollama
  • Local LLM models
  • Embedding models
  • Retrieval Augmented Generation (RAG)
  • AI Agents

Frontend

Current:

  • Thymeleaf
  • Bootstrap

Future:

  • React
  • Modern SPA dashboard

6. Project Structure

growthforgeplatform

common
 |
 ├── config
 ├── entity
 ├── enums
 ├── exception
 ├── repository
 ├── response
 ├── service
 └── util


project
 |
 ├── controller
 ├── dto
 ├── entity
 ├── mapper
 ├── repository
 └── service

7. Common Framework Layer

The common module provides reusable enterprise components.

BaseEntity

Location:

common/entity/BaseEntity

Purpose:

Every database entity inherits common fields.

Fields:

id
createdAt
updatedAt
createdBy
updatedBy
version
deleted
active

Benefits:

  • Audit tracking
  • Soft delete
  • Optimistic locking
  • Future AI actor tracking

8. Auditing Framework

Implemented using:

Spring Data JPA Auditing

Components:

AuditingConfig

ApplicationAuditorAware

BaseEntity

Automatically manages:

created_at
updated_at
created_by
updated_by

Current default actor:

system

Future:

human user
marketing agent
seo agent
automation service

9. API Response Architecture

All APIs follow a common response model.

Example:

{
 "success": true,
 "message": "Operation successful",
 "data": {}
}

Implemented:

ApiResponse

PageResponse

ErrorResponse

10. Exception Handling

Centralized using:

@RestControllerAdvice

Implemented exceptions:

BusinessException

ResourceNotFoundException

All errors return standardized responses.

11. Repository Architecture

Implemented:

BaseRepository

Provides:

  • Standard CRUD
  • Soft delete support
  • Active record filtering

Example:

ProjectRepository extends BaseRepository

12. Service Architecture

Implemented:

BaseService
BaseServiceImpl

Purpose:

Provide consistent business layer patterns.

Every future module follows:

Controller

     |

Service

     |

Repository

     |

Database

13. Project Module

The Project module is the first business domain.

A Project represents a marketing initiative.

Examples:

Growth Forge Marketing Platform

YouTube Channel Growth

SEO Campaign

Brand Marketing Project

14. Project Entity

Table:

projects

Fields:

id
name
slug
description
website
industry
country
language
timezone
currency
status

created_at
updated_at
created_by
updated_by
version
deleted
active

15. Project APIs

Implemented endpoints:

Create Project

POST /api/projects

Get All Projects

GET /api/projects

Get Project

GET /api/projects/{id}

Update Project

PUT /api/projects/{id}

Delete Project

DELETE /api/projects/{id}

16. Project Business Logic

Implemented:

Slug Generation

Example:

Input:

Growth Forge AI Marketing Platform

Generated:

growth-forge-ai-marketing-platform

Duplicate Protection

Projects cannot have duplicate slugs.

Soft Delete

Deletion does not remove data.

Instead:

deleted=true

This preserves history.

17. Database Management

Database changes are controlled by Flyway.

Migration structure:

db/migration

V1__create_projects_table.sql

V2__add_audit_user_columns.sql

Hibernate mode:

ddl-auto=validate

Database schema is controlled only by migrations.

18. Low Level Design (LLD)

Project Request Flow

HTTP Request

     |

ProjectController

     |

ProjectService

     |

ProjectMapper

     |

ProjectEntity

     |

Repository

     |

PostgreSQL

Response Flow

Database

   |

Entity

   |

Mapper

   |

Response DTO

   |

API Response

19. Future Roadmap

Phase 2 - Brand Intelligence

Entity Relationship

Project | | 1 | +----------------------1 | BrandProfile | ----------------------------------- | | | | | | | | BrandVoice Audience Products BusinessGoals

Domain model

Project (Aggregate Root) │ └── Brand (Aggregate Root) | │ | ├── BrandProfile (1:1) | ├── BrandVoice (1:1) | ├── TargetAudience (1:N) | ├── ProductService (1:N) | ├── BusinessGoal (1:N) | ├── Competitor (1:N) | │ | └── BrandKnowledgeService │ ├── Website (1:N) ├── SEO (1:N) ├── Content (1:N) └── Campaign (1:N)

Tables:

  • brand_profile
  • brand_voice
  • target_audience
  • products
  • customer_personas

Features:

  • Brand knowledge base
  • AI brand understanding

Table:

brand_profile

Fields:

id
name
slug
description

Table: brand_voice

Fields:

id
brand_id
tone
writing_style
reading_level
preferred_pronouns
avoid_words
preferred_words
emoji_usage
call_to_action_style
communication_style

Table: target_audience

Fields:

id
brand_id
persona_name
age_group
occupation
industry
pain_points
goals
interests
preferred_channels
country
language

Table: product_service

Fields:

id
brand_id
name
category
description
price
target_customer
unique_selling_points
status

Table: business_goal

Fields:

id
brand_id
goal_type
description
target_value
current_value
target_date

APIs

Brand Profile

POST /api/brands

GET /api/brands/{id}

PUT /api/brands/{id}

DELETE /api/brands/{id}

Brand Voice

POST /api/brands/{id}/voice

GET /api/brands/{id}/voice

Audience

POST /api/brands/{id}/audience

GET /api/brands/{id}/audience

Products

POST /api/brands/{id}/products

GET /api/brands/{id}/products

AI Usage

Every AI prompt will automatically include the brand profile. Example:

System Prompt

Brand Name: Growth Forge

Industry: AI Marketing

Tone: Professional

Audience: Marketing Managers

Mission: Simplify AI-powered marketing automation.

Products: Growth Forge Platform

Phase 3 - Website Intelligence

Features:

  • Website management
  • Crawling
  • SEO audit
  • Technical analysis

Tables:

  • websites
  • website_pages
  • seo_audit
  • broken_links

Phase 4 - SEO Engine

Features:

  • Keyword research
  • Competitor analysis
  • Ranking tracking
  • Topic clusters

Tables:

  • keywords
  • keyword_clusters
  • backlinks
  • rankings

Phase 5 - Content Engine

Features:

  • AI article generation
  • Social posts
  • Video scripts
  • Content calendar

Tables:

  • content
  • content_versions
  • templates

Phase 6 - Marketing Automation

Features:

  • Campaign management
  • Funnels
  • Email automation
  • Customer journeys

Phase 7 - AI Agent Platform

AI Agents:

SEO Agent

Responsibilities:

  • Keyword discovery
  • Ranking analysis
  • SEO recommendations

Content Agent

Responsibilities:

  • Generate articles
  • Optimize content

Marketing Agent

Responsibilities:

  • Campaign planning
  • Audience targeting

Analytics Agent

Responsibilities:

  • Performance monitoring
  • Recommendations

Phase 8 - Analytics Platform

Integrations:

  • Google Analytics
  • Search Console
  • YouTube Analytics
  • Social platforms
  • Advertising platforms

20. Long Term Vision

Growth Forge becomes an autonomous marketing operating system.

The final architecture:

Business Knowledge

        |

AI Agents

        |

Marketing Actions

        |

Performance Data

        |

Continuous Optimization

The platform continuously learns and improves marketing outcomes.

Development Philosophy

Growth Forge follows:

  • Domain-driven design
  • Clean architecture
  • Enterprise Java practices
  • AI-first design
  • Open-source technology
  • Local AI capability
  • Extensible modules

CI/CD Architecture

                GitHub
                   │
                   │
         ┌─────────┴─────────┐
         │                   │
         ▼                   ▼
    Pull Request          develop push
         │                   │
         ▼                   ▼
    CI Workflow         CI Workflow
         │                   │
         ▼                   ▼
   Self-Hosted Mac      Self-Hosted Mac
         │                   │
         ▼                   ▼
   Maven Verify         Maven Verify
         │                   │
         ├── Unit Tests      ├── Unit Tests
         │                   ├── Integration Tests
         │                   │     ├── PostgreSQL
         │                   │     ├── Redis
         │                   │     └── Flyway
         │                   │
         └── Integration     └── Docker Build
             Tests                  │
                                    ▼
                                Docker Compose
                                    │
                        ┌────────────┼────────────┐
                        │            │            │
                        ▼            ▼            ▼
                    PostgreSQL     Redis       Spring Boot
                        │            │            │
                        │            │            ▼
                        │            │       Health Check
                        │            │            │
                        └────────────┴────────────┘
                                    │
                                    ▼
                            Local Deployment
    #

About

Growth Forge is an production-oriented AI marketing platform using Domain-Driven Design principles. The platform is built using Spring Boot and Java, with PostgreSQL as the primary relational database, Redis for caching, Docker for containerization, Kubernetes for orchestration, and CI/CD automation.

Topics

data-jpaflyway-migrationshibernatejava-21lombokmavenpostgresqlspring-bootspring-security

Resources

Readme
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages