— Management app for football coaches

_{🗓️ Final Thesis developed in January 2025}

This project is a full-stack web application that allows football coaches to organize teams, players, trainings, and matches.
Coaches can track player needs, plan training sessions, and design match strategies for improved performance.

---

✅ Features

• User registration & login system.
• Team & Player Management: Create, edit, and manage teams and players.
• Training Planning: Schedule training sessions and select from a wide range of exercises.
• Match Preparation: Build lineups, review pre-game insights, and record post-match data for team and player analysis.
• Modern Web Stack:
  • Frontend: React (deployed on Vercel)
  • Backend: Node.js/Express (deployed on Heroku). The service is available only while the dynos are running, which typically incurs a cost of roughly $0.010 per hour.
• Cloud Database: Uses Firebase for real-time data storage (Google Cloud). A billing account with available credit is required for the service to operate.
• Responsive Design for desktop and tablet use.
• Scrum format tracked through Taiga (last images in the README).

ℹ️ Project frontend status:
This project was originally developed in late 2024 and throughout 2025, with a strong focus on functionality, software architecture, and project management. As my design and UX/UI skills have evolved since then, some aspects of the current UI and visual design could be further refined. The screenshots and demo therefore reflect the state of the application at the time of its development rather than my current design standards. Improving the UI/UX would be one of the main areas I would address in a future iteration.

---

🛠 Installation & Setup

a0. Prerequisites

Make sure you have installed:

• Node.js 18 or higher
• npm (comes with Node)

Check versions:

node -v
npm -v

a1. Clone the repository

git clone https://github.com/marcturu/letsmanage-clean.git
cd letsmanage-clean

a2. Firebase configuration

1. Copy the example file to create your real .env:

cd backend
cp .env.example .env

2. Access Google Cloud Console → IAM & Admin → Service Accounts of the LetsManage project.
3. Create a Service Account Key (JSON) if you don't already have one.
4. Add the credentials to the .env file.

a3. Run locally

Open two terminals and start frontend and backend:

# In /backend
npm install
npm start

# In /frontend
npm install
npm start

The app will be available at http://localhost:3000 (frontend) and http://localhost:5000 (backend).

b1. Try the web application

You can try the application using either the Vercel deployment (for visual testing in the browser) or the Heroku deployment (to test API routes).

• Vercel - WebApp: https://lets-manage-lake.vercel.app/
  Recommended for testing the user interface directly in the browser.

• Heroku - API: https://lets-manage-7d2ea4f309ff.herokuapp.com/
  Used to test the applciation's backend API.

🔋 Heroku availability: The Heroku backend may be temporarily unavailable when its Dynos are inactive. If the API is not responding, please contact me so I can activate the Dynos by:

1. Going to the Heroku Dashboard.
2. Navigating to Resources and activating the dynos.

ℹ️ Checking API errors: If you are contributing to or debugging the project, you can inspect the Heroku logs using the Heroku CLI:

1. Install Heroku CLI
2. Run $ heroku login
3. Run $ heroku logs --tail -a lets-manage

c1. Watch the Demo

🎥 A Recorded Demo is also available.

---

The Original repo is private due to privacy and confidentiality reasons,

as well as the deployed source code for the Frontend repo and the Backend repo.

---

📂 Documentation

All additional documentation is in the /DOCS directory:

• Context & Scope
• Methodology & Architecture
• Specification & Design
• Implementation Details
• Testing Strategy
• Project management
• Public Defense & Extras

Thesis grade: 8.3 (details in /GRADES).

---

📷 Screenshots

Main Page:

Register:

Log in:

Home:

Profile:

Clubs:

Exercise(s):

Team(s):

Player(s):

Match(es):

Training(s):

Select file:

Select club:

Select formation:

---

Use Cases Diagram:

Conceptual Data Model:

Class Dessign Model:

Physical Architecture Model:

Database Interaction Example:

201 Created Code Example:

Gantt Chart:

---

Taiga:

---

⚖️ Copyright & License

© 2025 Marc Turu Roca. All rights reserved.

This project and its contents are the exclusive intellectual property of Marc Turu Roca.
All rights reserved. No part of this project may be copied, modified, distributed, or used without prior written permission from the author.