first commit

about/overview.md

@@ -0,0 +1,264 @@
+# Spanglish Website – Overview
+
+## 1. Purpose
+
+The Spanglish website is the official digital platform for organizing, promoting, and managing Spanglish language exchange events in Asunción, Paraguay.
+
+Its primary purpose is to:
+
+* Promote monthly language exchange events
+* Convert visitors into attendees
+* Centralize event operations
+* Reduce manual work for organizers
+* Build and retain a long-term community
+* Support future expansion
+
+The website is designed to be the main reference point for all Spanglish activities.
+
+---
+
+## 2. Product Vision
+
+Spanglish aims to be the leading language exchange community in Paraguay and later in other cities.
+
+The website should:
+
+* Feel welcoming and modern
+* Be easy to use for first-time visitors
+* Be powerful for internal management
+* Scale with community growth
+
+Long-term, the system should support multiple cities, memberships, and learning resources without major redesign.
+
+---
+
+## 3. Target Users
+
+### 3.1 Public Users (Participants)
+
+* Spanish speakers learning English
+* English speakers learning Spanish
+* Students and professionals
+* Expats and travelers
+* Newcomers discovering Spanglish
+* Returning community members
+
+### 3.2 Internal Users (Staff)
+
+* Admin (Owner)
+* Organizers
+* Check-in staff
+* Marketing staff
+* Support staff
+
+---
+
+## 4. Core Goals
+
+The website is built around the following core goals:
+
+1. Increase event attendance
+2. Improve operational efficiency
+3. Reduce manual coordination
+4. Improve communication
+5. Build community loyalty
+6. Enable data-driven decisions
+
+All features must directly or indirectly support these goals.
+
+---
+
+## 5. System Scope
+
+The system consists of two main components:
+
+1. Public Website
+2. Admin Dashboard
+
+Both components are connected through a shared backend and database.
+
+### 5.1 Public Website
+
+The public website is responsible for:
+
+* Presenting Spanglish
+* Displaying events
+* Handling bookings
+* Promoting community channels
+* Collecting contact information
+
+### 5.2 Admin Dashboard
+
+The admin dashboard is responsible for:
+
+* Managing events
+* Managing attendees
+* Managing payments
+* Sending communications
+* Managing media
+* Monitoring performance
+
+---
+
+## 6. Core Principles
+
+All development and design decisions must follow these principles:
+
+### 6.1 Simplicity
+
+* Avoid unnecessary complexity
+* Prioritize ease of use
+* Minimize user friction
+
+### 6.2 Reliability
+
+* Stable operation
+* Clear error handling
+* Data integrity
+
+### 6.3 Performance
+
+* Fast loading pages
+* Responsive UI
+* Optimized assets
+
+### 6.4 Maintainability
+
+* Clean code structure
+* Clear documentation
+* Modular design
+
+### 6.5 Scalability
+
+* Support growing user base
+* Support additional locations
+* Support new business models
+
+---
+
+## 7. Brand and Experience
+
+### 7.1 Brand Personality
+
+Spanglish is:
+
+* Friendly
+* International
+* Social
+* Organized
+* Trustworthy
+* Community-driven
+
+The website should reflect these values in design and tone.
+
+### 7.2 User Experience Goals
+
+Visitors should feel:
+
+* Welcome
+* Comfortable
+* Confident
+* Motivated to join
+
+Admins should feel:
+
+* In control
+* Efficient
+* Informed
+* Supported
+
+---
+
+## 8. Community Strategy
+
+The website supports community building by:
+
+* Promoting WhatsApp and social groups
+* Collecting email addresses
+* Tracking attendance history
+* Supporting loyalty programs
+* Enabling direct communication
+
+The platform is designed to strengthen long-term relationships, not only facilitate one-time events.
+
+---
+
+## 9. Business Model
+
+The primary revenue source is event ticket sales.
+
+Secondary and future revenue sources may include:
+
+* Membership subscriptions
+* Partner sponsorships
+* Premium events
+* Workshops
+* Digital learning materials
+
+The system must be flexible enough to support these models.
+
+---
+
+## 10. Data Strategy
+
+The system collects and manages:
+
+* User profiles
+* Event data
+* Ticket records
+* Payment records
+* Communication logs
+* Media assets
+
+All data must be handled securely and responsibly.
+
+---
+
+## 11. Growth Vision
+
+Future expansion includes:
+
+* Multiple cities
+* Multi-language support
+* Mobile app
+* Learning platform
+* Certification system
+* Nostr and Lightning integration
+
+The initial architecture must allow these extensions without major rewrites.
+
+---
+
+## 12. Success Metrics
+
+The project will be evaluated using:
+
+* Event attendance growth
+* Conversion rate
+* Repeat participation rate
+* Revenue per event
+* Community size
+* Operational efficiency
+
+These metrics guide future improvements.
+
+---
+
+## 13. Constraints
+
+The system must:
+
+* Run on existing VPS infrastructure
+* Be maintainable by a small team
+* Minimize operational overhead
+* Avoid unnecessary dependencies
+
+---
+
+## 14. Summary
+
+The Spanglish website is a professional event management and community platform designed to support sustainable growth.
+
+It combines a simple, welcoming public interface with a powerful internal management system.
+
+All development must prioritize usability, reliability, and long-term scalability.