ColoCat is a comprehensive Java-based application designed to simplify and streamline the management of shared accommodations. The platform provides an integrated solution for handling authentication, expense tracking, event scheduling, incident reporting, and common space reservations.
- Authentication & Access Control: Secure user authentication and roommate management
- Expense Management: Automated expense tracking with balance calculations and statistical analysis
- Event Planning: Scheduling and coordination of communal activities (meals, social events, household tasks)
- Incident Tracking: Report and monitor housing-related incidents with follow-up capabilities
- Space Reservation: Book common areas with automated conflict detection
- Object-Oriented Design: Clean separation of concerns with modular package structure
- Architectural Patterns: MVC architecture with implementation of Singleton, Service Layer, and DTO patterns
- Data Persistence: Java serialization for robust data management
- User Interface: Swing-based GUI providing an intuitive and responsive user experience
login: Authentication and access controlevents: Event scheduling and managementincidents: Incident reporting and trackingreservations: Space reservation and conflict resolutionexpenses: Expense tracking and financial management
- Language: Java
- GUI Framework: Swing
- Data Management: Java Serialization (colocation.ser)
- Version Control: Git, GitHub, GitLab
- Modeling: UML
The project was developed following agile principles with emphasis on:
- Iterative development cycles (Scrum-inspired approach)
- Collaborative team management using Trello for task tracking
- Version control best practices with Git workflows
- Regular sprint reviews and retrospectives
- Trello: Project management and sprint planning
- GitLab/GitHub: Code repository and version control
- Google Meet: Remote team synchronization
- WhatsApp: Team communication
- Functional testing of core features
- User interface testing and usability validation
- Integration testing across modules
- Data persistence verification
- Java 8 or higher
- IDE with Swing support (IntelliJ IDEA, Eclipse, or NetBeans)
# Clone the repository
git clone https://github.com/Ykuzaa/colocat.git
cd colocat
# Compile the project
javac -d bin src/**/*.java
# Run the application
java -cp bin MainApplicationApplication data is persisted in colocation.ser using Java serialization. This file is automatically created on first launch.
- Enhanced reporting and analytics
- Export functionality (PDF, CSV)
- Mobile companion application
- Cloud synchronization capabilities
- Advanced notification system
This project is provided as-is for educational and collaborative use.
For inquiries or collaboration opportunities, please reach out through the repository issues section or contact the development team directly.