sankalp
31688a6b04
Added new templates for project management functionality including listing, creation, and detailed views. These templates integrate with HTMX for dynamic interactions and provide a responsive layout. **New Features** - **project_list.html**: Displays a table of projects with status badges, client associations, and deadline tracking. Includes actions for creating, editing, and deleting projects. - **project_detail.html**: Shows detailed project information including status, description, client, and deadline. Features an embedded kanban board for task management and a modal for task creation. - **project_form.html**: Provides a multi-step form wizard for creating/editing projects with validation and navigation controls. **Enhancements & Refinements** - Responsive design across all templates for consistent UX on different devices. - Dynamic status badges color-coded based on project state. - Integrated HTMX for seamless form submissions and DOM updates in project list and task management.
DevSuite
DevSuite is a comprehensive management system designed for developers and agencies to streamline client management, project tracking, finance, and productivity.
Features
- Client Management: Track clients, contact details, and unique short codes.
- Project Management: Manage projects, milestones, and tasks with deadlines.
- Service Management: Track recurring services (domains, hosting) and their expiry dates.
- Finance: Generate invoices, track payments, and manage expenses.
- Productivity: Log time entries and track duration for projects.
- Automated Notifications: Email alerts for deadlines, due dates, and service expirations.
Modules
The project is organized into the following core modules in src/models/:
- Clients (
clients.py):Clientmodel. - Projects (
projects.py):Project,Milestone,Taskmodels. - Services (
services.py):Service,Credentialmodels. - Finance (
finance.py):Invoice,Payment,Expensemodels. - Productivity (
productivity.py):TimeEntry,Notemodels. - Notifications (
notifications.py):Notificationmodel and sending logic.
Setup
Prerequisites
- Python 3.10+
just(optional, for command shortcuts)
Installation
Using Just (Recommended)
-
Clone the repository:
git clone https://github.com/S4NKALP/DevSuite.git cd DevSuite -
Configure Environment: Copy
.env.sampleto.envand update the values:cp .env.sample .env -
Run Setup: This installs dependencies, runs migrations, and creates a superuser.
just setup -
Run Server:
just dev
Traditional Method
-
Install dependencies:
pip install -r requirements.txt -
Configure Environment: Copy
.env.sampleto.envand update the values:cp .env.sample .env -
Initialize Database:
python manage.py migrate python manage.py createsuperuser -
Run Server:
python manage.py runserver
Notifications
DevSuite includes an automated email notification system.
- Triggers: Project deadlines, Milestone due dates, Service expiry, Invoice due dates.
- Command:
python manage.py send_notifications - Automation: Use
scripts/run_notifications.shin a cron job.
For detailed documentation, see notifi.md.
Testing
Run the full test suite with:
python manage.py test
For detailed testing documentation, see testing.md.
Management Commands
send_notifications: Checks for upcoming events and sends emails.python manage.py send_notifications
Admin Interface
Access the Django admin at http://localhost:8000/admin/ to manage all records.