{"id":29873878,"url":"https://github.com/boringcodes/ai-fullstack-advisor","last_synced_at":"2025-07-30T23:38:30.473Z","repository":{"id":306633855,"uuid":"1026759475","full_name":"boringcodes/ai-fullstack-advisor","owner":"boringcodes","description":"Herramienta CLI (Command Line Interface) con inteligencia artificial diseñada para ayudar a desarrolladores a iniciar proyectos backend, frontend o fullstack de forma inteligente, rápida y profesional. ","archived":false,"fork":false,"pushed_at":"2025-07-26T21:39:33.000Z","size":37,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-07-26T21:59:38.353Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/boringcodes.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/roadmap.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-26T14:56:22.000Z","updated_at":"2025-07-26T21:39:37.000Z","dependencies_parsed_at":"2025-07-26T21:59:43.243Z","dependency_job_id":"04d26ab9-4bdf-4e83-a68e-28677c9d1cde","html_url":"https://github.com/boringcodes/ai-fullstack-advisor","commit_stats":null,"previous_names":["boringcodes/ai-fullstack-advisor"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/boringcodes/ai-fullstack-advisor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boringcodes%2Fai-fullstack-advisor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boringcodes%2Fai-fullstack-advisor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boringcodes%2Fai-fullstack-advisor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boringcodes%2Fai-fullstack-advisor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/boringcodes","download_url":"https://codeload.github.com/boringcodes/ai-fullstack-advisor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/boringcodes%2Fai-fullstack-advisor/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267961021,"owners_count":24172514,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-07-30T02:00:09.044Z","response_time":70,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-07-30T23:38:21.715Z","updated_at":"2025-07-30T23:38:30.460Z","avatar_url":"https://github.com/boringcodes.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤖 AI Fullstack Advisor™\n\n**AI Fullstack Advisor™** es una herramienta CLI inteligente y modular que guía a desarrolladores en la elección, configuración, instalación y estructuración del stack tecnológico ideal para sus proyectos (frontend, backend o fullstack) en segundos.\n\n\u003e Made with AI, DevOps \u0026 Love 💜 by [Farükツ](https://github.com/boringcodes)  \n\u003e Versión 1.0 · MVP educativo · Proyecto modular \u0026 escalable\n\n---\n\n## 🧠 ¿Qué resuelve?\n\nMuchos desarrolladores pierden tiempo y energía en configurar manualmente sus entornos técnicos o eligen mal su stack por falta de guía. Este sistema:\n\n- 🔍 Hace **preguntas clave** para entender el proyecto y sus necesidades  \n- 💡 Ofrece **recomendaciones inteligentes** de stack, frameworks y librerías  \n- ⚙️ Instala automáticamente dependencias sugeridas (`npm`, `pip`)  \n- 🏗️ Genera una **estructura profesional, escalable y modular**  \n- 🚦 Aplica buenas prácticas de arquitectura desde el día 1 (Scrum + DevOps)\n\n---\n\n## 🚀 ¿Para quién es?\n\n- 🧑‍🎓 Estudiantes o tesistas que quieren lanzar un proyecto funcional desde cero  \n- 🧑‍💻 Freelancers o devs independientes que buscan acelerar su setup técnico  \n- 🧑‍🏫 Profesores o mentores que necesitan estandarizar entornos educativos  \n- 🧑‍🚀 Devs expertos que quieren ahorrar tiempo o experimentar nuevos stacks\n\n---\n\n## 📦 Requisitos Técnicos\n\n| Herramienta        | Versión mínima |\n|--------------------|----------------|\n| Python             | 3.10+          |\n| pip                | 22.x           |\n| Node.js (opcional) | 18.x           |\n| Git                | Última         |\n| Visual Studio C++  | (para compilar en Windows) |\n\n\u003e ⚠️ Recomendado usar en ambientes Unix (Linux/macOS/WSL).  \n\u003e En Windows, asegúrate de tener instalados los **Build Tools**.\n\n---\n\n## ⚡ Instalación Rápida\n\n```bash\n# Clona el repositorio\ngit clone https://github.com/boringcodes/ai-fullstack-advisor.git\ncd ai-fullstack-advisor\n\n# Crea y activa el entorno virtual (si no lo tienes)\npython -m venv venv\nsource venv/bin/activate # Para Linux/macOS/Git Bash\n# O .\\venv\\Scripts\\activate para CMD/PowerShell\n\n# Instala dependencias\npip install -r requirements.txt\n\n# Ejecuta el sistema CLI\npython fullstack_advisor.py\n```\n\n---\n\n## 💡 Ejemplo de uso (CLI)\n\n```bash\n$ python fullstack_advisor.py\n\n🧠 Bienvenido a AI Fullstack Advisor\nUna herramienta para guiar la planificación técnica de tu proyecto.\n\n👉 ¿Qué tipo de proyecto vas a iniciar?\n[1] Frontend\n[2] Backend\n[3] Fullstack\n\u003e 3\n\n✅ Sugerencia: React + FastAPI + PostgreSQL\n\n🔧 Instalando tecnologías recomendadas...\n📂 Generando estructura base del proyecto...\n📄 Guardando resumen de configuración...\n\n✅ ¡Tu entorno está listo! ¡Mucho éxito!\n```\n\n---\n\n## 📁 Estructura del Proyecto (v1.0)\n\n```plaintext\nai-fullstack-advisor/\n│\n├── fullstack_advisor.py            # Módulo principal CLI (flujo general de ejecución)\n├── requirements.txt                # Lista de dependencias del sistema\n├── setup_structure.py              # Script que genera la estructura base inicial\n├── README.md                       # Documentación general (este archivo)\n│\n├── logic/                          # Lógica principal y backend inteligente\n│   ├── recommender.py              # Motor de recomendaciones según respuestas\n│   ├── installer.py                # Instalación automática de dependencias\n│   └── structure_generator.py      # Generador de carpetas y archivos del proyecto\n│\n├── prompts/                        # Preguntas y lógica del sistema\n│   ├── stack_questions.json        # Base de preguntas clave con opciones\n│   └── stack_questions.py          # Lógica para lanzar preguntas en CLI\n│\n├── utils/                          # Utilidades auxiliares\n│   ├── checker.py                  # Verifica herramientas locales (npm, pip, etc.)\n│   └── logger.py                   # Logging del proceso y resumen generado\n│   └── generate_structure_doc.py   # Script para actualizar dinámicamente docs/structure.graphql\n│\n├── outputs/                        # Archivos generados automáticamente\n│   └── config_summary.json         # Resultado personalizado del usuario\n│\n├── .gitignore                      # Ignora archivos temporales y entornos virtuales\n│\n├── .pre-commit-config.yaml         # Configuración para automatizar tareas antes de cada commit\n│\n├── .github/\n│   ├── project-template.md         # Plantilla Scrum-DevOps para gestión de proyecto\n│   └── workflows/\n│       └── validate_config.yml     # CI: Validación del JSON de configuración\n│\n└── docs/                           # Documentación extendida\n    ├── project-board.md            # Scrum board: backlog, tareas, sprints\n    ├── roadmap.md                  # Roadmap a futuro (v2, v3, plugins)\n    └── structure.graphql           # Esquema visual en formato GraphQL del sistema\n```\n\n---\n\n## 🛠️ Actualización Automática de la Estructura\n\nLa documentación de la estructura del proyecto (`docs/structure.graphql`) se mantiene siempre al día. Gracias a **pre-commit**, este archivo se **actualiza automáticamente** cada vez que realizas un `git commit`.\n\n**Es fundamental que tu entorno virtual esté activado antes de hacer un commit** para que este proceso se ejecute correctamente.\n\n---\n\n## 🧩 Modularidad\n\nCada archivo está desacoplado. Puedes extender funcionalidades fácilmente:\n\n- 🔧 Agrega nuevos stacks en `prompts/stack_questions.json`\n- 🔧 Crea lógica de instalación en `installer.py`\n- 🔧 Añade nuevas estructuras en `structure_generator.py`\n- 🔧 Mejora las sugerencias en `recommender.py`\n\n---\n\n## 📈 Roadmap\n\n| Versión | Características previstas                                                         |\n| ------- | --------------------------------------------------------------------------------- |\n| v1.0    | CLI inteligente, instalación, estructura, logs básicos ✅                          |\n| v1.5    | Dockerfile, flags de terminal (modo experto), validaciones más estrictas          |\n| v2.0    | UI web, historial de configuraciones, integración GPT para generación de README   |\n| v3.0    | Plugin system, analizador de proyectos existentes, sugerencias basadas en IA real |\n\n---\n\n## 🧪 Test \u0026 QA\n\nPara ejecutar pruebas de validación o futuras suites:\n\n```bash\n# Validar archivo de preguntas\npython -m json.tool prompts/stack_questions.json\n\n# Validar estructura generada\npython setup_structure.py \u0026\u0026 tree\n```\n\n---\n\n## 🤝 Cómo Contribuir\n\n1. Haz fork del proyecto\n2. Crea una branch: `git checkout -b feature/nueva-funcionalidad`\n3. Haz commit de tus cambios: `git commit -m \"feat: nueva funcionalidad\"`\n4. Push: `git push origin feature/nueva-funcionalidad`\n5. Abre un Pull Request 🧵\n\n---\n\n## 📖 Documentación Extendida\n\nRevisa estos archivos en `docs/` para profundizar:\n\n- 📌 `roadmap.md`: visión de futuro (Docker, plugins, Web UI)\n- 🛠️ `project-board.md`: tareas pendientes, ideas, bugs\n- 🧬 `structure.graphql`: visualización de carpetas como schema\n\n---\n\n## 📜 Licencia\n\nDistribuido bajo licencia MIT.\nConsulta `LICENSE` para más detalles.\n\n---\n\n## ✨ Créditos\n\n- 👨‍💻 Autor: [Farükツ](https://github.com/boringcodes)\n- 🧠 Inspiración: `cookiecutter`, `create-react-app`, `fig`, `DevStack Boosters`\n- 🤖 AI Support: ChatGPT (OpenAI), Gemini (Google DeepMind)\n- 🌍 Comunidad: Python, FastAPI, Devs de GitHub, StackOverflow \u0026 beyond\n\n---\n\n## 🧠 Filosofía de Diseño\n\n\u003e **\"Automatiza lo repetitivo. Estandariza lo importante. Hazlo con inteligencia.\"**\n\u003e Este proyecto nace para empoderar a developers a lanzar ideas técnicas con rapidez, enfoque y buenas prácticas desde el día 1.\n\n---\n\n## 💜 Made with Code, AI \u0026 Love\n\n**boringcodes™**\nQuerétaro, 🇲🇽 · 2025\n[https://github.com/boringcodes](https://github.com/boringcodes)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboringcodes%2Fai-fullstack-advisor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fboringcodes%2Fai-fullstack-advisor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fboringcodes%2Fai-fullstack-advisor/lists"}