A comprehensive project management platform built with FastAPI backend and React frontend, featuring role-based access control, Google OAuth authentication, and full CRUD operations for managing projects, tasks, and users.
- Project Management: Create, read, update, and delete projects
- Task Management: Full CRUD operations for tasks with status tracking
- User Management: User registration, profile management, and role assignment
- Activity Logging: Track all changes made to tasks and projects
- Real-time Updates: Live updates for task status changes and comments
- Google OAuth Integration: Secure authentication using Google accounts
- Role-Based Access Control (RBAC): Four distinct user roles with specific permissions
- JWT Token Management: Secure API access with refresh token support
- Create and manage only projects they own
- Create tasks within their owned projects
- Assign tasks exclusively to Developers within their projects
- View project analytics and progress reports
- View all tasks assigned to them across projects
- Update task status (To Do → In Progress → Done)
- Add comments and time logs to assigned tasks
- Upload attachments to tasks
- View progress of projects they have access to
- Comment on tasks within accessible projects
- Read-only access to project timelines and reports
- Cannot modify any project or task data
- FastAPI: Modern, fast web framework for building APIs
- SQLAlchemy: SQL toolkit and ORM
- Alembic: Database migration tool
- Pydantic: Data validation using Python type annotations
- Python-Jose: JWT token handling
- Authlib: OAuth implementation
- React 18: Modern React with hooks and context
- TypeScript: Type-safe JavaScript development
- React Query: Data fetching and caching
- React Router: Client-side routing
- Axios: HTTP client for API calls
- Google OAuth 2.0: Third-party authentication
- JWT: JSON Web Tokens for session management
To Do → In Progress → Done
- To Do: Newly created tasks awaiting work
- In Progress: Tasks currently being worked on
- Done: Completed tasks
- Python 3.9+
- Node.js 16+
- Google OAuth 2.0 credentials
-
Clone the repository
git clone <repository-url> cd jira-platform/backend
-
Create virtual environment
python -m venv venv source venv/bin/activate # On Windows: venv\Scripts\activate
-
Install dependencies
pip install -r requirements.txt
-
Environment variables Create
.envfile:DATABASE_URL=postgresql://username:password@localhost/jira_db SECRET_KEY=your-secret-key-here GOOGLE_CLIENT_ID=your-google-client-id GOOGLE_CLIENT_SECRET=your-google-client-secret ACCESS_TOKEN_EXPIRE_MINUTES=30
-
Database setup
alembic upgrade head
-
Run the server
uvicorn app.main:app --reload
-
Navigate to frontend directory
cd ../frontend -
Install dependencies
npm install
-
Environment variables Create
.envfile:REACT_APP_API_URL=http://localhost:8000 REACT_APP_GOOGLE_CLIENT_ID=your-google-client-id
-
Start development server
npm start
Once the backend is running, visit:
- Swagger UI: http://localhost:8000/docs
- ReDoc: http://localhost:8000/redoc
POST /auth/google- Google OAuth loginPOST /auth/refresh- Refresh access tokenPOST /auth/logout- Logout user
GET /users/me- Get current user profileGET /users/- List all users (Admin only)PUT /users/{user_id}- Update user profilePUT /users/{user_id}/role- Update user role (Admin only)
GET /projects/- List projects (filtered by role)POST /projects/- Create new projectGET /projects/{project_id}- Get project detailsPUT /projects/{project_id}- Update projectDELETE /projects/{project_id}- Delete project
GET /tasks/- List tasks (filtered by role and assignment)POST /tasks/- Create new taskGET /tasks/{task_id}- Get task detailsPUT /tasks/{task_id}- Update taskPUT /tasks/{task_id}/status- Update task statusDELETE /tasks/{task_id}- Delete task
- JWT Authentication: Secure token-based authentication
- Role-based Access Control: Granular permissions system
- OAuth 2.0: Secure third-party authentication
- SQL Injection Protection: Parameterized queries via SQLAlchemy
- CORS Configuration: Proper cross-origin resource sharing setup
- Input Validation: Pydantic models for request/response validation
- id, email, name, role, google_id, created_at, updated_at
- id, name, description, owner_id, created_at, updated_at
- id, title, description, status, project_id, assigned_to, created_by, created_at, updated_at
- id, entity_type, entity_id, action, user_id, details, timestamp
cd backend
pytest tests/ -vcd frontend
npm testFROM python:3.9-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
CMD ["uvicorn", "app.main:app", "--host", "0.0.0.0", "--port", "8000"]npm run build
# Deploy build/ directory to your hosting serviceDatabase Connection Issues
- Verify PostgreSQL is running
- Check database credentials in
.env - Ensure database exists and is accessible
Google OAuth Issues
- Verify Google Client ID and Secret
- Check OAuth consent screen configuration
- Ensure redirect URIs are properly configured
CORS Issues
- Verify frontend URL is in CORS origins list
- Check that API calls include proper headers
Permission Denied Errors
- Verify user role assignments
- Check JWT token validity
- Ensure proper authentication headers