Section 01
Project Overview
Digi Innovative Solutions is a full-service digital agency offering Web, Mobile, ERP, SEO and DevOps solutions to startups, SMEs and enterprises worldwide.
Primary Goals
Generate qualified leads, showcase services & portfolio, build brand authority, enable seamless content management.
Target Markets
USA, Australia, India. Targeting startups, SMEs and enterprise clients across all verticals.
Total Pages
17 production pages + admin panel + API backend. Static HTML + FastAPI CMS backend.
Performance
Lighthouse 90+ target. Pages load under 2 seconds. CDN-ready, GZIP enabled, lazy loading.
Section 02
Sitemap Structure
🌐 digiinnovativesolutions.com
🏠 Home
👥 About Us
⚙️ Services
🖼️ Portfolio
📰 Blog
💼 Careers
⚙️ Admin Panel (protected)
🔌 /api/* — FastAPI Backend
🗂️ sitemap.xml
Section 03
Page-wise Functional Documentation
Home Page — index.html
Live
▾
Primary landing page. Converts visitors to leads via hero CTA, service preview and testimonials.
Hero banner with CTA
Services overview grid
Why Choose Us section
Portfolio preview
Testimonials carousel
Stats counter animation
WhatsApp quick connect
GA4 analytics tracking
JSON-LD schema markup
Scroll animations
About Us — about.html
Live
▾
Company story & mission
Vision & values
Team member cards
Certifications display
Client logo strip
Company milestones
Admin: edit content
Admin: add team members
Services (5 sub-pages) — services.html + 4 sub-pages
Live
▾
Each service page follows the same layout: description → tech stack → process → pricing → FAQ → CTA.
Service description
Technologies used (tags)
Process workflow steps
Pricing plans section
FAQ accordion
Related case studies
Lead CTA + form link
Service-specific schema
Blog — blog.html
CMS
▾
Category filter tabs
SEO-optimised articles
Author + date display
Featured image support
Admin: create posts
Admin: publish / draft
Admin: meta title + desc
Admin: slug management
Careers — careers.html
CMS
▾
Dynamic job listings (API)
Application form (DB)
reCAPTCHA v3 protection
Rate limiting (3/min)
Admin: post jobs
Admin: view applications
Admin: pipeline statuses
Contact — contact.html
CMS
▾
Contact form → DB
reCAPTCHA v3
Rate limiting (5/min)
Input sanitization (bleach)
Social media links
Admin: view leads
Admin: status management
Admin: reply via mailto
Section 04
Admin Panel
Admin panel is live at digiinnovativesolutions.com/admin/ — protected by token authentication. Meta
noindex,nofollow prevents search indexing.
| Module | Description | Endpoints | Status |
|---|---|---|---|
| 📊 Dashboard | Stats overview: total leads, applications, posts, jobs with unread counts | GET /api/admin/stats | Live |
| 📬 Contact Leads | View, filter, search enquiries. Status: unread → read → replied. Mailto reply. | GET/PATCH/DELETE /api/admin/contacts | Live |
| 💼 Applications | Career pipeline. Status: new → reviewed → shortlisted → rejected → hired. | GET/PATCH/DELETE /api/admin/applications | Live |
| 📝 Blog Posts | Full CRUD. Auto-slug. Publish toggle. Category, excerpt, content, author. | GET/POST/PUT/DELETE /api/admin/blog | Live |
| 💼 Job Listings | Full CRUD. Department, location, type, salary, description, requirements. | GET/POST/PUT/DELETE /api/admin/jobs | Live |
| 🔍 SEO Console | Meta tags per page, sitemap.xml management | — | Planned |
| ⚙️ Settings | Branding, social links, SMTP config | — | Planned |
Section 05
Technical Stack
Full infrastructure currently deployed and running in production.
🐍
FastAPI 0.115
REST API Backend
Deployed
🐘
PostgreSQL 16
Primary Database
Deployed
🐋
Docker Compose
Containerisation
Deployed
🌐
Nginx (Proxy)
Reverse Proxy + SSL
Deployed
🦄
Gunicorn + Uvicorn
ASGI Server
Deployed
🔒
Let's Encrypt SSL
HTTPS
Deployed
🤖
reCAPTCHA v3
Bot Protection
Deployed
🧹
Bleach 6.2
Input Sanitization
Deployed
🚦
SlowAPI 0.1
Rate Limiting
Deployed
🔗
SQLAlchemy 2.0
ORM
Deployed
📊
Google Analytics 4
Tracking
Deployed
☁️
Cloudflare
CDN (Optional)
Optional
Infrastructure Topology
┌─────────────────────────────────────────────────────────┐
│ VPS · AlmaLinux 9.7 · 72.61.240.17 │
│ │
│ ┌──────────────────────────────────────────────────┐ │
│ │ Docker Network: digi_api_net │ │
│ │ │ │
│ │ [master_proxy_nginx] ─── /api/ ──► [api:8001] │ │
│ │ │ │ │ │
│ │ /var/www/ (static) [db:5432] │ │
│ │ HTML + CSS + JS PostgreSQL 16 │ │
│ └──────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────────┘
Section 06
Security Documentation
- ✓SSL / TLS via Let's Encrypt (HTTPS enforced)
- ✓Google reCAPTCHA v3 on all forms
- ✓Rate limiting (5/min contact, 3/min careers)
- ✓HTMLt input sanitization with bleach
- ✓Token-auth protected admin panel
- ✓Admin panel noindex / nofollow
- ✓CORS restricted to production origins
- ✓Environment variables for secrets (.env)
- ✓Parameterised SQL queries (SQLAlchemy ORM)
- ✓IP logging on form submissions
- ☐UFW / Firewalld server-level firewall
- ☐Daily automated backups (pgdump)
- ☐SMTP email alerts on suspicious activity
- ◌Fail2Ban brute-force protection
- ◌WAF (Cloudflare or ModSecurity)
Section 07
SEO Documentation
- ✓Unique meta title + description per page
- ✓Open Graph tags (og:title, og:description, og:image)
- ✓Twitter Card meta tags
- ✓JSON-LD schema (Organization, Service, Article)
- ✓XML sitemap (sitemap.xml)
- ✓robots.txt configured
- ✓Google Analytics 4 (GA4) integrated
- ✓Canonical URLs set
- ✓HTTPS (Google ranking signal)
- ✓Mobile-responsive design
- ☐Google Search Console verified
- ☐Core Web Vitals monitoring
- ☐Bing Webmaster Tools
- ◌Structured data for FAQs (FAQPage schema)
- ◌Hreflang for multi-language
Section 08
Performance Optimization
- ✓Intersection Observer scroll animations
- ✓CSS variables (single source of truth)
- ✓Minified inline CSS approach
- ✓Google Fonts with preconnect
- ✓No heavy JS frameworks (vanilla JS)
- ✓GZIP enabled via Nginx
- ✓FastAPI async endpoints
- ✓PostgreSQL connection pool (pool_pre_ping)
- ☐Image compression (WebP conversion)
- ☐Nginx static file caching headers
- ☐Lazy loading for images
- ◌Redis caching for API responses
- ◌CDN (Cloudflare) for static assets
Section 09
Deployment Documentation
VPS: AlmaLinux 9.7 · IP: 72.61.240.17 · Web root:
/var/www/digiinnovativesolutions/ · Backend: /opt/digi-api/
Static Frontend
Pure HTML/CSS/JS files served directly by Nginx. Deploy via scp from local to /var/www/.
Backend API
Docker Compose stack at /opt/digi-api/. Two services: db (PostgreSQL) + api (FastAPI).
Nginx Proxy
master_proxy_nginx container. Forwards /api/ requests to the API service on the shared Docker network.
Frontend Deploy (SCP)
# From local machine
scp -i ~/digi_vps *.html assets/ root@72.61.240.17:/var/www/digiinnovativesolutions/
Backend Deploy & Restart
# SSH into VPS
ssh -i ~/digi_vps root@72.61.240.17
# Pull and rebuild
cd /opt/digi-api
docker compose pull
docker compose up -d --build
# Restart nginx proxy
docker exec master_proxy_nginx nginx -s reload
Database Migration
# Run SQL directly on the db container
docker exec digi-api-db-1 psql -U digi -d digidb -c "ALTER TABLE ..."
Full Deployment Checklist
1
Pull from Git / copy files via SCP
Sync latest frontend and backend changes to the VPS.
2
Verify .env file on VPS
Confirm RECAPTCHA_SECRET, ADMIN_TOKEN, DB credentials are current.
3
Rebuild Docker containers
docker compose up -d --build from /opt/digi-api/.4
Run DB migrations if needed
Execute ALTER TABLE commands via docker exec psql.
5
Reload Nginx
docker exec master_proxy_nginx nginx -s reload6
Smoke-test production
curl https://digiinnovativesolutions.com/api/health → should return {"status":"ok"}.Section 10
API Reference
Base URL: https://digiinnovativesolutions.com/api · Admin endpoints require header
X-Admin-Token: <token>
| Method | Endpoint | Description | Auth |
|---|---|---|---|
| GET | /api/health | Health check | Public |
| POST | /api/contact | Submit contact form (rate 5/min) | reCAPTCHA |
| POST | /api/careers | Submit career application (rate 3/min) | reCAPTCHA |
| GET | /api/blog | List published blog posts | Public |
| GET | /api/blog/{slug} | Get single blog post | Public |
| GET | /api/jobs | List active job listings | Public |
| GET | /api/admin/stats | Dashboard stats | Admin |
| GET | /api/admin/contacts | List all contact submissions | Admin |
| PATCH | /api/admin/contacts/{id} | Update status | Admin |
| DELETE | /api/admin/contacts/{id} | Delete submission | Admin |
| GET | /api/admin/applications | List all career applications | Admin |
| POST | /api/admin/blog | Create blog post | Admin |
| PUT | /api/admin/blog/{id} | Update blog post | Admin |
| DELETE | /api/admin/blog/{id} | Delete blog post | Admin |
| POST | /api/admin/jobs | Create job listing | Admin |
| PUT | /api/admin/jobs/{id} | Update job listing | Admin |
| DELETE | /api/admin/jobs/{id} | Delete job listing | Admin |
Section 11
Development Roadmap
✅ Phase 1 — Complete
Core Website
- 17-page static website
- Mobile responsive design
- SSL + HTTPS
- GA4 + Schema markup
- WhatsApp button
- Sitemap + robots.txt
✅ Phase 2 — Complete
Backend & CMS
- FastAPI + PostgreSQL
- Contact + career forms → DB
- reCAPTCHA v3
- Rate limiting + sanitization
- Admin CMS panel
- Blog + Jobs CRUD
🔵 Phase 3 — In Progress
Enhancement
- Blog public rendering (API)
- Resume file upload
🟡 Phase 4 — Planned
Advanced Features
Section 12
Maintenance Plan
Monthly
Database backup, security patch review, SSL certificate check, dependency updates.
Quarterly
Full SEO audit, Lighthouse performance report, Core Web Vitals review, content refresh.
Bug Fixes
Critical bugs fixed within 24h. Non-critical addressed in weekly deploy cycle.
Security Monitoring
Admin token rotation every 90 days. Log review for unusual form submission patterns.
Quick Reference: Admin: digiinnovativesolutions.com/admin/ · VPS SSH:
ssh -i ~/digi_vps root@72.61.240.17 · Backend: /opt/digi-api/