SMMEs Virtual Incubation Platform

A comprehensive virtual incubation platform designed to support Small, Micro and Medium-sized Enterprises (SMMEs) with access to professional services, mentoring, and business growth opportunities.

📋 Table of Contents

Project Overview
Key Features
System Architecture
Database Design
Technology Stack
Project Structure
Getting Started
User Flows
API Endpoints
Contributing

🎯 Project Overview

The SMMEs Virtual Incubation Platform is a web-based ecosystem that connects small and medium-sized enterprises with critical business services. The platform enables entrepreneurs to:

Access Professional Services: Web design, digital marketing, mentoring
Manage Portfolio: Showcase business achievements and projects
Connect Virtually: Engage with service providers and mentors across the country
Track Business Growth: Monitor business development through an intuitive dashboard
Share Resources: Access guides, quotations, and business materials
Newsletter Engagement: Stay updated with business insights and opportunities

Target Users:

Business Owners & Entrepreneurs
Service Providers (Mentors, Designers, Marketers)
SMME Support Organizations

✨ Key Features

1. User Authentication & Management

User registration and login system
Session-based authentication
Secure password management
User profile management

2. Dashboard

Personalized business dashboard
Quick access to key services
User account information
Service recommendations

3. Service Marketplace

Browse available services
Service categories:
- 🎨 Web Design & Development
- 📱 Digital Marketing
- 🎓 Business Mentoring
- 📊 Management Assistance
- 💼 Business Support & Consultation

4. Portfolio Management

Create and manage business portfolios
Showcase company achievements
Display services offered
Portfolio analytics

5. File Management

Upload and manage business documents
Company registration files
Certificate management
Resource library

6. Additional Features

Contact/enquiry forms
Newsletter subscription
Service quotation requests
Business guides and resources

🏗️ System Architecture

High-Level Architecture Diagram

graph TB
    subgraph Client["Client Layer"]
        WEB["Web Browser"]
        MOBILE["Mobile Responsive"]
    end
    
    subgraph Web["Web Server Layer"]
        LANDING["Landing Pages<br/>home.html, index.html"]
        AUTH["Authentication<br/>login.php, register.php"]
        APP["Application Pages<br/>dashboard.php, services.php"]
    end
    
    subgraph Backend["Backend Processing"]
        AUTHLOGIC["Auth Logic<br/>auth.php"]
        PORTFOLIO["Portfolio Handler<br/>portfolio.php"]
        FILES["File Manager<br/>files.php"]
        SERVICES["Service Handler<br/>services.php"]
        ADS["Advertisement Handler<br/>advertisements.php"]
    end
    
    subgraph Assets["Assets & Resources"]
        CSS["Stylesheets<br/>css/"]
        JS["JavaScript<br/>js/"]
        IMG["Images & Media<br/>assets/"]
    end
    
    subgraph Data["Data Layer"]
        CSV["User Database<br/>users.csv"]
        FILES_STORAGE["File Storage<br/>assets/"]
    end
    
    WEB --> LANDING
    WEB --> AUTH
    WEB --> APP
    LANDING --> AUTHLOGIC
    AUTH --> AUTHLOGIC
    APP --> BACKEND
    BACKEND --> Data
    LANDING --> Assets
    APP --> Assets
    AUTH --> Assets

Component Architecture

graph LR
    subgraph Presentation["Presentation Layer"]
        INDEX["index.html"]
        DASHBOARD["dashboard.php"]
        SERVICES_PAGE["services.php"]
        PORTFOLIO_PAGE["portfolio.php"]
    end
    
    subgraph Business["Business Logic Layer"]
        AUTHSERVICE["Authentication<br/>Service"]
        PORTFOLIOSERVICE["Portfolio<br/>Service"]
        FILESERVICE["File<br/>Service"]
        SERVICECAT["Service<br/>Catalog"]
    end
    
    subgraph Data_Access["Data Access Layer"]
        USERS_DB["Users Database<br/>users.csv"]
        FILE_SYSTEM["File System<br/>Storage"]
    end
    
    INDEX --> AUTHSERVICE
    DASHBOARD --> PORTFOLIOSERVICE
    DASHBOARD --> FILESERVICE
    SERVICES_PAGE --> SERVICECAT
    PORTFOLIO_PAGE --> PORTFOLIOSERVICE
    
    AUTHSERVICE --> USERS_DB
    PORTFOLIOSERVICE --> FILE_SYSTEM
    FILESERVICE --> FILE_SYSTEM
    SERVICECAT --> FILE_SYSTEM

