# harsha7475/floci architecture

> Architecture diagram of the GitHub repository harsha7475/floci, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/harsha7475/floci
- Repository: https://github.com/harsha7475/floci

## Overview

Floci is a local AWS emulator: clients send familiar AWS API requests to its local endpoint, service implementations emulate AWS operations, and state is retained by configurable storage. The README documents both in-process and Docker-backed services, including real container execution for selected compute and database workloads. The graph preserves the main service domains and shared protocol/storage layers. Some routing and service wiring is documented only at a high level; those edges cite the README rather than implying unsampled implementation details.

Main entry points: [`src/main/java/io/github/hectorvent/floci/config/EmulatorConfig.java`](https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/config/EmulatorConfig.java) (AWS HTTP endpoint), [`src/main/java/io/github/hectorvent/floci/core/storage`](https://github.com/harsha7475/floci/tree/main/src/main/java/io/github/hectorvent/floci/core/storage) (Configurable storage), [`src/main/java/io/github/hectorvent/floci/services/s3/S3Service.java`](https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/s3/S3Service.java) (S3), [`src/main/java/io/github/hectorvent/floci/services/dynamodb/DynamoDbService.java`](https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/dynamodb/DynamoDbService.java) (DynamoDB)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Request handling"]
  node_endpoint["AWS HTTP endpoint"]
end

subgraph group_shared["Shared runtime"]
  node_common["Protocol and context"]
  node_storage[("Configurable storage")]
  node_lifecycle["Lifecycle and hooks"]
end

subgraph group_app["Application APIs"]
  node_s3["S3<br/>[S3Service.java]"]
  node_dynamodb["DynamoDB"]
  node_messaging["Queues and events"]
  node_identity["Identity and security"]
end

subgraph group_infra["Infrastructure APIs"]
  node_api["API and GraphQL"]
  node_identity_services["Cognito and certificates"]
  node_network["Network and discovery"]
end

subgraph group_compute["Compute and data"]
  node_lambda["Lambda execution<br/>[LambdaService.java]"]
  node_containers["Container workloads<br/>[EcsService.java]"]
  node_rds["Relational databases"]
  node_neptune["Neptune graph"]
end

subgraph group_ops["Operations and analytics"]
  node_analytics["Analytics and costs<br/>[AthenaService.java]"]
  node_monitoring["Logs and metrics"]
  node_backup_config["Backup and config"]
end

node_client(("AWS SDK / CLI"))
node_docker{{"Docker Engine"}}

node_client -->|"sends AWS requests"| node_endpoint
node_endpoint -.->|"uses shared protocol"| node_common
node_endpoint -->|"routes requests"| node_s3
node_endpoint -->|"routes requests"| node_dynamodb
node_endpoint -->|"routes requests"| node_messaging
node_endpoint -->|"routes requests"| node_identity
node_endpoint -->|"routes requests"| node_api
node_endpoint -->|"routes requests"| node_identity_services
node_endpoint -->|"routes requests"| node_network
node_endpoint -->|"routes requests"| node_lambda
node_endpoint -->|"routes requests"| node_containers
node_endpoint -->|"routes requests"| node_rds
node_endpoint -->|"routes requests"| node_neptune
node_endpoint -->|"routes requests"| node_analytics
node_endpoint -->|"routes requests"| node_monitoring
node_endpoint -->|"routes requests"| node_backup_config
node_s3 -->|"uses storage"| node_storage
node_dynamodb -->|"uses storage"| node_storage
node_messaging -.->|"uses storage"| node_storage
node_identity -.->|"uses storage"| node_storage
node_containers -->|"runs workloads"| node_docker
node_lambda -->|"runs workloads"| node_docker
node_rds -->|"runs workloads"| node_docker
node_neptune -->|"runs workloads"| node_docker

click node_endpoint "https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/config/EmulatorConfig.java"
click node_common "https://github.com/harsha7475/floci/tree/main/src/main/java/io/github/hectorvent/floci/core/common"
click node_storage "https://github.com/harsha7475/floci/tree/main/src/main/java/io/github/hectorvent/floci/core/storage"
click node_lifecycle "https://github.com/harsha7475/floci/tree/main/src/main/java/io/github/hectorvent/floci/lifecycle"
click node_s3 "https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/s3/S3Service.java"
click node_dynamodb "https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/dynamodb/DynamoDbService.java"
click node_messaging "https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/sqs/SqsQueryHandler.java"
click node_identity "https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/iam/IamQueryHandler.java"
click node_api "https://github.com/harsha7475/floci/tree/main/src/main/java/io/github/hectorvent/floci/services/apigateway"
click node_identity_services "https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/cognito/CognitoService.java"
click node_network "https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/route53/Route53Service.java"
click node_lambda "https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/lambda/LambdaService.java"
click node_containers "https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/ecs/EcsService.java"
click node_rds "https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/rds/RdsQueryHandler.java"
click node_neptune "https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/neptune/NeptuneQueryHandler.java"
click node_analytics "https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/athena/AthenaService.java"
click node_monitoring "https://github.com/harsha7475/floci/tree/main/src/main/java/io/github/hectorvent/floci/services/cloudwatch"
click node_backup_config "https://github.com/harsha7475/floci/tree/main/src/main/java/io/github/hectorvent/floci/services/backup"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_endpoint toneBlue
class node_common,node_storage,node_lifecycle toneAmber
class node_s3,node_dynamodb,node_messaging,node_identity toneMint
class node_api,node_identity_services,node_network toneRose
class node_lambda,node_containers,node_rds,node_neptune,node_client,node_docker toneIndigo
class node_analytics,node_monitoring,node_backup_config toneTeal
```

## Components

### Request handling

- [AWS HTTP endpoint](https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/config/EmulatorConfig.java): `src/main/java/io/github/hectorvent/floci/config/EmulatorConfig.java`

### Shared runtime

- [Protocol and context](https://github.com/harsha7475/floci/tree/main/src/main/java/io/github/hectorvent/floci/core/common): `src/main/java/io/github/hectorvent/floci/core/common`
- [Configurable storage](https://github.com/harsha7475/floci/tree/main/src/main/java/io/github/hectorvent/floci/core/storage): `src/main/java/io/github/hectorvent/floci/core/storage`
- [Lifecycle and hooks](https://github.com/harsha7475/floci/tree/main/src/main/java/io/github/hectorvent/floci/lifecycle): `src/main/java/io/github/hectorvent/floci/lifecycle`

### Application APIs

- [S3](https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/s3/S3Service.java): `src/main/java/io/github/hectorvent/floci/services/s3/S3Service.java`
- [DynamoDB](https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/dynamodb/DynamoDbService.java): `src/main/java/io/github/hectorvent/floci/services/dynamodb/DynamoDbService.java`
- [Queues and events](https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/sqs/SqsQueryHandler.java): `src/main/java/io/github/hectorvent/floci/services/sqs/SqsQueryHandler.java`
- [Identity and security](https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/iam/IamQueryHandler.java): `src/main/java/io/github/hectorvent/floci/services/iam/IamQueryHandler.java`

### Infrastructure APIs

- [API and GraphQL](https://github.com/harsha7475/floci/tree/main/src/main/java/io/github/hectorvent/floci/services/apigateway): `src/main/java/io/github/hectorvent/floci/services/apigateway`
- [Cognito and certificates](https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/cognito/CognitoService.java): `src/main/java/io/github/hectorvent/floci/services/cognito/CognitoService.java`
- [Network and discovery](https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/route53/Route53Service.java): `src/main/java/io/github/hectorvent/floci/services/route53/Route53Service.java`

### Compute and data

- [Lambda execution](https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/lambda/LambdaService.java): `src/main/java/io/github/hectorvent/floci/services/lambda/LambdaService.java`
- [Container workloads](https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/ecs/EcsService.java): `src/main/java/io/github/hectorvent/floci/services/ecs/EcsService.java`
- [Relational databases](https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/rds/RdsQueryHandler.java): `src/main/java/io/github/hectorvent/floci/services/rds/RdsQueryHandler.java`
- [Neptune graph](https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/neptune/NeptuneQueryHandler.java): `src/main/java/io/github/hectorvent/floci/services/neptune/NeptuneQueryHandler.java`

### Operations and analytics

- [Analytics and costs](https://github.com/harsha7475/floci/blob/main/src/main/java/io/github/hectorvent/floci/services/athena/AthenaService.java): `src/main/java/io/github/hectorvent/floci/services/athena/AthenaService.java`
- [Logs and metrics](https://github.com/harsha7475/floci/tree/main/src/main/java/io/github/hectorvent/floci/services/cloudwatch): `src/main/java/io/github/hectorvent/floci/services/cloudwatch`
- [Backup and config](https://github.com/harsha7475/floci/tree/main/src/main/java/io/github/hectorvent/floci/services/backup): `src/main/java/io/github/hectorvent/floci/services/backup`

### Other components

- **AWS SDK / CLI**
- **Docker Engine**

## Connections

- AWS SDK / CLI → AWS HTTP endpoint: sends AWS requests (evidence: `README.md`)
- AWS HTTP endpoint → Protocol and context: uses shared protocol (evidence: `src/main/java/io/github/hectorvent/floci/core/common/RegionResolver.java`)
- AWS HTTP endpoint → S3: routes requests (evidence: `README.md`)
- AWS HTTP endpoint → DynamoDB: routes requests (evidence: `README.md`)
- AWS HTTP endpoint → Queues and events: routes requests (evidence: `README.md`)
- AWS HTTP endpoint → Identity and security: routes requests (evidence: `README.md`)
- AWS HTTP endpoint → API and GraphQL: routes requests (evidence: `README.md`)
- AWS HTTP endpoint → Cognito and certificates: routes requests (evidence: `README.md`)
- AWS HTTP endpoint → Network and discovery: routes requests (evidence: `README.md`)
- AWS HTTP endpoint → Lambda execution: routes requests (evidence: `README.md`)
- AWS HTTP endpoint → Container workloads: routes requests (evidence: `README.md`)
- AWS HTTP endpoint → Relational databases: routes requests (evidence: `README.md`)
- AWS HTTP endpoint → Neptune graph: routes requests (evidence: `README.md`)
- AWS HTTP endpoint → Analytics and costs: routes requests (evidence: `README.md`)
- AWS HTTP endpoint → Logs and metrics: routes requests (evidence: `README.md`)
- AWS HTTP endpoint → Backup and config: routes requests (evidence: `README.md`)
- S3 → Configurable storage: uses storage (evidence: `README.md`)
- DynamoDB → Configurable storage: uses storage (evidence: `README.md`)
- Queues and events → Configurable storage: uses storage
- Identity and security → Configurable storage: uses storage
- Container workloads → Docker Engine: runs workloads (evidence: `README.md`)
- Lambda execution → Docker Engine: runs workloads (evidence: `README.md`)
- Relational databases → Docker Engine: runs workloads (evidence: `README.md`)
- Neptune graph → Docker Engine: runs workloads (evidence: `README.md`)
