Skip to content

Commit 70054b8

Browse files
committed
docs: add STORY_TIME origin story and replace live deployment links
1 parent 20ac5cd commit 70054b8

2 files changed

Lines changed: 65 additions & 3 deletions

File tree

README.md

Lines changed: 7 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -234,6 +234,7 @@ git push → GitHub Actions → Tests → Build Docker → Push to Docker Hub
234234

235235
- **GitHub Actions:** [View Workflows](https://github.com/udaycodespace/credify/actions)
236236
- **Docker Hub:** [View Images](https://hub.docker.com/r/udaycodespace/credify)
237+
- **Story Time:** [The Origins of Credify](docs/STORY_TIME.md)
237238

238239
***
239240

@@ -763,7 +764,7 @@ For questions, issues, or direct collaboration opportunities, please DM:
763764

764765
- **GitHub Repository:** [udaycodespace/credify](https://github.com/udaycodespace/credify)
765766
- **Docker Hub:** [udaycodespace/credify](https://hub.docker.com/r/udaycodespace/credify)
766-
- **Live Demo:** [Render Deployment](https://credify.onrender.com) *(if applicable)*
767+
- **How we built it:** [Story Time: The Origins of Credify](docs/STORY_TIME.md)
767768
- **Documentation:** See `/docs` folder in repository
768769

769770
***
@@ -842,9 +843,12 @@ cd credify
842843
docker-compose up -d
843844
```
844845

845-
### Render
846+
### 📖 The Origin Story
846847

847-
Automatically deployed from `main` branch via GitHub integration.
848+
Before we built an elite Private Blockchain, we explored Steganography, Android Hostel Management, and Web3 Voting systems.
849+
850+
Read the full story of our engineering decisions and deep pivots here:
851+
👉 **[Story Time: The Origins of Credify](docs/STORY_TIME.md)**
848852

849853
### Manual Deployment
850854

docs/STORY_TIME.md

Lines changed: 58 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,58 @@
1+
# 📖 Story Time: The Origins of Credify 2026
2+
3+
Every great engineering project starts with a brainstorm, a few rejections, and a late-night pivot. Here is the true story of how **Somapuram Uday**, **Shashi Kiran**, and **Teja Varshith** combined forces to build an elite Private Permissioned Blockchain network for their B.Tech Final Year Project.
4+
5+
***
6+
7+
## 🧠 The Brainstorming Phase (Early 2025)
8+
9+
When it came time to select our final year project, we wanted something that would genuinely push our technical boundaries. We formed our core trio and brought three very different, ambitious ideas to the drawing board.
10+
11+
### Idea 1: The "Ultimate" Steganography Vault (Proposed by Uday)
12+
Uday’s initial pitch was a high-tier steganography application. The goal wasn't just to hide text inside images, but to orchestrate a complex system capable of hiding secret messages, entire video files, and audio payloads inside other media. It was envisioned as a covert intelligence-style communication app.
13+
14+
### Idea 2: The Android Hostel Management Engine (Proposed by Varshith)
15+
Varshith leaned towards solving a practical, real-world administrative problem. He pitched a fully-fledged, native Android application built in Android Studio (Java) designed to completely digitize hostel management—handling check-ins, mess bills, complaints, and room allocations.
16+
17+
### Idea 3: The Decentralized Voting Machine (Proposed by Shashi)
18+
Shashi brought the concept of Web3 to the table: an unbreakable, transparent Blockchain Voting Machine aimed at eliminating election fraud using cryptographic ledgers to ensure mathematically un-tamperable elections.
19+
20+
***
21+
22+
## 🛑 The Academic Reality Check
23+
24+
After deep discussions, we initially leaned toward Uday's Steganography project. It felt like the easiest, fastest path to completion, requiring minimal novel infrastructure.
25+
26+
However, upon presenting this to our esteemed project guides, **Dr. B. Thimma Reddy Sir** and **Shri K Bala Chowdappa Sir**, it was immediately rejected. Their feedback was clear: *Steganography is a legacy concept. The industry has seen it done a thousand times. You need to build something modern, highly secure, and relevant to 2026.*
27+
28+
We then evaluated Varshith's Hostel Management app. While highly practical, developing a polished, bug-free native Android app of that scale within our constrained timeline was deemed too complex and resource-intensive, pulling us away from core backend engineering challenges.
29+
30+
***
31+
32+
## 💡 The Pivot: Fine-Tuning Shashi's Vision
33+
34+
Faced with a rejected idea and an overly complex one, we returned to Shashi's Web3 concept. Building an entire e-voting system from scratch carried severe security compliance risks. But the underlying technology—*Blockchain for immutable trust*—was exactly what the academic industry needed.
35+
36+
We pivoted the "voting" concept into something profoundly more relevant to us as students: **Verifiable Academic Credentials**. What if we could use a blockchain to issue our own B.Tech transcripts, mathematically proving to employers that they weren't forged?
37+
38+
Thus, **CREDIFY** was born.
39+
40+
***
41+
42+
## 🚀 The Evolution to "Elite" (The Mock vs. The Private Cloud)
43+
44+
### Phase 1: The "Mock" Blockchain (Late 2025)
45+
We initially developed a "mock" blockchain entirely in Python 3. It worked conceptually: it hashed blocks and signed documents securely. However, it was localized entirely in memory. It was an excellent proof-of-concept, but it lacked the true decentralized networking required of a genuine blockchain.
46+
47+
### Phase 2: The Transition to a True Private Blockchain (March 8, 2026)
48+
We refused to settle for a "mock" implementation. On March 8, 2026, guided by Uday's deep dive into DevOps and system architecture, we radically transitioned the platform.
49+
50+
We tore down the mock ledger and orchestrated a beautifully engineered **3-Node Private Permissioned Blockchain**. We containerized our Flask/Werkzeug cores into isolated Docker containers (`node1`, `node2`, `node3`), bridged them across an internal P2P network, and wrote dynamic consensus algorithms. Now, when a node spins up, it actively seeks its peers and synchronizes the global ledger asynchronously.
51+
52+
We layered it with **IPFS Distributed Storage**, bolted on **Zero-Knowledge Proofs (ZKPs)** for student privacy, and wrapped the entire engine in Shashi's breathtaking "Senior UI/UX" overhaul.
53+
54+
***
55+
56+
This is the story of how three engineering students went from an outdated steganography idea to building a production-ready, enterprise-grade Dockerized Blockchain network.
57+
58+
**Whole and sole, we 3 are owning it.**

0 commit comments

Comments
 (0)