Welcome to Millenium Potters
A powerful, modern microfinance management platform designed to streamline your loan operations from member registration to repayment tracking. Built with Next.js 14, Node.js, and CockroachDB for scalability and reliability.Quick Navigation
Get Started
Set up Millenium Potters in minutes with our quickstart guide
Architecture Overview
Understand the system architecture and tech stack
API Reference
Explore the complete REST API documentation
User Roles
Learn about Admin, Supervisor, and Credit Officer roles
Core Features
Dashboard Analytics
Real-time insights with Command Center view
Union Management
Organize and manage member unions
Member Tracking
Complete member profiles with document uploads
Loan Processing
Full loan lifecycle from draft to completion
Repayment Tracking
Record and monitor all loan payments
Reporting
Supervisor reports and analytics
Key Capabilities
Role-Based Access Control
Role-Based Access Control
Three distinct user roles with tailored permissions:
- Admin: Full system access and user management
- Supervisor: Oversight of credit officers and reporting
- Credit Officer: Union and loan management within assigned areas
Comprehensive Loan Management
Comprehensive Loan Management
Complete loan lifecycle tracking:
- Draft creation and approval workflows
- Automated repayment schedule generation
- Multiple loan statuses (Active, Completed, Defaulted, Written Off)
- Support for various repayment methods (Cash, Transfer, POS, Mobile, USSD)
Production-Ready Infrastructure
Production-Ready Infrastructure
Built for scale and reliability:
- CockroachDB serverless database with automatic backups
- Cloudinary integration for document storage
- Maintenance mode for safe deployments
- Audit logging and activity tracking
- Supabase authentication with OAuth and JWT
Modern Tech Stack
Modern Tech Stack
- Frontend: Next.js 14, Tailwind CSS, Aceternity UI, Shepherd.js
- Backend: Node.js, Express, Prisma ORM
- Database: CockroachDB (production), PostgreSQL 18 (local)
- Auth: Supabase
- Storage: Cloudinary
Get Started
Review Prerequisites
Check system requirements and ensure you have Node.js 18+ and PostgreSQL 18 for local development.View prerequisites →
Set Up Environment
Configure your environment variables for both frontend and backend applications.Environment setup →
Initialize Database
Set up your database schema using Prisma and run initial migrations.Database setup →
Start Development
Launch the development servers and start building.Quickstart guide →
Popular Guides
User Management
Create and manage system users with appropriate roles
Loan Processing
Step-by-step guide to processing loans from application to approval
Repayment Tracking
Record and monitor loan repayments effectively
Reporting & Analytics
Generate insights with supervisor reports and analytics
Need Help?
View on GitHub
Explore the source code, report issues, or contribute to the project