| # Workspace |
|
|
| ## Overview |
|
|
| pnpm workspace monorepo usando TypeScript para el backend + app Python/Gradio para el chatbot de IA. |
|
|
| ## Stack |
|
|
| - **Monorepo tool**: pnpm workspaces |
| - **Node.js version**: 24 |
| - **Package manager**: pnpm |
| - **TypeScript version**: 5.9 |
| - **API framework**: Express 5 |
| - **Database**: PostgreSQL + Drizzle ORM |
| - **Validation**: Zod (`zod/v4`), `drizzle-zod` |
| - **API codegen**: Orval (from OpenAPI spec) |
| - **Build**: esbuild (CJS bundle) |
| - **Python version**: 3.11 |
| - **Chat AI**: Gradio + OpenAI (vía Replit AI Integrations) |
|
|
| ## Aplicación Principal: Chat IA |
|
|
| La aplicación de chat está en `chat-app/`: |
|
|
| - `chat-app/app.py` — App Gradio con chat conversacional estilo ChatGPT/Gemini |
| - `chat-app/requirements.txt` — Dependencias Python (gradio, openai) |
| - `chat-app/README.md` — Configuración para Hugging Face Spaces |
|
|
| ### Ejecutar localmente |
|
|
| ```bash |
| PORT=5000 python chat-app/app.py |
| ``` |
|
|
| ### Publicar en Hugging Face Spaces |
|
|
| 1. Crea una cuenta en [huggingface.co](https://huggingface.co) |
| 2. Ve a Settings → Access Tokens → New token (con permiso `write`) |
| 3. Crea un nuevo Space en Hugging Face (tipo: Gradio) |
| 4. Sube los archivos de `chat-app/` al Space |
| 5. Agrega tu API key en los Secrets del Space: |
| - `AI_INTEGRATIONS_OPENAI_BASE_URL` |
| - `AI_INTEGRATIONS_OPENAI_API_KEY` |
| - O bien, usa `OPENAI_API_KEY` con tu propia clave de OpenAI |
|
|
| ## Structure |
|
|
| ```text |
| artifacts-monorepo/ |
| ├── chat-app/ # App Python/Gradio - Chatbot de IA |
| │ ├── app.py # Aplicación principal Gradio |
| │ ├── requirements.txt # Dependencias Python |
| │ └── README.md # Configuración Hugging Face Spaces |
| ├── artifacts/ # Deployable applications (Node.js) |
| │ └── api-server/ # Express API server |
| ├── lib/ # Shared libraries |
| │ ├── api-spec/ # OpenAPI spec + Orval codegen config |
| │ ├── api-client-react/ # Generated React Query hooks |
| │ ├── api-zod/ # Generated Zod schemas from OpenAPI |
| │ └── db/ # Drizzle ORM schema + DB connection |
| ├── scripts/ # Utility scripts |
| └── package.json # Root package |
| ``` |
|
|
| ## Packages |
|
|
| ### `artifacts/api-server` (`@workspace/api-server`) |
|
|
| Express 5 API server (Node.js backend). |
|
|
| ### `lib/db` (`@workspace/db`) |
|
|
| Database layer using Drizzle ORM with PostgreSQL. |
|
|
| ### `lib/api-spec` (`@workspace/api-spec`) |
|
|
| OpenAPI 3.1 spec and Orval codegen config. |
|
|
