# aws13th-final-project-bada/bada architecture

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

- Interactive diagram: https://gitdiagram.com/aws13th-final-project-bada/bada
- Repository: https://github.com/aws13th-final-project-bada/bada

## Overview

BADA turns worker evidence uploads into structured, rule-checked case findings and a consultation-ready PDF pack, then offers multilingual next-step guidance. Its primary flow is mobile evidence intake → API storage and queued analysis → OCR/STT and deterministic analysis → persisted results/report. Separate product branches provide AI/RAG chat, community, Kakao diagnosis, GPS work evidence, notifications, and authentication. The README documents capabilities whose exact internal wiring was not sampled; those components are retained, while unsupported connections are omitted.

Main entry points: [`backend/app/main.py`](https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/main.py) (API server), [`worker/consumer.py`](https://github.com/aws13th-final-project-bada/bada/blob/main/worker/consumer.py) (Worker), [`worker/pipeline.py`](https://github.com/aws13th-final-project-bada/bada/blob/main/worker/pipeline.py) (Case analysis), [`backend/app/routers/evidences.py`](https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/routers/evidences.py) (Evidence intake)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Mobile experience"]
  node_mobile["Mobile app<br/>[index.tsx]"]
end

subgraph group_api["API and case data"]
  node_server["API server<br/>[main.py]"]
  node_db[("Case database<br/>[db.py]")]
  node_models["Case records<br/>[models.py]"]
  node_auth["Social authentication<br/>[auth.py]"]
  node_cases["Case management<br/>[cases.py]"]
  node_evidence["Evidence intake<br/>[evidences.py]"]
  node_storage["Evidence storage<br/>[storage.py]"]
  node_gps["GPS work evidence<br/>[gps.py]"]
  node_notifications["Notifications<br/>[notifications.py]"]
end

subgraph group_analysis["Evidence analysis"]
  node_worker["Worker<br/>[consumer.py]"]
  node_queue["Analysis queue<br/>[queue.py]"]
  node_analysis_api["Analysis dispatch<br/>[analysis.py]"]
  node_extract["Evidence extraction<br/>[extract.py]"]
  node_ocr["Document OCR<br/>[ocr.py]"]
  node_transcribe["Audio transcription<br/>[transcribe.py]"]
  node_pipeline["Case analysis<br/>[pipeline.py]"]
  node_rules["Rules engine"]
  node_timeline["Timeline builder<br/>[timeline.py]"]
  node_translate["Translation<br/>[translate.py]"]
  node_report["Evidence Pack PDF<br/>[pdf_generator.py]"]
end

subgraph group_guidance["Guidance and community"]
  node_chat["AI chat API<br/>[ai_chat.py]"]
  node_orchestrator["Chat orchestration"]
  node_rag["RAG retrieval<br/>[rag_retriever.py]"]
  node_chat_llm["Chat answer generation<br/>[llm_service.py]"]
  node_community["Community<br/>[community.py]"]
  node_kakao["Kakao chatbot<br/>[kakao.py]"]
end

node_user(("Worker"))
node_bedrock{{"Amazon Bedrock"}}
node_s3[("Amazon S3")]
node_sqs["Amazon SQS"]

node_user -->|"uses"| node_mobile
node_mobile -.->|"calls API"| node_server
node_server -->|"routes"| node_auth
node_server -->|"routes"| node_cases
node_server -->|"routes"| node_evidence
node_server -->|"routes"| node_analysis_api
node_server -->|"routes"| node_chat
node_server -->|"routes"| node_community
node_server -->|"routes"| node_gps
node_server -->|"routes"| node_kakao
node_server -->|"routes"| node_notifications
node_evidence -.->|"stores files"| node_storage
node_evidence -.->|"records evidence"| node_db
node_analysis_api -->|"enqueues work"| node_queue
node_queue -.->|"sends message"| node_sqs
node_sqs -.->|"delivers job"| node_worker
node_worker -->|"loads and saves"| node_db
node_worker -->|"reads evidence"| node_s3
node_worker -->|"structures text"| node_extract
node_worker -->|"extracts images"| node_ocr
node_worker -.->|"transcribes audio"| node_transcribe
node_worker -->|"analyzes case"| node_pipeline
node_pipeline -->|"applies rules"| node_rules
node_pipeline -->|"builds timeline"| node_timeline
node_pipeline -->|"builds translations"| node_translate
node_pipeline -->|"extracts images"| node_ocr
node_pipeline -.->|"builds report"| node_report
node_chat -->|"delegates chat"| node_orchestrator
node_orchestrator -.->|"retrieves context"| node_rag
node_orchestrator -.->|"generates answer"| node_chat_llm
node_chat_llm -->|"invokes model"| node_bedrock

click node_worker "https://github.com/aws13th-final-project-bada/bada/blob/main/worker/consumer.py"
click node_mobile "https://github.com/aws13th-final-project-bada/bada/blob/main/mobile-native/app/index.tsx"
click node_server "https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/main.py"
click node_db "https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/db.py"
click node_models "https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/models.py"
click node_auth "https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/routers/auth.py"
click node_cases "https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/routers/cases.py"
click node_evidence "https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/routers/evidences.py"
click node_storage "https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/services/storage.py"
click node_queue "https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/services/queue.py"
click node_analysis_api "https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/routers/analysis.py"
click node_extract "https://github.com/aws13th-final-project-bada/bada/blob/main/worker/services/extract.py"
click node_ocr "https://github.com/aws13th-final-project-bada/bada/blob/main/worker/providers/ocr.py"
click node_transcribe "https://github.com/aws13th-final-project-bada/bada/blob/main/worker/providers/transcribe.py"
click node_pipeline "https://github.com/aws13th-final-project-bada/bada/blob/main/worker/pipeline.py"
click node_rules "https://github.com/aws13th-final-project-bada/bada/tree/main/worker/rules"
click node_timeline "https://github.com/aws13th-final-project-bada/bada/blob/main/worker/services/timeline.py"
click node_translate "https://github.com/aws13th-final-project-bada/bada/blob/main/worker/providers/translate.py"
click node_report "https://github.com/aws13th-final-project-bada/bada/blob/main/worker/services/pdf_generator.py"
click node_chat "https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/routers/ai_chat.py"
click node_orchestrator "https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/services/ai_chat_orchestrator.py"
click node_rag "https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/services/rag_retriever.py"
click node_chat_llm "https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/services/llm_service.py"
click node_community "https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/routers/community.py"
click node_kakao "https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/routers/kakao.py"
click node_gps "https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/routers/gps.py"
click node_notifications "https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/routers/notifications.py"

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_mobile toneBlue
class node_server,node_db,node_models,node_auth,node_cases,node_evidence,node_storage,node_gps,node_notifications,node_s3 toneAmber
class node_worker,node_queue,node_analysis_api,node_extract,node_ocr,node_transcribe,node_pipeline,node_rules,node_timeline,node_translate,node_report toneMint
class node_chat,node_orchestrator,node_rag,node_chat_llm,node_community,node_kakao,node_user toneRose
class node_bedrock,node_sqs toneIndigo
```

## Components

### Mobile experience

- [Mobile app](https://github.com/aws13th-final-project-bada/bada/blob/main/mobile-native/app/index.tsx): `mobile-native/app/index.tsx`

### API and case data

- [API server](https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/main.py): `backend/app/main.py`
- [Case database](https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/db.py): `backend/app/db.py`
- [Case records](https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/models.py): `backend/app/models.py`
- [Social authentication](https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/routers/auth.py): `backend/app/routers/auth.py`
- [Case management](https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/routers/cases.py): `backend/app/routers/cases.py`
- [Evidence intake](https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/routers/evidences.py): `backend/app/routers/evidences.py`
- [Evidence storage](https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/services/storage.py): `backend/app/services/storage.py`
- [GPS work evidence](https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/routers/gps.py): `backend/app/routers/gps.py`
- [Notifications](https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/routers/notifications.py): `backend/app/routers/notifications.py`

### Evidence analysis

- [Worker](https://github.com/aws13th-final-project-bada/bada/blob/main/worker/consumer.py): `worker/consumer.py`
- [Analysis queue](https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/services/queue.py): `backend/app/services/queue.py`
- [Analysis dispatch](https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/routers/analysis.py): `backend/app/routers/analysis.py`
- [Evidence extraction](https://github.com/aws13th-final-project-bada/bada/blob/main/worker/services/extract.py): `worker/services/extract.py`
- [Document OCR](https://github.com/aws13th-final-project-bada/bada/blob/main/worker/providers/ocr.py): `worker/providers/ocr.py`
- [Audio transcription](https://github.com/aws13th-final-project-bada/bada/blob/main/worker/providers/transcribe.py): `worker/providers/transcribe.py`
- [Case analysis](https://github.com/aws13th-final-project-bada/bada/blob/main/worker/pipeline.py): `worker/pipeline.py`
- [Rules engine](https://github.com/aws13th-final-project-bada/bada/tree/main/worker/rules): `worker/rules`
- [Timeline builder](https://github.com/aws13th-final-project-bada/bada/blob/main/worker/services/timeline.py): `worker/services/timeline.py`
- [Translation](https://github.com/aws13th-final-project-bada/bada/blob/main/worker/providers/translate.py): `worker/providers/translate.py`
- [Evidence Pack PDF](https://github.com/aws13th-final-project-bada/bada/blob/main/worker/services/pdf_generator.py): `worker/services/pdf_generator.py`

### Guidance and community

- [AI chat API](https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/routers/ai_chat.py): `backend/app/routers/ai_chat.py`
- [Chat orchestration](https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/services/ai_chat_orchestrator.py): `backend/app/services/ai_chat_orchestrator.py`
- [RAG retrieval](https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/services/rag_retriever.py): `backend/app/services/rag_retriever.py`
- [Chat answer generation](https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/services/llm_service.py): `backend/app/services/llm_service.py`
- [Community](https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/routers/community.py): `backend/app/routers/community.py`
- [Kakao chatbot](https://github.com/aws13th-final-project-bada/bada/blob/main/backend/app/routers/kakao.py): `backend/app/routers/kakao.py`

### Other components

- **Worker**
- **Amazon Bedrock**
- **Amazon S3**
- **Amazon SQS**

## Connections

- Worker → Mobile app: uses
- Mobile app → API server: calls API
- API server → Social authentication: routes (evidence: `backend/app/main.py`)
- API server → Case management: routes (evidence: `backend/app/main.py`)
- API server → Evidence intake: routes (evidence: `backend/app/main.py`)
- API server → Analysis dispatch: routes (evidence: `backend/app/main.py`)
- API server → AI chat API: routes (evidence: `backend/app/main.py`)
- API server → Community: routes (evidence: `backend/app/main.py`)
- API server → GPS work evidence: routes (evidence: `backend/app/main.py`)
- API server → Kakao chatbot: routes (evidence: `backend/app/main.py`)
- API server → Notifications: routes (evidence: `backend/app/main.py`)
- Evidence intake → Evidence storage: stores files
- Evidence intake → Case database: records evidence
- Analysis dispatch → Analysis queue: enqueues work (evidence: `backend/app/routers/analysis.py`)
- Analysis queue → Amazon SQS: sends message
- Amazon SQS → Worker: delivers job
- Worker → Case database: loads and saves
- Worker → Amazon S3: reads evidence
- Worker → Evidence extraction: structures text
- Worker → Document OCR: extracts images
- Worker → Audio transcription: transcribes audio
- Worker → Case analysis: analyzes case
- Case analysis → Rules engine: applies rules (evidence: `worker/pipeline.py`)
- Case analysis → Timeline builder: builds timeline (evidence: `worker/pipeline.py`)
- Case analysis → Translation: builds translations (evidence: `worker/pipeline.py`)
- Case analysis → Document OCR: extracts images (evidence: `worker/pipeline.py`)
- Case analysis → Evidence Pack PDF: builds report
- AI chat API → Chat orchestration: delegates chat (evidence: `backend/app/routers/ai_chat.py`)
- Chat orchestration → RAG retrieval: retrieves context
- Chat orchestration → Chat answer generation: generates answer
- Chat answer generation → Amazon Bedrock: invokes model (evidence: `backend/app/services/llm_service.py`)
