🌐 ELIGE TU IDIOMA / CHOOSE YOUR LANGUAGE
Un punto de partida sólido para construir aplicaciones web modernas, escalables y profesionales. Con dos caminos: aprende desde cero o usa el template listo.
modeloBaseWeb es una plantilla profesional y escalable para crear sitios web funcionales usando Django (framework Python) y Docker (contenedores).
Perfecto para:
- ✅ Aprender la arquitectura profesional de Django desde cero
- ✅ Usar un template listo para producción
- ✅ Equipos que necesitan estandarizar proyectos
- ✅ Aplicaciones que requieren Docker desde el inicio
Para desarrolladores que quieren entender la arquitectura
RAMA/BRANCH: main
📄 ARCHIVO: GUIA.MD
⏱️ TIEMPO: 2-3 horas (completo)
📚 NIVEL: Principiante → Intermedio
¿Qué incluye?
- 3 fases completas paso a paso
- Explicación de cada comando
- Estructura profesional desde cero
- Buenas prácticas de Docker
¿Para quién?
- Quiero entender cómo funciona Django + Docker
- Necesito aprender la arquitectura
- Prefiero construir desde los fundamentos
Note
Si eliges APRENDER DESDE CERO 👉 Abre GUIA.MD →; sigue los 3 pasos (FASE 1, 2, 3), aprende cada concepto y construye tu primer sitio web
Para desarrolladores que necesitan un proyecto funcional al instante
| Idioma | Rama | Comando |
|---|---|---|
| Español | template-es |
git clone --branch template-es <repo-url> |
| Inglés | template-en |
git clone --branch template-en <repo-url> |
¿Qué incluye?
- Proyecto completamente configurado
- Docker Compose profesional
- Base de datos lista
- Panel admin funcional
- Todo listo para customizar
¿Para quién?
- Necesito un proyecto funcional en 5 minutos
- Ya conozco Django y Docker
| Aspecto | 🎓 Aprender | 🚀 Template |
|---|---|---|
| Tiempo setup | 2-3 horas | 5 minutos |
| ¿Entiendas la arquitectura? | ✅ SÍ (completo) | |
| ¿Proyecto funcional? | ✅ SÍ (al final) | ✅ SÍ (inmediato) |
| Ideal para... | Aprender | Producción |
| Dificultad | Paso a paso | Plug & play |
| Customización | Desde cero | Modifica según necesites |
| Rama | main |
template-es / template-en |
Ambas rutas necesitan:
main (ESTÁS AQUÍ)
├─ 📄 README.md (este archivo)
├─ 📚 GUIA.MD (tutorial completo)
│
└─ Ramas:
├─ template-es (Django + Docker listos en ESPAÑOL)
└─ template-en (Django + Docker listos en INGLÉS)
P: ¿Necesito experiencia previa con Django o Docker?
R: No, la GUÍA te enseña desde cero. Ambas rutas están pensadas para principiantes.
P: ¿Qué diferencia hay entre las ramas?
R: La rama
maintiene la guía de aprendizaje. Las ramastemplate-esytemplate-enson proyectos completamente funcionales listos para usar.
P: ¿Puedo usar esto en producción?
R: Sí, Docker Compose está configurado profesionalmente. Las ramas template incluyen mejores prácticas.
P: ¿Qué idioma tiene cada rama?
R:
template-es→ Español |template-en→ Inglés. La guía GUIA.MD está en español.
P: ¿Dónde veo mi sitio web?
R: En
http://localhost:8000
P: ¿Cómo accedo al panel de admin?
R:
http://localhost:8000/admin(con credenciales del superusuario que creaste)
P: ¿Puedo cambiar de Django a otro framework?
R: Este template está optimizado para Django, pero la estructura Docker es reutilizable.
P: ¿Cómo agrego nuevas páginas?
R: En la GUÍA (FASE 2) aprenderás a crear apps y templates. En template: copia la estructura existente.
P: ¿Docker consume muchos recursos?
R: No, Docker es eficiente. Las imágenes python:3.11-slim son pequeñas (~150MB).
1. Verifica tener Docker instalado → docker --version
2. Abre GUIA.MD en esta rama
3. Sigue paso a paso
4. Aprende la arquitectura completa
1. Haz fork de template-es o template-en
2. docker-compose up
3. Personaliza según necesites
4. Deploy a producción
¿Tienes mejoras o sugerencias?
- 🐛 Reportar bugs — Issues
- 🔀 Hacer pull requests — Tus contribuciones son bienvenidas
Este proyecto se distribuye bajo la licencia MIT. Eres libre de usar, modificar y distribuir el código.
¿Preguntas o sugerencias?
💼 LinkedIn: Juliam Guerrero Diaz
📧 Email: juliamdario.g@deusto.es
🐙 GitHub: @JULIAMGUERRERO
⭐ Si este proyecto te es útil, ayuda a otros dejando una estrella en GitHub ⭐
A solid starting point for building modern, scalable, and professional web applications. With two paths: learn from scratch or use the ready-made template.
modeloBaseWeb is a professional and scalable template for creating functional websites using Django (Python framework) and Docker (containers).
Perfect for:
- ✅ Learning Django's professional architecture from scratch
- ✅ Using a production-ready template
- ✅ Teams that need to standardize projects
- ✅ Applications that require Docker from the start
For developers who want to understand the architecture
BRANCH: main
📄 FILE: GUIA.MD
⏱️ TIME: 2-3 hours (complete)
📚 LEVEL: Beginner → Intermediate
What does it include?
- 3 complete phases step by step
- Explanation of each command
- Professional structure from scratch
- Docker best practices
For whom?
- I want to understand how Django + Docker works
- I need to learn the architecture
- I prefer to build from the foundations
Note
If you choose LEARN FROM SCRATCH 👉 Open GUIDE.MD →; follow the 3 steps (PHASE 1, 2, 3), learn each concept and build your first website
For developers who need a functional project instantly
| Language | Branch | Command |
|---|---|---|
| Spanish | template-es |
git clone --branch template-es <repo-url> |
| English | template-en |
git clone --branch template-en <repo-url> |
What does it include?
- Completely configured project
- Professional Docker Compose
- Database ready
- Functional admin panel
- Everything ready to customize
For whom?
- I need a functional project in 5 minutes
- I already know Django and Docker
| Aspect | 🎓 Learn | 🚀 Template |
|---|---|---|
| Setup time | 2-3 hours | 5 minutes |
| Understand architecture? | ✅ YES (complete) | |
| Functional project? | ✅ YES (at the end) | ✅ YES (immediate) |
| Ideal for... | Learning | Production |
| Difficulty | Step by step | Plug & play |
| Customization | From scratch | Modify as needed |
| Branch | main |
template-es / template-en |
Both paths need:
main (YOU ARE HERE)
├─ 📄 README.md (this file)
├─ 📚 GUIA.MD (tutorial completo en ESPAÑOL)
├─ 📚 GUIDE.MD (complete tutorial in ENGLISH)
│
└─ Branches:
├─ template-es (Django + Docker ready in SPANISH)
└─ template-en (Django + Docker ready in ENGLISH)
Q: Do I need previous experience with Django or Docker?
A: No, the GUIDE teaches you from scratch. Both paths are designed for beginners.
Q: What's the difference between the branches?
A: The
mainbranch has the learning guide. Thetemplate-esandtemplate-enbranches are completely functional projects ready to use.
Q: Can I use this in production?
A: Yes, Docker Compose is configured professionally. The template branches include best practices.
Q: What language does each branch have?
A:
template-es→ Spanish |template-en→ English. The guide GUIA.MD is in Spanish, GUIDE.MD is in English.
Q: Where can I see my website?
A: At
http://localhost:8000
Q: How do I access the admin panel?
A:
http://localhost:8000/admin(with superuser credentials you created)
Q: Can I switch from Django to another framework?
A: This template is optimized for Django, but the Docker structure is reusable.
Q: How do I add new pages?
A: In the GUIDE (PHASE 2) you'll learn to create apps and templates. In template: copy the existing structure.
Q: Does Docker consume many resources?
A: No, Docker is efficient. Python 3.11-slim images are small (~150MB).
1. Verify Docker is installed → docker --version
2. Open GUIDE.MD in this branch
3. Follow step by step
4. Learn the complete architecture
1. Fork template-es or template-en
2. docker-compose up
3. Customize as needed
4. Deploy to production
Do you have improvements or suggestions?
- 🐛 Report bugs — Issues
- 🔀 Make pull requests — Your contributions are welcome
This project is distributed under the MIT license. You are free to use, modify and distribute the code.
Questions or suggestions?
💼 LinkedIn: Juliam Guerrero Diaz
📧 Email: juliamdario.g@deusto.es
🐙 GitHub: @JULIAMGUERRERO
⭐ If this project is useful to you, help others by leaving a star on GitHub ⭐