njaa-frontend/Gemini/NJAA-Architecture Stack.md

Architecture Stack

**General Guideline: ** Free and Open-Source, self-hostable with little to no limitations.

Development

• use git and make proper commits

Frontend

• Astro.js + React
• Tailwind.css
• Framer Motion

Backend

• Strapi (Core MIT License)
  • User Management: Strapi's built-in user authentication and role management system can handle user accounts for access control.
• Database: PostgreSQL (PostgreSQL License)

Other Functionalities

Newsletter

• Email/Mailing List Manager: Listmonk (AGPLv3 License) - A self-hosted, open-source newsletter and mailing list manager.

File Downloads (e.g., Ebooks)

• Content Hosting: Ebooks hosted and served via Strapi's Media Library.
• Access Control: Downloads gated by Strapi user authentication. Users must be logged in via Strapi to access protected download links.
• Newsletter Integration: User registration/login process within Strapi can be integrated with Listmonk (e.g., via API calls or webhooks) to automatically subscribe users to the newsletter upon signup, fulfilling the requirement for download access.

Deployment

• Docker Compose:
  • Define services for Strapi (MIT License), PostgreSQL (PostgreSQL License), and Listmonk (AGPLv3 License).
  • Configure volumes for Strapi uploads, PostgreSQL data persistence, and Listmonk data persistence.
  • Ensure environment variables are managed for database connections, Strapi secrets, and Listmonk configuration.
  • Consider how the Astro.js frontend will be built and served, and how it interacts with Strapi's API for user authentication and protected content.
• DO create docker-compose.yaml to make it deployable for Coolify