💾 Database Design

Database Schema

erDiagram
    USERS ||--o{ PORTFOLIO : creates
    USERS ||--o{ QUOTATION : requests
    USERS ||--o{ ADVERTISEMENT : views
    USERS ||--o{ FILES : uploads
    PORTFOLIO ||--o{ FILES : contains
    SERVICES ||--o{ QUOTATION : receives
    
    USERS {
        int id PK
        string firstname
        string lastname
        string email UK
        string password
        timestamp created_at
        string status
        string phone
        string company_name
    }
    
    PORTFOLIO {
        int id PK
        int user_id FK
        string company_name
        string description
        string industry
        date created_date
        timestamp updated_at
        string status
    }
    
    SERVICES {
        int id PK
        string service_name
        string category
        text description
        float price
        int provider_id
        string status
    }
    
    QUOTATION {
        int id PK
        int user_id FK
        int service_id FK
        text description
        float amount
        date request_date
        string status
        timestamp created_at
    }
    
    ADVERTISEMENT {
        int id PK
        int user_id FK
        string title
        text content
        date posted_date
        string status
    }
    
    FILES {
        int id PK
        int user_id FK
        int portfolio_id FK
        string filename
        string file_type
        string file_path
        long file_size
        timestamp uploaded_at
    }

Data Relationships

Entity	Relationships	Purpose
USERS	Central entity	Stores all user/business information
PORTFOLIO	One User → Many Portfolios	Tracks business portfolios for each user
SERVICES	Many to Many with Users	Marketplace for available services
QUOTATION	Links Users to Services	Tracks service quotes and requests
FILES	Many to One with Users/Portfolio	Manages uploaded documents and assets
ADVERTISEMENT	One User → Many Ads	User promotional content

Current Database (users.csv)

id | firstname | lastname | email | password | created_at
1  | Siphelele | Maphumulo | Siphelelemaphumulo@gmail.com | [hashed] | 2025-05-07 02:30:45

🛠️ Technology Stack

Frontend Technologies

Technology	Version	Purpose
HTML5	Latest	Semantic markup and structure
CSS3	Latest	Styling and responsive design
JavaScript (Vanilla)	ES6+	Client-side interactions
Normalize.css	8.0.1	Cross-browser compatibility
Font Awesome	6.4.2	Icons and glyphs
Google Fonts	Latest	Typography (Montserrat, Roboto Slab)

Backend Technologies

Technology	Version	Purpose
PHP	7.4+	Server-side scripting
Sessions	Native PHP	User authentication management
CSV Storage	-	User data persistence

Dependencies (Composer)

{
  "vlucas/phpdotenv": "^5.6",
  "graham-campbell/result-type": "^1.1"
}

Supporting Libraries

Library	Purpose
Pikaday	Date picker functionality
Modernizr	Feature detection
BookBlock	Book-style animations
Classie	CSS class manipulation

Development Environment

Server: Apache (XAMPP)
Workspace Root: c:\xampp\htdocs\Incubation
Version Control: Git
Configuration: Environment variables (.env)

📁 Project Structure

Incubation/
├── 📄 README.md                          # This file
├── 📄 composer.json                      # PHP dependencies
├── 📄 composer.lock                      # Locked dependencies
├── 📄 .env                               # Environment configuration
├── 📄 .gitmodules                        # Git submodules
│
├── 🔐 Authentication & Core
│   ├── auth.php                          # Session authentication logic
│   ├── login.php                         # Login processing
│   ├── signup.php                        # Registration processing
│   ├── register.html                     # Registration form
│   ├── login.html                        # Login form
│
├── 📊 Pages
│   ├── index.html                        # Home page
│   ├── home.html                         # Landing page
│   ├── dashboard.php                     # User dashboard (requires auth)
│   ├── services.php                      # Services listing (requires auth)
│   ├── portfolio.php                     # Portfolio management (requires auth)
│   ├── files.php                         # File management (requires auth)
│   ├── advertisements.php                # Advertisement management
│   ├── contact.html                      # Contact form
│   ├── quotation.html                    # Quote request form
│   ├── guidehistory.html                 # Business guide
│
├── 🎨 Views/Layouts
│   ├── header.html                       # Common header
│   ├── Footer.html                       # First footer variant
│   ├── Footer2.html                      # Second footer variant
│   ├── newsletter.html                   # Newsletter section
│
├── 🎨 Stylesheets (css/)
│   ├── styles.css                        # Main stylesheet
│   ├── index.css                         # Home page styles
│   ├── index2.css                        # Alternative styles
│   ├── dashboard.css                     # Dashboard styling
│   ├── component.css                     # Component styles
│   ├── porfolio.css                      # Portfolio styles
│   ├── register.css                      # Registration styling
│   ├── newsletter.css                    # Newsletter styling
│   ├── quotation.css                     # Quotation form styling
│   ├── bookblock.css                     # Book animation styles
│   ├── dfg.css                           # Additional styles
│   ├── ads.css                           # Advertisement styling
│   ├── normalize.css                     # CSS normalize
│   └── siphelele.css                     # Custom styles
│
├── ⚙️ Scripts (js/)
│   ├── main.js                           # Main application script
│   ├── validation.js                     # Form validation
│   ├── newsletter.js                     # Newsletter logic
│   ├── bookblock.min.js                  # Book animation
│   ├── bookshelf.js                      # Bookshelf logic
│   ├── classie.js                        # CSS class helper
│   ├── modernizr.custom.js               # Feature detection
│   └── ilove.js                          # Custom interactions
│
├── 📦 Assets (assets/)
│   ├── img/
│   │   ├── portfolio/                    # Portfolio images
│   │   ├── team/                         # Team photos
│   │   ├── about/                        # About page images
│   │   ├── logos/
│   │   │   └── logo/                     # Company logos
│   │   └── [various product images]
│   ├── books/                            # Book assets
│   ├── companies/                        # Company assets
│   └── logos/                            # Brand logos
│
├── 📚 Vendor (vendor/)
│   ├── autoload.php                      # Composer autoloader
│   ├── composer/                         # Composer metadata
│   ├── vlucas/phpdotenv/                 # Environment variable loader
│   ├── graham-campbell/result-type/      # Result type helper
│   ├── phpoption/phpoption/              # Option type helper
│   └── symfony/polyfill-*/               # Symfony polyfills
│
├── 📊 Data
│   └── users.csv                         # User database (CSV format)
│
└── 🛠️ Configuration (hidden)
    ├── .git/                             # Git version control
    ├── .github/                          # GitHub actions/config
    ├── .vscode/                          # VS Code settings
    └── .sixth/                           # Additional config

File Purpose Matrix

File	Type	Purpose	Status
`auth.php`	Backend	Session validation & protection	✅ Active
`dashboard.php`	Backend/View	User dashboard interface	✅ Active
`services.php`	Backend/View	Service listing page	✅ Active
`portfolio.php`	Backend/View	Portfolio management	✅ Active
`files.php`	Backend/View	File/document management	✅ Active
`advertisements.php`	Backend/View	Ad management	✅ Active
`login.php`	Backend	Login processing	✅ Active
`signup.php`	Backend	Registration processing	✅ Active
`index.html`	Frontend	Home/landing page	✅ Active
`contact.html`	Frontend	Contact form	✅ Active
`quotation.html`	Frontend	Quote request form	✅ Active

🚀 Getting Started

Prerequisites

PHP 7.4 or higher
Apache Web Server (XAMPP recommended)
Composer (for PHP dependency management)
Web browser with JavaScript enabled

Installation Steps

Clone the Repository

git clone <repository-url>
cd Incubation

Install Dependencies
```
composer install
```
Configure Environment
- Copy .env.example to .env (if exists)
- Update configuration variables as needed

Start Local Server

# Using XAMPP
# Start Apache from XAMPP Control Panel
# Access at http://localhost/Incubation/

Access the Application
- Open browser to http://localhost/Incubation/
- Register new account or login
- Explore dashboard and features

First-Time Setup Checklist

Install PHP dependencies via Composer
Configure .env file with proper settings
Create database tables (from schema)
Import sample data if available
Verify all pages load correctly
Test user registration/login flow
Verify file upload functionality
Test responsive design on mobile

👥 User Flows

Authentication Flow

sequenceDiagram
    User->>Browser: Opens login.html
    Browser->>Server: Submits credentials
    Server->>Database: Validates credentials
    alt Valid Credentials
        Database-->>Server: User found & password matches
        Server->>Session: Create session (user_id)
        Server-->>Browser: Redirect to dashboard
        Browser->>Browser: Display dashboard.php
    else Invalid Credentials
        Database-->>Server: User not found OR password invalid
        Server-->>Browser: Display error message
        Browser->>Browser: Stay on login page
    end

Business Registration & Onboarding

sequenceDiagram
    Entrepreneur->>Browser: Visits Home Page
    Browser-->>Entrepreneur: Views features
    Entrepreneur->>Browser: Clicks "Sign Up"
    Browser->>Browser: Opens register.html
    Entrepreneur->>Browser: Fills registration form
    Browser->>Server: POST signup.php
    Server->>Database: Save user data
    Server-->>Browser: Confirmation
    Entrepreneur->>Browser: Logs in
    Browser->>Server: Login request
    Server->>Session: Create session
    Browser->>Dashboard: Load dashboard.php
    Entrepreneur->>Browser: Creates portfolio
    Browser->>Browser: Opens portfolio.php
    Entrepreneur->>Browser: Uploads business files
    Browser->>Server: File upload (files.php)
    Server-->>Browser: Files saved

Service Request Flow

sequenceDiagram
    User->>Dashboard: Logged in
    User->>Services: Browses services.php
    Services-->>User: Lists available services
    User->>Service: Selects desired service
    User->>Quotation: Fills quote form
    Quotation->>Database: Sends quotation request
    Database-->>User: Quote saved
    User-->>Email: Quote confirmation (optional)

🔌 API Endpoints

Authentication Endpoints

Method	Endpoint	Description	Authentication
`POST`	`/signup.php`	Register new user	No
`POST`	`/login.php`	Authenticate user	No
`GET`	`/auth.php`	Validate session	Yes

Dashboard Endpoints

Method	Endpoint	Description	Authentication
`GET`	`/dashboard.php`	User dashboard	Yes
`GET`	`/profile`	User profile data	Yes

Service Endpoints

Method	Endpoint	Description	Authentication
`GET`	`/services.php`	List all services	Yes
`GET`	`/quotation.html`	Quotation form	Yes
`POST`	`/quotation.php`	Submit quotation	Yes

Portfolio Endpoints

Method	Endpoint	Description	Authentication
`GET`	`/portfolio.php`	Portfolio management	Yes
`POST`	`/portfolio.php`	Create portfolio	Yes
`PUT`	`/portfolio.php`	Update portfolio	Yes

File Management Endpoints

Method	Endpoint	Description	Authentication
`GET`	`/files.php`	File listing	Yes
`POST`	`/files.php`	Upload file	Yes
`DELETE`	`/files.php`	Delete file	Yes

🔐 Security Features

Implemented Security Measures

Session-Based Authentication
- User sessions stored server-side
- Session validation on protected pages
- Automatic redirect to login for unauthorized access
Password Security
- Encrypted password storage
- Password hashing using bcrypt (confirmed)
Environment Configuration
- Use of .env for sensitive data
- PHP dotenv for secure configuration
Input Handling
- Form validation in JavaScript
- Server-side validation recommended for enhanced security

📊 Data Models

User Model

{
  "id": 1,
  "firstname": "Siphelele",
  "lastname": "Maphumulo",
  "email": "Siphelelemaphumulo@gmail.com",
  "password": "$2y$10$...",
  "created_at": "2025-05-07 02:30:45",
  "company_name": "Optional",
  "phone": "Optional",
  "status": "active|inactive"
}

Portfolio Model

{
  "id": 1,
  "user_id": 1,
  "company_name": "Company Name",
  "description": "Business description",
  "industry": "Technology",
  "created_date": "2025-05-07",
  "updated_at": "2025-05-07 02:30:45",
  "status": "active|inactive"
}

Service Model

{
  "id": 1,
  "service_name": "Web Design",
  "category": "design|marketing|mentoring|management|support",
  "description": "Service details",
  "price": 5000.00,
  "provider_id": 1,
  "status": "active|inactive"
}

📈 Performance & Scalability

Current Architecture Limitations

CSV-Based Storage → Consider database migration
File System Storage → Implement cloud storage (S3, Azure Blob)
Session Storage → Native PHP sessions sufficient for current scale
No Caching → Implement Redis for performance

Recommended Improvements

Migrate from CSV to MySQL/PostgreSQL
Implement object-oriented architecture
Add API rate limiting
Implement caching layer
Add logging and monitoring

🧪 Testing

Manual Testing Checklist

User registration validation
Login/logout functionality
Session timeout handling
File upload limits and validation
Responsive design on mobile devices
Cross-browser compatibility (Chrome, Firefox, Safari, Edge)
Form validation (client & server)
Permission-based access control

Recommended Testing Tools

Unit Testing: PHPUnit
Integration Testing: Postman/Insomnia
E2E Testing: Selenium/Cypress
Load Testing: Apache JMeter
Security Testing: OWASP ZAP

📝 Code Standards

PHP Coding Standards

PSR-12: Extended coding style guide
PSR-4: Autoloading standard
Naming: camelCase for variables/methods, PascalCase for classes

HTML/CSS Standards

Semantic HTML5
Mobile-first CSS design
BEM (Block, Element, Modifier) for CSS classes
Lowercase for file names

JavaScript Standards

ES6+ syntax
Vanilla JS (no external frameworks currently)
Event delegation for dynamic content
Unobtrusive JavaScript approach

🐛 Known Issues & Roadmap

Current Issues

Item 1: None reported
Item 2: None reported

Planned Features (Roadmap)

Phase 1: Database migration to MySQL
Phase 2: API development (REST/GraphQL)
Phase 3: Mobile application
Phase 4: Advanced analytics dashboard
Phase 5: Payment gateway integration
Phase 6: AI-powered recommendations

📞 Support & Contact

Getting Help

Bug Reports: Create an issue in the repository
Feature Requests: Discuss in project issues
Questions: Use discussions tab

Contact Information

Email: [contact email]
Website: [project website]
Phone: [contact phone]

📄 License

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

👨‍💻 Contributing

We welcome contributions! Please follow these steps:

Fork the repository
Create a feature branch (git checkout -b feature/AmazingFeature)
Commit changes (git commit -m 'Add AmazingFeature')
Push to branch (git push origin feature/AmazingFeature)
Open a Pull Request

Development Guidelines

Follow existing code style
Add comments for complex logic
Test thoroughly before submitting PR
Update documentation as needed
Keep commits atomic and descriptive

🙏 Acknowledgments

Built for supporting SMMEs growth
Community-driven development
Thanks to all contributors and supporters

Last Updated: April 10, 2026
Version: 1.0.0
Maintainer: Development Team

Name		Name	Last commit message	Last commit date
Latest commit History 50 Commits
.vscode		.vscode
assets		assets
css		css
js		js
vendor		vendor
.env		.env
.gitmodules		.gitmodules
.hintrc		.hintrc
Footer.html		Footer.html
Footer2.html		Footer2.html
README.md		README.md
advertisements.php		advertisements.php
auth.php		auth.php
composer.json		composer.json
composer.lock		composer.lock
contact.html		contact.html
dashboard.php		dashboard.php
files.php		files.php
guide.html		guide.html
header.html		header.html
home.html		home.html
ilove.js		ilove.js
index copy 3.html		index copy 3.html
index.html		index.html
login.html		login.html
login.php		login.php
newsletter.html		newsletter.html
portfolio.php		portfolio.php
quotation.html		quotation.html
quote.html		quote.html
register.html		register.html
services.php		services.php
signup.php		signup.php
subscribe.php		subscribe.php
success.html		success.html
users.csv		users.csv

Folders and files

Latest commit

History

Repository files navigation

SMMEs Virtual Incubation Platform

📋 Table of Contents

🎯 Project Overview

✨ Key Features

1. User Authentication & Management

2. Dashboard

3. Service Marketplace

4. Portfolio Management

5. File Management

6. Additional Features

🏗️ System Architecture

High-Level Architecture Diagram

Component Architecture

💾 Database Design

Database Schema

Data Relationships

Current Database (users.csv)

🛠️ Technology Stack

Frontend Technologies

Backend Technologies

Dependencies (Composer)

Supporting Libraries

Development Environment

📁 Project Structure

File Purpose Matrix

🚀 Getting Started

Prerequisites

Installation Steps

First-Time Setup Checklist

👥 User Flows

Authentication Flow

Business Registration & Onboarding

Service Request Flow

🔌 API Endpoints

Authentication Endpoints

Dashboard Endpoints

Service Endpoints

Portfolio Endpoints

File Management Endpoints

🔐 Security Features

Implemented Security Measures

📊 Data Models

User Model

Portfolio Model

Service Model

📈 Performance & Scalability

Current Architecture Limitations

Recommended Improvements

🧪 Testing

Manual Testing Checklist

Recommended Testing Tools

📝 Code Standards

PHP Coding Standards

HTML/CSS Standards

JavaScript Standards

🐛 Known Issues & Roadmap

Current Issues

Planned Features (Roadmap)

📞 Support & Contact

Getting Help

Contact Information

📄 License

👨‍💻 Contributing

Development Guidelines

🙏 Acknowledgments

Quick Links

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Uh oh!

Packages