92 lines
1.8 KiB
Markdown
92 lines
1.8 KiB
Markdown
# expenses_manager
|
|
|
|
## Descripción
|
|
expenses_manager es una aplicación diseñada para ayudarte a gestionar tus gastos diarios. Fue creada con la intención de hacer que el seguimiento de finanzas personales sea más sencillo y eficiente.
|
|
|
|
## Uso Básico
|
|
La aplicación permite:
|
|
- Registrar ingresos y egresos.
|
|
- Visualizar tus gastos por categoría.
|
|
- Generar informes financieros mensuales y semanales.
|
|
|
|
## Índice
|
|
1. [Instalación](#instalación)
|
|
2. [Configuración](#configuración)
|
|
3. [Uso](#uso)
|
|
|
|
## Instalación
|
|
|
|
### Despliegue en Local
|
|
|
|
#### Requisitos:
|
|
- Python 3.8 o superior.
|
|
- pip.
|
|
|
|
#### Pasos:
|
|
1. Clona el repositorio usando Git:
|
|
|
|
```sh
|
|
git clone https://gitea.kuijper.es/jkuijperm/expenses_manager.git
|
|
```
|
|
|
|
2. Navega al directorio del proyecto:
|
|
|
|
```sh
|
|
cd expenses_manager
|
|
```
|
|
|
|
3. Instala las dependencias necesarias:
|
|
|
|
```sh
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
### Despliegue en Docker
|
|
|
|
#### Pasos:
|
|
1. Clona el repositorio usando Git:
|
|
|
|
```sh
|
|
git clone https://gitea.kuijper.es/jkuijperm/expenses_manager.git
|
|
```
|
|
|
|
2. Navega al directorio del proyecto:
|
|
|
|
```sh
|
|
cd expenses_manager
|
|
```
|
|
|
|
3. Construye la imagen Docker:
|
|
|
|
```sh
|
|
docker build -t expenses_manager .
|
|
```
|
|
|
|
4. Corre el contenedor:
|
|
|
|
```sh
|
|
docker run -p 5000:5000 expenses_manager
|
|
```
|
|
|
|
## Configuración
|
|
|
|
Después de clonar el repositorio y instalar las dependencias, puedes configurar la aplicación creando un archivo `.env` en el directorio raíz del proyecto con el siguiente contenido:
|
|
|
|
env
|
|
|
|
SECRET_KEY=mi_clave_secreta_única_y_segura
|
|
|
|
DATABASE_URL=sqlite:///expenses.db # Otra URL de base de datos si es necesario
|
|
|
|
## Uso
|
|
|
|
1. Inicia la aplicación:
|
|
|
|
```sh
|
|
python app.py
|
|
```
|
|
|
|
2. Abre tu navegador y visita `http://localhost:5000` para acceder a la interfaz de usuario.
|
|
|
|
### Registro de Gastos
|
|
- Accede a la página de gastos y agrega nuevos registros manualmente o importa datos desde otras fuentes. |