🏫 Fatima Convent Senior Secondary School Website

[

A modern, feature-rich Django-based content management system (CMS) for educational institutions. Designed specifically for Fatima Convent Senior Secondary School, this application provides an intuitive platform for school administrators to manage and showcase school information, events, and multimedia content.

Features • Installation • Usage • Architecture • Contributing

📖 Overview

The Fatima Convent Senior Secondary School Website is a comprehensive web application built with Django, enabling school administrators to manage and display:

Dynamic Homepage with customizable banner slideshow
Institutional Information including school history, mission, and principal details
Media Gallery with organized photo and video content
News & Updates for communicating important announcements
Fee Structure information for students and parents
Newsletter Subscription system for alumni engagement
Admin Dashboard for easy content management without coding

This project demonstrates best practices in Django development, including proper model design, template hierarchy, and static file management.

✨ Features

Core Features

✅ Dynamic Banner Management - Admin-managed homepage banners with image support
✅ About Section - Dedicated page for school history, principal profile, and institutional information
✅ Gallery System - Categorized image and video gallery with media organization
✅ Newsletter System - Email subscription functionality for alumni and interested parties
✅ News Updates - Real-time updates and announcements management
✅ Fee Structure - Display and manage school fee information

Technical Features

✅ Django Admin Panel - Comprehensive admin interface for content management
✅ Responsive Design - Mobile-friendly interface using Bootstrap 4+
✅ Static Asset Management - Optimized CSS, JavaScript, and image handling
✅ Database Migrations - Version-controlled database schema management
✅ Media Upload Support - Easy image and video uploads with Django's media handling
✅ SEO-Friendly - Structured URLs and semantic HTML templates

🛠️ Technology Stack

Category	Technology
Backend	Python 3.x, Django 3.x+
Database	SQLite3 (development), PostgreSQL (production)
Frontend	HTML5, CSS3, JavaScript (ES6+)
CSS Framework	Bootstrap 4+
Icon Library	Font Awesome
JavaScript Libraries	jQuery, Owl Carousel, Masonry, Magnific Popup, ScrollReveal
Package Manager	pip
Version Control	Git

📋 Prerequisites

Before you begin, ensure you have the following installed:

Python 3.8 or higher - Download Python
Git - Download Git
pip - Usually comes with Python
Virtual Environment - Built-in with Python (venv)

System Requirements

OS: Windows, macOS, or Linux
RAM: Minimum 512MB (1GB recommended)
Disk Space: Minimum 500MB
Browser: Modern browser with JavaScript enabled

🚀 Installation

Step 1: Clone the Repository

git clone https://github.com/mrinmoy-hex/FCSS-WEB.git
cd FCSS-WEB

Step 2: Create Virtual Environment

It's best practice to use a virtual environment to isolate project dependencies.

Windows (PowerShell):

python -m venv myenv
Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned
myenv\Scripts\Activate.ps1

Windows (Command Prompt):

python -m venv myenv
myenv\Scripts\activate.bat

macOS/Linux:

python3 -m venv myenv
source myenv/bin/activate

Step 3: Install Dependencies

pip install --upgrade pip
pip install -r requirements.txt

This installs all required packages including Django, Pillow (for image handling), and other dependencies specified in requirements.txt.

⚙️ Configuration

Environment Setup

Database Setup:
```
python manage.py makemigrations
python manage.py migrate
```
These commands create the SQLite database and apply all migrations.
Create Superuser Account:
```
python manage.py createsuperuser
```
You'll be prompted to enter username, email, and password. Use a secure password for production.
Collect Static Files (for production):
```
python manage.py collectstatic --noinput
```
This gathers all static files (CSS, JS, images) into staticfiles/ directory.

Settings Configuration

Edit SchoolApp/settings.py to customize:

# Key settings you may want to adjust:
DEBUG = True  # Set to False in production
ALLOWED_HOSTS = ['localhost', '127.0.0.1']  # Add your domain
DATABASES = {...}  # Database configuration
STATIC_URL = '/static/'  # Static files URL
MEDIA_URL = '/media/'  # Media files URL

📝 Usage

Running the Development Server

Start the development server with:

python manage.py runserver

The application will be available at:

Frontend: http://127.0.0.1:8000/
Admin Panel: http://127.0.0.1:8000/admin/

Accessing the Admin Panel

Navigate to http://127.0.0.1:8000/admin/
Log in with your superuser credentials
Manage content for:
- Banners - Homepage banner images and text
- About Section - School information and principal details
- Gallery - Photos and videos organized by category
- Newsletter Subscribers - Manage email subscriptions
- News Updates - Create and publish announcements
- Fee Structure - Maintain fee information

📁 Project Structure

FCSS-WEB/
├── App/                          # Main Django application
│   ├── migrations/               # Database migration files
│   ├── models.py                 # Database models definition
│   ├── views.py                  # View logic for rendering pages
│   ├── urls.py                   # URL routing
│   ├── admin.py                  # Django admin configuration
│   └── tests.py                  # Unit tests
│
├── SchoolApp/                    # Django project configuration
│   ├── settings.py               # Project settings
│   ├── urls.py                   # Project-level URL routing
│   ├── wsgi.py                   # WSGI application for deployment
│   └── asgi.py                   # ASGI application for async support
│
├── templates/                    # HTML templates
│   ├── base.html                 # Base template (inherited by all pages)
│   ├── index.html                # Homepage
│   ├── about.html                # About page
│   ├── gallery.html              # Gallery page
│   ├── contact.html              # Contact page
│   ├── fee_structure.html        # Fee structure page
│   └── admin/                    # Admin templates
│
├── static/                       # Static assets (CSS, JS, images)
│   ├── css/                      # Stylesheets
│   ├── js/                       # JavaScript files
│   ├── images/                   # Image assets
│   └── vendors/                  # Third-party libraries
│
├── media/                        # User-uploaded content
│   ├── banner_images/
│   ├── about_images/
│   └── gallery_images/
│
├── myenv/                        # Virtual environment directory
├── manage.py                     # Django management script
├── requirements.txt              # Python dependencies
├── db.sqlite3                    # SQLite database
├── Procfile                      # Deployment configuration
└── README.md                     # This file

💾 Database Models

Core Models

1. Banner

Represents homepage banner content with images and text.

- title: String
- image: Image field
- description: Text
- created_at: DateTime
- updated_at: DateTime

2. About

Stores school information, history, and principal details.

- title: String
- principal_name: String
- principal_image: Image field
- school_story: Text
- description: Text
- created_at: DateTime
- updated_at: DateTime

3. GalleryItem

Manages gallery photos and videos with categorization.

- category: String (choices-based)
- photo: Image field
- video: URL/Video field
- caption: String
- created_at: DateTime
- updated_at: DateTime

4. NewsletterSubscriber

Maintains email subscription list.

- email: Email field (unique)
- subscribed_at: DateTime
- is_active: Boolean

5. NewsUpdate

Handles news and announcements.

- title: String
- content: Text
- published_date: DateTime
- is_published: Boolean

6. FeeStructure

Displays school fee information.

- class: String
- annual_fee: Decimal
- monthly_fee: Decimal
- description: Text

🔗 API Endpoints

HTTP Method	Endpoint	Description
GET	`/`	Homepage with banner slideshow
GET	`/about/`	About page with school information
GET	`/gallery/`	Gallery page with categorized media
GET	`/contact/`	Contact page
GET	`/fee_structure/`	Fee structure information
GET	`/admin/`	Admin dashboard

🐛 Troubleshooting

Common Issues

1. Virtual Environment Not Activating

Problem: Cannot find myenv\Scripts\Activate.ps1

Solution:

# Ensure you're in the project root directory
cd FCSS-WEB

# Recreate virtual environment
python -m venv myenv

2. Module Import Errors

Problem: ModuleNotFoundError: No module named 'django'

Solution:

# Ensure virtual environment is activated
pip install -r requirements.txt

3. Database Migration Errors

Problem: django.db.utils.OperationalError

Solution:

# Reset migrations (development only!)
rm db.sqlite3
python manage.py makemigrations
python manage.py migrate

4. Static Files Not Loading

Problem: CSS/JS not displaying in browser

Solution:

# Collect static files
python manage.py collectstatic --clear --noinput

# Ensure DEBUG = True in development
# Check STATIC_URL and STATIC_ROOT in settings.py

5. Port 8000 Already in Use

Problem: Address already in use

Solution:

# Use a different port
python manage.py runserver 8001

# Or kill the process using port 8000

6. Permission Denied on Activation Script (PowerShell)

Problem: cannot be loaded because running scripts is disabled

Solution:

Set-ExecutionPolicy -Scope Process -ExecutionPolicy RemoteSigned

🚢 Deployment

Production Deployment Checklist

Deployment Platforms

This application can be deployed on:

Heroku - See Procfile for configuration
PythonAnywhere
DigitalOcean
AWS EC2
Azure App Service
Self-hosted VPS

🤝 Contributing

We welcome contributions from the community! Whether you're fixing bugs, adding features, or improving documentation, your help is appreciated.

How to Contribute

Fork the Repository

# Click "Fork" on GitHub to create your own copy

Clone Your Fork

git clone https://github.com/your-username/FCSS-WEB.git
cd FCSS-WEB

Create a Feature Branch

git checkout -b feature/your-feature-name
# or
git checkout -b bugfix/issue-description

Make Your Changes
- Follow Django best practices
- Write clean, readable code
- Add comments for complex logic
- Update relevant documentation

Commit Your Changes

git commit -m "Add feature: Brief description of changes"

Push to Your Fork

git push origin feature/your-feature-name

Open a Pull Request
- Go to the original repository
- Click "New Pull Request"
- Describe your changes in detail
- Reference any related issues

Contribution Guidelines

Follow PEP 8 for Python code
Use meaningful variable and function names
Include docstrings for classes and functions
Write unit tests for new features
Update README.md if adding new features
Keep commits atomic and well-documented

Code Style

# Good example
def get_gallery_items(category=None):
    """
    Retrieve gallery items, optionally filtered by category.

    Args:
        category (str, optional): Filter by category name

    Returns:
        QuerySet: Filtered gallery items
    """
    queryset = GalleryItem.objects.all()
    if category:
        queryset = queryset.filter(category=category)
    return queryset

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

What You Can Do

✅ Use for commercial and private purposes
✅ Modify the code
✅ Distribute the software
✅ Use it with restrictions

Conditions

Include the original copyright notice and license
Provide a copy of the license

📞 Support

Getting Help

Documentation: See Project Structure and Database Models
Issues: GitHub Issues
Discussions: GitHub Discussions

Reporting Bugs

When reporting a bug, please include:

Python version
Django version
Steps to reproduce
Expected behavior
Actual behavior
Error traceback (if applicable)
Screenshots (if applicable)

Feature Requests

To suggest a new feature:

Check if it's already been requested in Issues
Create a new issue with the title "Feature Request: [Description]"
Describe the feature and why it would be useful

📚 Additional Resources

Django Documentation

Frontend Frameworks

Best Practices

🎯 Roadmap

Planned features and improvements:

👨‍💻 Authors & Contributors

Original Author: Mrinmoy and WIZARDOF-OZ

Contributors

Your Name - Contributions

🙏 Acknowledgments

Django community for excellent framework and documentation
Bootstrap team for responsive CSS framework
Font Awesome for icon library
All contributors and supporters of this project

Built with ❤️ for Fatima Convent Senior Secondary School

⬆ back to top

Name		Name	Last commit message	Last commit date
Latest commit History 131 Commits
App		App
SchoolApp		SchoolApp
static		static
templates		templates
.gitignore		.gitignore
.python-version		.python-version
LICENSE		LICENSE
Procfile		Procfile
README.md		README.md
build_files.sh		build_files.sh
manage.py		manage.py
requirements.txt		requirements.txt

Folders and files

Latest commit

History

Repository files navigation

🏫 Fatima Convent Senior Secondary School Website

📋 Table of Contents

📖 Overview

✨ Features

Core Features

Technical Features

🛠️ Technology Stack

📋 Prerequisites

System Requirements

🚀 Installation

Step 1: Clone the Repository

Step 2: Create Virtual Environment

Step 3: Install Dependencies

⚙️ Configuration

Environment Setup

Settings Configuration

📝 Usage

Running the Development Server

Accessing the Admin Panel

📁 Project Structure

💾 Database Models

Core Models

1. Banner

2. About

3. GalleryItem

4. NewsletterSubscriber

5. NewsUpdate

6. FeeStructure

🔗 API Endpoints

🐛 Troubleshooting

Common Issues

1. Virtual Environment Not Activating

2. Module Import Errors

3. Database Migration Errors

4. Static Files Not Loading

5. Port 8000 Already in Use

6. Permission Denied on Activation Script (PowerShell)

🚢 Deployment

Production Deployment Checklist

Deployment Platforms

🤝 Contributing

How to Contribute

Contribution Guidelines

Code Style

📄 License

What You Can Do

Conditions

📞 Support

Getting Help

Reporting Bugs

Feature Requests

📚 Additional Resources

Django Documentation

Frontend Frameworks

Best Practices

🎯 Roadmap

👨‍💻 Authors & Contributors

Contributors

🙏 Acknowledgments

About

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages