🎓 Aeternus Tech Documentation
Bienvenido a la documentación oficial de Aeternus AI — una plataforma de chat con IA para conversaciones naturales y significativas.
Esta documentación es tu guía completa para entender, desarrollar y desplegar el proyecto.
🚀 Comienza aquí
Eres nuevo en el proyeto?
- Setup Local (5 min) — Cómo ejecutar todo en tu computadora
- Project Structure — Entiende dónde está cada cosa
- Contributing — Cómo hacer tu primer cambio
Quieres contribuir?
- 📋 Common Tasks — Recetas útiles y troubleshooting
- 🔐 Environment Variables — Variables de configuración explicadas
- 🔌 API Documentation — Endpoints del backend
- 🤖 Guía para Agentes AI — Contexto técnico para asistentes AI
- 🧭 AGENTS.md — Reglas operativas para agentes en el repo
Necesitas deployar o administrar infraestructura?
- 🚀 Deployment Guide — AWS ECS, GitHub Actions, CI/CD
- 💾 Database Schema — PostgreSQL, Prisma, Neo4j
🏗️ Estructura del proyecto
aeternus/
├── src/ # ⚛️ Frontend (Next.js + React)
├── core/ # 🐍 Backend (FastAPI + Python)
├── prisma/ # 💾 Database Schema
└── docs/ # 📚 Documentation
Frontend: Next.js 14, React 18, TypeScript, Tailwind CSS
Backend: FastAPI, Python 3.9+, Uvicorn
Database: PostgreSQL, Neo4j (grafos), Prisma (ORM)
Deployment: Vercel (frontend), AWS ECS (backend)
🌟 Características principales
- 💬 Chat con IA — Powered by OpenAI GPT-4
- 🎙️ Text-to-Speech — ElevenLabs + Web Speech API fallback
- 🔐 Autenticación — Auth0 integration
- 📊 Admin Dashboard — Manage users and conversations
- 🎯 Progressive Onboarding — User-friendly walkthrough
- 💾 Persistent Storage — Save chats indefinitely
📊 Tech Stack
| Layer | Technology |
|---|---|
| Frontend | Next.js 14, React 18, TypeScript |
| Styling | Tailwind CSS, HeroUI, Framer Motion |
| Backend | FastAPI, Python 3.9+ |
| Database | PostgreSQL, Neo4j, Prisma ORM |
| Auth | Auth0 |
| AI/ML | OpenAI API, ElevenLabs |
| Deploy | Vercel, AWS ECS, GitHub Actions |
🔗 Quick Links
📞 Get Help
- 💬 Slack/Discord del equipo
- 📝 GitHub Issues
- 📚 Revisa el FAQ
🎯 Navigation
- Getting Started: Setup Local → Project Structure → Contributing
- Development: Common Tasks → API Docs → Database
- Operations: Deployment → Environment Variables
- Reference: FAQ → Changelog
Last updated: {{ date.created }}