Welcome to Happy Habitat
Happy Habitat is a comprehensive web-based platform designed to streamline the management of condominiums and residential communities. Built with modern technologies, it provides a complete solution for administrators, residents, and service providers to manage daily operations efficiently.What is Happy Habitat?
Happy Habitat is a full-stack SaaS application that brings together all aspects of residential community management into a single, unified platform. From managing resident information and amenities to handling maintenance tickets and financial operations, Happy Habitat simplifies community administration.Key Features
Community Management
Manage multiple communities with customizable configurations, pricing structures, and resident data.
Resident Portal
Residents can manage their profiles, vehicles, pets, register visits, and track their charges and payments.
Financial Operations
Complete billing system with charges, payments, contracts, and bank account balance tracking.
Amenity Booking
Manage community amenities with booking capabilities, rules, and pricing.
Ticket System
Comprehensive support ticket system for maintenance requests and community issues.
Communications
Banners, announcements (comunicados), surveys, and document management for effective community communication.
Vehicle & Pet Registry
Track resident vehicles and pets with detailed information and type classifications.
Service Providers
Maintain a directory of approved community service providers with ratings and contact information.
Target Users
Happy Habitat serves three primary user groups:System Administrators
Full platform access to manage multiple communities, contracts, and system-wide configurations. Role Code:SYSTEM_ADMIN
Community Administrators
Manage a specific community including residents, amenities, tickets, and financial operations. Role Code:ADMIN_COMPANY
Residents
Access their personal dashboard to view announcements, manage their information, pay charges, submit tickets, and book amenities. Role Codes:RESIDENT, RENTER, COMITEE_MEMBER
Additional Roles
- Committee Members (
COMITEE_MEMBER): Community board members with extended privileges - Tenants (
RENTER): Rental residents with limited access - Security (
VIGILANCE): Security personnel managing visitor access
Technology Stack
Backend
- .NET 8.0: Modern C# backend with ASP.NET Core
- Entity Framework Core: SQL Server database with Code-First approach
- JWT Authentication: Secure token-based authentication
- Clean Architecture: Organized into Domain, Application, Infrastructure, and API layers
Frontend
- Angular 19: Modern TypeScript-based frontend framework
- Tailwind CSS: Utility-first CSS framework
- DaisyUI: Component library for enhanced UI
- Chart.js: Data visualization and reporting
Database
- SQL Server: Robust relational database with Windows Authentication support
- Entity Framework Migrations: Version-controlled database schema
System Requirements
For Deployment
- Backend Requirements
- Frontend Requirements
- Development Environment
- .NET 8.0 SDK or Runtime
- SQL Server 2019 or later (or SQL Server Express)
- Windows Server (recommended) or Linux with SQL Server support
- 2GB RAM minimum (4GB recommended)
- 10GB disk space for application and database
Browser Support
- Chrome/Edge (latest)
- Firefox (latest)
- Safari (latest)
Internet Explorer is not supported. Please use modern browsers for the best experience.
Core Entities
Happy Habitat manages several core entities:- Communities: Residential complexes with configurations and settings
- Residents: Individual residents linked to user accounts and communities
- Users: Authentication accounts with role-based access
- Vehicles: Resident vehicle registry with type classification
- Pets: Pet registration with species and breed information
- Amenities: Bookable community facilities
- Tickets: Maintenance and support requests
- Charges & Payments: Financial transactions for residents and communities
- Documents: Shared documents and files per community
- Surveys: Community polls and feedback collection
Security Features
- JWT Token Authentication: Secure, stateless authentication
- Role-Based Authorization: Six distinct user roles with granular permissions
- Password Hashing: BCrypt password hashing for secure storage
- CORS Protection: Configurable cross-origin resource sharing
- Request Size Limits: 10MB global limit to prevent large payload attacks
- Unified Error Handling: Standardized error responses with trace IDs
Getting Started
Ready to set up Happy Habitat? Continue to the Quickstart Guide to install and configure your instance. For a deeper understanding of the system architecture, see the Architecture Overview.Support & Documentation
For production deployment guidelines, refer to the README.md file included in the source code, particularly regarding:
- JWT key configuration (
Jwt:Key) - CORS origins setup (
Cors:Origins) - Database recreation settings (
Database:RecreateOnStartup)