pythonicshahdev/fastapi-app-reusable repository overview

⁠Boomi Demo Accelerator — Reusable FastAPI Templates

⁠Quick Start

docker run -d --name boomi_fastapi -p 4005:4005 pythonicshahdev/fastapi-app-reusable:latest

Interactive API docs available immediately at http://localhost:4005/docs⁠

⁠Domains & Endpoints

Every domain follows a consistent CRUD pattern with full OpenAPI documentation, standardised error responses, and optional filtering.

⁠👤 Customer 360

Key fields: customer_id, email, phone, address, customer_segment, account_type, credit_limit, payment_terms, currency, sales_org, industry, lifetime_value, preferred_channel, status

⁠📦 Product 360

Key fields: material_number, material_description, material_type (FERT/HALB/ROH/etc.), material_group, base_unit_of_measure, gross_weight, ean_upc, brand, division, sales_org, price, currency, status

⁠🛒 Orders

Key fields: order_id, customer_id, product_id, order_date, amount, customer_email

The simulate endpoint creates new orders in the in-memory store — ideal for live demo moments where you want to show data flowing in real time.

⁠👥 HR 360

Key fields: employee_id, first_name, last_name, email, department, job_title, hire_date, salary, employment_status

⁠🎓 Student 360

Key fields: student_id, first_name, last_name, email, major, gpa, enrollment_status, degree_type, advisor_id, credits_earned

⁠🧑‍🏫 Faculty 360

Key fields: faculty_id, first_name, last_name, email, department, academic_rank, tenure_status, publications_count, research_grants, salary

⁠💳 Payments

⁠🏓 Health Check

GET /ping   →  { "status": "UP" }

⁠API Design

All endpoints share a consistent contract:

Standardised error response on all failure paths:

{
  "errorCode": "404",
  "errorMessage": "Customer 'CUST-999999' was not found",
  "transactionId": "dd960082-abbf-47c2-8c65-f18eeb35848b",
  "timeStamp": "2026-06-18T14:32:11Z"
}

Optional x-correlation-id header on all endpoints for request tracing.

Full OpenAPI spec auto-generated at /docs (Swagger UI) and /redoc.

⁠Architecture

CSV seed files (baked into image)
    Customer360.csv  →  /customers   (200 records)
    Product360.csv   →  /products    (200 records)
    Orders.csv       →  /orders      (775 records)
    Student360.csv   →  /students
    Faculty360.csv   →  /faculty

In-memory store (loaded at startup, lost on restart)
    All data lives in Python memory — no external DB required
    Simulate endpoint writes to in-memory store for live demo use

⁠Environment Variables

Port is fixed at 4005 internally. Map to any host port:

docker run -d -p 4006:4005 pythonicshahdev/fastapi-app-reusable:latest

⁠With Docker Compose

services:
  fastapi:
    image: pythonicshahdev/fastapi-app-reusable:latest
    container_name: boomi_fastapi
    ports:
      - "4005:4005"
    restart: unless-stopped

⁠Use Cases

• Boomi Integration demos — pre-built REST source for showcasing HTTP Client, REST connector, and data transformation patterns
• Boomi DataHub / MDM demos — Customer 360 and Product 360 as commercial source systems feeding golden records
• Boomi API Management demos — expose these endpoints through the Boomi API Gateway
• Event Streams demos — use POST /orders/simulate to trigger live event flow during a demo
• Training environments — realistic multi-domain data for Boomi University labs

⁠Related Images

⁠Source & Contact

Built and maintained by Shah