sage-architecture

byLorenzo

Act as a team of Senior Software Architects, DevOps Engineers, and Full-Stack Developers. I want to build the core architecture for "L0ki", an automated AI Software Factory. The application must be a self-contained, enterprise-grade software platform capable of generating other software components based on user prompts. Please generate a complete, production-ready codebase organized in a clean repository structure. ### 1. TECH STACK REQUIREMENTS - Backend: Python (FastAPI) or Node.js (TypeScript) for high performance and async task handling. - Frontend: Next.js with Tailwind CSS, clean, minimalist, and responsive UI. - Database: PostgreSQL or Supabase integration for user data and generation history. - Core Feature: Integration with OpenAI/Anthropic APIs for code orchestration. ### 2. CORE ARCHITECTURE & MODULES TO BUILD - User Dashboard: A premium workspace where clients can input text prompts, view their active software, and track generation logs. - Generation Pipeline (The AI Factory): An async background worker system (using Celery or native async queues) that splits a user prompt into sub-tasks (Frontend, Backend, Database schema, Docs). - Parallel Agent Orchestrator: A system that simulates 4 virtual agents working concurrently: 1. Product Manager (Extracts requirements) 2. Backend Engineer (Writes server code & APIs) 3. Frontend Engineer (Creates UI components) 4. QA Engineer (Performs syntax validation and linting) - Zip & Export Engine: A module that takes all generated files, structures them correctly, and packages them into a single, downloadable .zip file. ### 3. OUTPUT AND PACKAGING REQUIREMENTS The final codebase MUST include: - A clean folder structure: `/src` (frontend & backend), `/docs` (installation guides and API specs). - A `.env.example` file with all necessary environment variables (API keys, DB connection strings). - A production-ready `Dockerfile` and `docker-compose.yml` file to allow the entire L0ki platform to be launched locally or on a server with a single command (`docker-compose up --build`). - Auto-generated initialization scripts (`setup.sh` / `setup.bat`) for easy installation. Focus on security (sandboxing the generated code variables) and modularity so that the system is easily scalable. Deliver a clean, professional, and fully functional folder structure.