Tinjure Global Tea Website

A professional Django web application for Tinjure Global Tea, an organic tea company focused on delivering premium quality tea products globally. The website serves as a digital storefront and information hub for customers interested in organic tea products and the company's mission.

🌱 About the Project

Tinjure Global Tea website provides:

• Corporate information and company values
• Contact and inquiry management system
• Newsletter subscription for customer engagement
• Responsive design for optimal viewing across all devices
• Professional presentation of the organic tea business

✨ Features

Core Functionality

• Home Page: Welcome section with company introduction
• About Us: Detailed company information and background
• Our Purpose: Mission, vision, and values presentation
• Contact System: Professional contact form with inquiry management
• Newsletter Subscription: Email collection for marketing campaigns
• Admin Panel: Django admin interface for content management

Technical Features

• Responsive Design: Bootstrap 4 framework with mobile-first approach
• Preloader Animation: Enhanced user experience with loading animations
• Message System: Flash messages for user feedback and notifications
• Social Media Integration: Links to Facebook, Instagram, Twitter, Google+
• User Authentication: Login/logout functionality for administrators
• Form Validation: Client and server-side form validation
• SEO Ready: Proper meta tags and structured content

🛠️ Technology Stack

• Backend: Django
• Database: SQLite (development)
• Frontend: HTML5, CSS3, Bootstrap 4, JavaScript/jQuery
• Fonts: Google Fonts (Poppins)
• Icons: Font Awesome
• Image Processing: Pillow
• Python Version: Compatible with Python 3.8+

📋 Prerequisites

• Python 3.8 or higher
• pip (Python package installer)
• Virtual environment (recommended)

🚀 Installation & Setup

1. Clone the Repository

git clone <repository-url>
cd GlobalTea

2. Create Virtual Environment

python -m venv env

3. Activate Virtual Environment

# Windows
env\Scripts\activate

# macOS/Linux
source env/bin/activate

4. Install Dependencies

pip install -r requirements.txt

5. Database Setup

python manage.py makemigrations
python manage.py migrate

6. Create Superuser (Optional)

python manage.py createsuperuser

7. Run Development Server

python manage.py runserver

The application will be available at http://127.0.0.1:8000/

📁 Project Structure

tinjureglobaltea/
├── tinjureglobaltea/             # Main project directory
│   ├── settings.py               # Django settings
│   ├── urls.py                   # Main URL configuration
│   └── wsgi.py                   # WSGI configuration
├── home/                         # Main application
│   ├── models.py                 # Database models
│   ├── views.py                  # View functions
│   ├── urls.py                   # URL patterns
│   └── admin.py                  # Admin configuration
├── templates/                    # HTML templates
│   ├── base.html                 # Base template
│   └── home/                     # Home app templates
├── static/                       # Static files
│   ├── css/                      # Stylesheets
│   ├── js/                       # JavaScript files
│   └── img/                      # Images and icons
├── requirements.txt              # Python dependencies
└── manage.py                     # Django management script

🎯 Key Models

ContactMessage

• Fields: First name, last name, email, phone, message
• Purpose: Store customer inquiries and contact form submissions
• Admin: Viewable through Django admin panel

SubscribedEmail

• Fields: Email address, creation date, update date
• Purpose: Manage newsletter subscriptions
• Validation: Unique email constraint to prevent duplicates

🔧 Configuration

Environment Settings

• Debug Mode: Currently set for development
• Database: SQLite for development (easily configurable for production)
• Static Files: Organized in dedicated directories
• Time Zone: UTC (configurable)

📝 Usage

Admin Panel

Access the Django admin at /admin/ to:

• View and manage contact form submissions
• Monitor newsletter subscriptions
• Manage user accounts and permissions
• Access detailed analytics of inquiries

Main Pages

• Home (/): Company introduction and overview
• About (/about/): Detailed company information
• Our Purpose (/our-purpose/): Mission and values
• Contact (/contact/): Contact form and company details

Newsletter System

• Footer newsletter signup form
• Email validation and duplicate prevention
• Success/error message feedback
• Admin panel management of subscribers

🎨 Design Features

• Modern UI: Clean, professional design reflecting organic tea branding
• Bootstrap Grid: Responsive layout system
• Custom CSS: Brand-specific styling and animations
• Typography: Poppins font family for modern appearance
• Color Scheme: Tea-inspired color palette
• Icons: Font Awesome integration for visual elements

🌐 SEO & Performance

• Meta Tags: Proper HTML meta information
• Responsive Images: Optimized for different screen sizes
• Loading Animation: Preloader for better perceived performance
• Clean URLs: Django URL patterns for SEO-friendly addresses
• Semantic HTML: Proper HTML5 structure

🤝 Contributing

1. Fork the repository
2. Create a feature branch (git checkout -b feature/new-feature)
3. Commit your changes (git commit -am 'Add new feature')
4. Push to the branch (git push origin feature/new-feature)
5. Create a Pull Request

📄 License

This project is developed for Tinjure Global Tea. All rights reserved.

🚀 Deployment Notes

For production deployment:

1. Security Settings:

   • Set DEBUG = False
   • Configure ALLOWED_HOSTS
   • Generate new SECRET_KEY

2. Database:

   • Configure PostgreSQL or MySQL
   • Set up proper database credentials

3. Static Files:

   • Configure static file serving (nginx/Apache)
   • Set up STATIC_ROOT for production

4. Email Backend:

   • Configure SMTP settings for contact forms
   • Set up proper email templates

5. Domain & SSL:

   • Configure proper domain name
   • Set up SSL certificate for HTTPS

📊 Version History

• v1.0: Initial release
  • Core website functionality
  • Contact and newsletter systems
  • Responsive Bootstrap design
  • Admin panel integration
  • Social media integration

---

Crafted with 🍃 for Premium Organic Tea Experience