chore: bootstrap initial HLL Vietnam project structure

This commit is contained in:
devRaGonSa
2026-03-19 10:46:29 +01:00
commit 8a35ed02f9
18 changed files with 473 additions and 0 deletions

17
docs/decisions.md Normal file
View File

@@ -0,0 +1,17 @@
# Technical Decisions
## Decision 001: frontend simple HTML/CSS/JS
Se adopta una base estática con HTML, CSS y JavaScript puro para priorizar simplicidad, velocidad de arranque y compatibilidad total al abrir el frontend directamente en navegador.
## Decision 002: backend previsto en Python
La estructura del repositorio reserva desde el inicio una carpeta de backend porque la implementación futura se realizará en Python.
## Decision 003: estructura preparada para orquestación por agentes
Se incluye una carpeta `ai/` y un documento `AGENTS.md` para facilitar una futura organización del trabajo por roles, tareas y orquestación.
## Decision 004: branding militar Vietnam
La dirección visual inicial se alinea con una estética sobria, táctica y militar inspirada en el contexto Vietnam para mantener coherencia temática desde la primera iteración.

29
docs/project-overview.md Normal file
View File

@@ -0,0 +1,29 @@
# Project Overview
## Vision del proyecto
HLL Vietnam busca convertirse en la base de una web de comunidad para centralizar la presencia digital de una comunidad hispana alrededor del juego, con una identidad visual sobria, táctica y coherente con el universo Vietnam.
## Objetivo inicial
Publicar una landing simple que permita presentar la comunidad, mostrar el trailer del proyecto y facilitar el acceso directo al servidor de Discord.
## Alcance actual
- Estructura inicial del repositorio.
- Landing estática en HTML, CSS y JavaScript.
- Documentación base para organizar el crecimiento del proyecto.
- Preparación de carpetas para backend y orquestación futura.
## Stack actual
- HTML
- CSS
- JavaScript
- Git para control de versiones
## Stack futuro previsto
- Backend principal en Python
- Integraciones de comunidad y automatización
- Posible ampliación de paneles administrativos y servicios internos

31
docs/roadmap.md Normal file
View File

@@ -0,0 +1,31 @@
# Roadmap
## Fase 1: base del repo
- Crear estructura inicial profesional.
- Definir documentación base del proyecto.
- Publicar la primera landing estática.
## Fase 2: landing mejorada
- Incorporar branding definitivo y recursos visuales.
- Añadir más secciones informativas de comunidad.
- Mejorar experiencia responsive y contenido.
## Fase 3: backend Python
- Definir arquitectura del backend.
- Incorporar servicios base en Python.
- Preparar configuración, entornos y despliegue inicial.
## Fase 4: integración de datos de Discord/servidores
- Estudiar integraciones viables con Discord.
- Incorporar datos de comunidad o estado de servicios.
- Añadir automatizaciones controladas y trazables.
## Fase 5: panel/admin y automatización
- Construir panel interno o administrativo.
- Añadir flujos de gestión y publicación.
- Integrar sistema de tareas y orquestación del proyecto.