System Documentation

Portfolio Manager Engine

A high-performance, headless CMS designed for developers. Own your data, automate your infrastructure, and deploy anywhere.

Backend Python / Flask
Database Google Firestore
Deployment Serverless Ready
Styling Tailwind CSS
View on GitHub Donate

Platform Features

Performance

Pre-aggregated analytics and intelligent caching mechanisms ensure minimal latency for end-users.

Content Engine

Manage Blogs, Projects, and Downloads with a rich-text editing experience and structured metadata.

SEO Engine

Auto-generated JSON-LD, Sitemap.xml, and dynamic meta tag management for superior search ranking.

Career Studio

Built-in Resume Vault for managing versions and a Bio-Link (Linktree-style) directory.

Auto-Branding

Dynamic theme control with an auto-branding wizard that adapts the UI to your identity.

True Portability

Full export/restore capabilities. JSON-based backups ensure you can migrate your database instance instantly.

Security Core

Multi-Factor Authentication (TOTP), Role-Based Access Control (RBAC), and multi-account support.

Live Monitoring

Integrated health checks for deployments and domain expiry tracking with push alerts.

Push Notifications

Receive instant, real-time system alerts and inbound messages via VAPID service workers.

API Usage

The Portfolio Manager provides a robust set of JSON endpoints for external frontends (Headless mode).

🌎 Public Content

Endpoint Method Description
/api/settings GET Website branding, social URLs, and features.
/api/seo GET SEO metadata and auto-generated JSON-LD.
/api/blog GET List all published blog posts.
/api/projects GET List all projects and case studies.
/api/experience GET Career timeline and work history.
/api/downloads GET Software/App download links.
/api/sitemap GET Dynamic sitemap structure for search engines.

📈 Engagement & Interaction

Endpoint Method Description
/api/contact POST Submit contact form messages.
/api/analytics POST Log page views and visitor data.
/api/blog/<slug>/update_view POST Increment read count for a blog post.
/api/projects/<slug>/update_view POST Increment view count for a project.
/api/downloads/<id>/hit POST Track a file download click.

🔐 System & Admin

Endpoint Method Description
/api/push/public-key GET Retrieve the VAPID public key.
/api/push/subscribe POST Register a service worker subscription.
/api/health GET Basic system health check.
/api/export GET Export full encrypted JSON backup (Auth).

Installation Sequence

1

Prerequisites

  • Firebase Project (Firestore enabled)
  • ImgBB API Key (Free)
2

Setup Strategy

Option A: Local / VPS 

git clone ...
pip install -r requirements.txt
python main.py

Option B: Serverless

  1. Fork Repository
  2. Connect Vercel/Railway
  3. Add ENV: FIREBASE_CONFIG
  4. Deploy & Redirect
3

Verification

Visit /setup to launch the wizard:

  • • Upload Service Account
  • • Configure Admin User
  • • Set Brand Identity
4

Backup & Migration

The system is designed for instant portability. Export your entire database from the Danger Zone in Settings. You can restore this JSON file during any future setup to essentially "teleport" your entire portfolio logic to a new instance or provider.