Convert¶
AI-assisted operations assistant platform: LLM-powered workflows for client operations, with an admin console. Backend is Python/FastAPI with a LiteLLM proxy for model routing; frontend is a Next.js console.
Facts¶
| Item | Detail |
|---|---|
| Type | Docker compose (backend + console) on VPS prd1 |
| Backend | Python / FastAPI + LiteLLM proxy |
| Console | Next.js 14 admin UI |
| Ports (prod) | API 127.0.0.1:8000, console 127.0.0.1:3099 |
| Ports (staging) | API 127.0.0.1:8100, console 127.0.0.1:8180 |
| Databases | PostgreSQL native: convert, convert_staging (+ convert_litellm, convert_staging_litellm) |
| Storage | iDrive e2 S3 (presigned URLs) |
| Repos | cloudxm-convert-server, cloudxm-convert-console |
| Domains | convert.cloudxm.com.br, stg-convert.cloudxm.com.br |
What it does¶
- AI chat/automation workflows for e-commerce operations (provider-agnostic via LiteLLM).
- Admin console for configuration and monitoring.
- S3-backed document storage with presigned access (no public buckets).
Deploy¶
Docker pattern: each repo's CI builds the image and runs docker compose -p <project> on the VPS. See the product repo deploy/ scripts and Operations runbooks.
Port contracts
Convert owns the 8000–8199 range (prod +100 for staging console offset). Never bind containers to ports outside this range without updating the port map in cloudxm-infra.
Owners¶
[TODO: assign owner(s) + support rotation contact]