# yoshihirouehara3333/timesmanager architecture

> Architecture diagram of the GitHub repository yoshihirouehara3333/timesmanager, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-10-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/yoshihirouehara3333/timesmanager
- Repository: https://github.com/yoshihirouehara3333/timesmanager

## Overview

##### Project type and purpose
- This is a composite backend application consisting of:
- A SlackBot implemented as AWS Lambda functions in Node.js (under “slackbot/”)
- A Java Spring Boot REST API service (under “springboot/”)
- GitHub Actions–based CI/CD pipelines for dev and prod deployments
- Purpose: handle time-management commands from Slack users, process them in Lambda, and persist/query data via the Spring Boot API.

##### File structure
- Top-level directories:
- .github/workflows — GitHub Actions definitions (deploy_dev.yml, deploy_prod.yml, deploy_springboot_dev.yml)
- slackbot — Node.js Lambda source code and package.json
- springboot — Java backend API code
- Configuration/build scripts:
- package.json for Lambda dependencies and build scripts
- Maven/Gradle build files inside springboot (implied)
- Deployment manifests:
- GitHub Actions YAML files drive CI/CD for both Lambda and Spring Boot services

##### Key insights from the README
- Two distinct runtime environments: serverless (Lambda) and container/VM‐based (Spring Boot).
- CI/CD is handled via GitHub Actions workflows tailored for dev and prod targets.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Slack
    SlackUser["Slack User"]:::external
    SlackUser -->|"sends command"| APIGateway

    %% Serverless Zone
    subgraph "AWS Serverless"
        direction TB
        APIGateway["API Gateway"]:::compute
        SlackLambda["SlackBot Lambda"]:::compute
    end
    APIGateway -->|"invokes"| SlackLambda

    %% Managed Services Zone
    subgraph "AWS Managed Services"
        direction TB
        SpringAPI["Spring Boot API"]:::compute
        Database[(RDS/MySQL)]:::database
    end
    SlackLambda -->|"calls REST API"| SpringAPI
    SpringAPI -->|"read/write"| Database
    SpringAPI -->|"response"| SlackLambda
    SlackLambda -->|"formats reply"| SlackUser

    %% CI/CD Pipelines
    subgraph "CI/CD Pipelines"
        direction TB
        GitHubRepo["GitHub Repo"]:::external
        DeployDev["deploy_dev.yml"]:::cicd
        DeployProd["deploy_prod.yml"]:::cicd
        DeploySpringDev["deploy_springboot_dev.yml"]:::cicd
    end
    GitHubRepo --> DeployDev
    GitHubRepo --> DeployProd
    GitHubRepo --> DeploySpringDev
    DeployDev -->|"deploy SlackBot (dev)"| SlackLambda
    DeployProd -->|"deploy SlackBot (prod)"| SlackLambda
    DeploySpringDev -->|"deploy SpringBoot (dev)"| SpringAPI

    %% Documentation
    README["README.md"]:::docs
    GitHubRepo -->|"overview"| README

    %% Click Events
    click DeployDev "https://github.com/yoshihirouehara3333/timesmanager/blob/main/.github/workflows/deploy_dev.yml"
    click DeployProd "https://github.com/yoshihirouehara3333/timesmanager/blob/main/.github/workflows/deploy_prod.yml"
    click DeploySpringDev "https://github.com/yoshihirouehara3333/timesmanager/blob/main/.github/workflows/deploy_springboot_dev.yml"
    click README "https://github.com/yoshihirouehara3333/timesmanager/blob/main/README.md"

    %% Styles
    classDef compute fill:#cfe2f3,stroke:#0366d6,color:#0366d6;
    classDef database fill:#f3f0d7,stroke:#a67c00,color:#a67c00;
    classDef external fill:#e2e2e2,stroke:#666666,color:#333333,stroke-dasharray: 5 5;
    classDef cicd fill:#d1f2eb,stroke:#1abc9c,color:#1abc9c,stroke-dasharray: 2 2;
    classDef docs fill:#fdebd0,stroke:#d35400,color:#d35400;
```
