Bonus — Team Collaboration: API-First Design, OpenAPI Contracts & PR Workflow

# pharmabot/main.py
from fastapi import FastAPI

app = FastAPI(
    title="PharmaBot API",
    description="AI-powered pharmaceutical information assistant",
    version="1.0.0",
    contact={"name": "PharmaBot Team", "email": "team@pharmabot.dev"},
    license_info={"name": "MIT"},
)

# pharmabot/api/chat.py
from pharmabot.schemas.chat import ChatRequest, StreamChunk

@router.post(
    "/chat",
    summary="Send a chat message",
    description="Send a message and receive a streamed SSE response.",
    response_description="Server-Sent Events stream of text tokens",
    responses={
        200: {"description": "Stream of SSE tokens"},
        400: {"description": "Invalid input or injection detected"},
        429: {"description": "Rate limit exceeded"},
        503: {"description": "LLM service temporarily unavailable"},
    },
    tags=["Chat"],
)
async def chat(request: ChatRequest, _=Depends(check_rate_limit)):
    ...

# Export the OpenAPI schema as a file — commit it to the repo
curl http://localhost:8000/openapi.json > openapi.json
git add openapi.json
git commit -m "docs: export OpenAPI schema v1.0"

- "required": ["message", "session_id"]
+ "required": ["message", "session_id", "user_locale"]

# Install openapi-typescript
npm install -D openapi-typescript

# Generate types from the running API
npx openapi-typescript http://localhost:8000/openapi.json -o src/types/pharmabot-api.ts

// src/types/pharmabot-api.ts  (auto-generated — do not edit)
export interface paths {
  "/api/chat": {
    post: {
      requestBody: {
        content: {
          "application/json": components["schemas"]["ChatRequest"];
        };
      };
      responses: {
        200: { description: "Stream of SSE tokens" };
        400: { description: "Invalid input or injection detected" };
        429: { description: "Rate limit exceeded" };
      };
    };
  };
}

export interface components {
  schemas: {
    ChatRequest: {
      message: string;    // max 500 chars
      session_id: string; // UUID
    };
    HealthResponse: {
      status: "healthy" | "degraded";
      database: "ok" | "error";
      redis: "ok" | "error";
      azure_openai: "ok" | "error";
    };
  };
}

feature/skill-06-ai-agents
fix/rate-limiter-edge-case
docs/update-openapi-schema
chore/bump-openai-sdk

## What does this PR do?
<!-- One sentence -->

## How to test
<!-- Steps the reviewer should follow -->

## Checklist
- [ ] Tests pass locally (`pytest tests/ -v`)
- [ ] OpenAPI schema exported and committed if routes changed
- [ ] No secrets in code (use Key Vault references)
- [ ] Structured logging added for new operations
- [ ] CHANGELOG.md updated if this is a user-visible change

1. Author opens PR → CI runs automatically (tests + linting)
2. One reviewer approves → auto-merge enabled if CI passes
3. Merge to main → GitHub Actions deploys to staging
4. Staging smoke test passes → promote to production (manual approval gate)

# Changelog

## [Unreleased]
### Added
- Interaction Checker Agent with severity scoring (JSON output)
- Redis response caching for repeated queries

### Fixed
- Rate limiter now correctly handles clock skew on multi-replica deployments

## [1.0.0] — 2026-05-15
### Added
- Initial PharmaBot release
- Drug info and interaction check via Azure OpenAI
- Redis token bucket rate limiting
- Azure Container Apps deployment

# Create PR template
mkdir -p .github
cat > .github/PULL_REQUEST_TEMPLATE.md << 'EOF'
## What does this PR do?

## How to test

## Checklist
- [ ] Tests pass (`pytest tests/ -v`)
- [ ] OpenAPI schema updated if routes changed
- [ ] No secrets in code
EOF

# Export current schema
curl http://localhost:8000/openapi.json | python3 -m json.tool > openapi.json

# Commit both
git add .github/PULL_REQUEST_TEMPLATE.md openapi.json
git commit -m "docs: add PR template and export OpenAPI schema"
git push origin main