Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/17Franco/CulturarteWeb/llms.txt

Use this file to discover all available pages before exploring further.

CulturarteWeb is a Jakarta EE web application built to power a cultural crowdfunding ecosystem. It gives artists, organizers, and cultural creators — called Proponentes — a place to publish event proposals and seek funding from the community. Supporters — called Colaboradores — can browse those proposals, back the ones they believe in, and receive returns such as free tickets or profit shares once the event succeeds. The platform is backed by an external SOAP business-logic service (ControllerWS), a MySQL 8 database, and is fully containerized with Docker Compose for straightforward deployment.

User Types

CulturarteWeb recognizes two distinct roles. Every action in the application is shaped by which role a logged-in user holds.
ProponenteColaborador
PurposeCreates and manages cultural event proposalsDiscovers proposals and funds them
Key actionsPublish proposals, extend deadlines, cancel proposals, generate Trello boardsCollaborate on proposals, pay collaborations, download certificates
Login restrictionDesktop only — mobile login is blocked via User-Agent detectionNo device restriction
Profile dataFetched from the REST endpoint (/proponentes/{nick})Standard session data

Key Features

Proposals

Proponentes can create, extend, and cancel cultural event proposals. Each proposal tracks its funding progress, collaborators, and publication date.

Collaborations

Colaboradores back proposals with monetary contributions and choose a return type (e.g., free tickets or profit share). They can also withdraw a pending collaboration or pay an outstanding one.

Social Features

Users can follow and unfollow each other, view follower and following lists, mark proposals as favourites, and explore a ranking of users by activity.

Trello Integration

Proponentes can export all their proposals — including collaborator details and attached images — to a Trello board. Each proposal becomes a list; each collaborator becomes a card.

Docker Deployment

A docker-compose.yml spins up both the Tomcat 10.1 / JDK 21 web application container and a MySQL 8 database container in a single command, with persistent volume storage for the database.

Certificate Generation

After a collaboration is paid, Colaboradores can download a PDF payment certificate. The PDF is generated server-side by the ControllerWS SOAP service and streamed directly to the browser.
CulturarteWeb depends on an external ControllerWS SOAP service for all core business logic — including login, registration, proposal management, collaboration processing, and PDF generation. This service must be running and reachable at the host and port defined in config.properties before the web application can serve any requests.

Next Steps

Quickstart

Clone the repo, configure config.properties, and run the application locally using Docker Compose or a manual Tomcat deployment.

Architecture

Explore the three-tier architecture: Jakarta EE servlets, the SOAP ControllerWS service, and the MySQL data layer.

Build docs developers (and LLMs) love