Chabad Tefen Tefillin Project

Enterprise-level system developed during professional internship

Professional Development Project: This comprehensive system was developed as part of a professional software development internship, demonstrating practical experience in enterprise-level full-stack development.

A comprehensive digital platform managing tefillin distribution to IDF soldiers, handling the complete lifecycle from registration through distribution and ongoing engagement.

Project Overview

This project provides a digital platform for Chabad Tefen to manage their tefillin distribution program. The system tracks the entire process from soldier registration, approval, payment processing, and distribution to ongoing engagement and public content sharing.

Key Features

• Soldier Management: Registration, approval, and status management of soldiers
• Tefillin Tracking: Location and status tracking of tefillin
• Inventory Management: Tracking inventory across different distribution centers
• Reports & Analytics: Detailed reports on distribution progress
• Integrations: Connection to Google services and payment systems

Technical Components

• Backend API: Node.js TypeScript service with Express
• Admin Frontend: React TypeScript application (Material-UI)
• Public Portal: Next.js TypeScript application (Tailwind CSS)
• ETL Package: Integration services for external APIs
• Database: Supabase PostgreSQL
• Integrations: Google Auth, Google Drive, Meshulam payments

Architecture

Monorepo structure with shared TypeScript types and multiple specialized packages.

Technical Achievements

• Full-stack development of enterprise-grade system with 4 specialized packages
• Microservices architecture with shared TypeScript types across services
• Multi-cloud integration (Google Drive, Supabase, Meshulam payments)
• Automated testing & CI/CD pipeline with Jest and ESLint
• Responsive UI/UX with Material-UI and Tailwind CSS
• Real-time tracking system for inventory and distribution status
• Role-based access control with Google OAuth integration

Project Documentation

General Documentation

• Main Project Document - User roles, system components, project timeline, and wireframes
• Company Structure Document - Detailed breakdown of company responsibilities

Team-Specific PRDs

• Backend Team PRD - Detailed requirements for the Backend team
• Internal Frontend Team PRD - Detailed requirements for the Internal Frontend team
• Integrations Team PRD - Detailed requirements for the Integrations team
• Public Portal Team PRD - Detailed requirements for the Public Portal team

API Documentation

The API documentation is generated from the TypeScript definitions. You can view it here

Project Structure

├── packages/
│   ├── backend/           # Express.js API server
│   ├── frontend/          # React admin interface
│   ├── public-portal/     # Next.js public website
│   └── ETL/              # Integration services
├── types/                 # Shared TypeScript types
├── locales/              # Internationalization files
└── README.md

Development Setup

Prerequisites

• Node.js (v18+)
• npm
• Supabase CLI (optional)
• Git

Local Development

1. Clone the repository:

git clone https://github.com/ChayaZak/Tefillin-Flow.git
cd Tefillin-Flow

2. Install dependencies:

# Install all packages
npm install

# Or install per package
cd packages/backend && npm install
cd ../frontend && npm install
cd ../public-portal && npm install

3. Set up environment variables:

cp packages/backend/.env.example packages/backend/.env
cp packages/frontend/.env.example packages/frontend/.env

Update the variables with your local configuration.

4. Start the development servers:

# Backend (port 3001)
cd packages/backend && npm run dev

# Frontend (port 3000)
cd packages/frontend && npm start

# Public Portal (port 3000)
cd packages/public-portal && npm run dev

Available Scripts

Backend

npm run dev          # Start development server with nodemon
npm run build        # Build TypeScript to JavaScript
npm start            # Start production server
npm test             # Run tests with Jest
npm run lint         # Run ESLint
npm run typecheck    # TypeScript type checking

Frontend

npm start            # Start development server
npm run build        # Build for production
npm test             # Run tests
npm run lint         # Run ESLint

Public Portal

npm run dev          # Start Next.js development server
npm run build        # Build for production
npm start            # Start production server
npm run lint         # Run Next.js linting

Deployment

Backend

• Platform: Render or similar Node.js hosting
• Build command: npm run build
• Start command: npm start

Frontend

• Platform: Vercel, Netlify, or similar React hosting
• Build command: npm run build
• Output directory: build

Public Portal

• Platform: Vercel (recommended for Next.js)
• Build command: npm run build
• Output directory: .next

Database

• Supabase PostgreSQL
• Connection via environment variables

Environment Variables

Backend (.env)

SUPABASE_URL=your_supabase_url
SUPABASE_ANON_KEY=your_supabase_anon_key
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
JWT_SECRET=your_jwt_secret
PORT=3001

Frontend (.env)

REACT_APP_API_URL=http://localhost:3001
REACT_APP_GOOGLE_CLIENT_ID=your_google_client_id

Technical Skills Demonstrated

Frontend Development

• React 19 with TypeScript and Material-UI for admin interface
• Next.js 15 with Tailwind CSS for public portal
• Responsive design with mobile-first approach
• State management with Redux Toolkit

Backend Development

• Node.js & Express RESTful API with TypeScript
• PostgreSQL database design and optimization
• Authentication & Authorization with JWT and Google OAuth
• File upload & processing with Multer and Google Drive API

DevOps & Architecture

• Monorepo structure with shared type definitions
• CI/CD pipeline with automated testing
• Cloud deployment on Render/Vercel platforms
• Environment management and configuration

Integration & APIs

• Google Services (Auth, Drive, Calendar)
• Payment processing with Meshulam
• Real-time data synchronization
• ETL processes for data integration

Contributing

1. Create a new branch: git checkout -b feature/your-feature-name
2. Make your changes and test them
3. Commit: git commit -m "Add feature description"
4. Push: git push origin feature/your-feature-name
5. Create a Pull Request

License

This project is private and proprietary. Unauthorized copying, distribution, or use is strictly prohibited.

Project Impact

This system streamlines the entire tefillin distribution process, from soldier registration to delivery tracking, serving as a comprehensive management platform for a real-world nonprofit organization.