KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #codex #typescript #developer-tools #ai-agents #deepseek-harness #claude-code #ai-agent #cli #react #mcp

freelance

★ 31 Open GitHub ↗

Gestión integral para autónomos: facturación, clientes, catálogo de artículos y cálculo automático de modelos fiscales trimestrales (303, 130) y anuales (390)

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Freelance

Gestión integral para autónomos: facturación, clientes, catálogo de artículos y cálculo automático de modelos fiscales trimestrales (303, 130) y anuales (390).

## Capturas

### Facturación

![Panel de control](https://raw.githubusercontent.com/ruromgar/freelance/main/images/dashboard.png)
![Clientes](https://raw.githubusercontent.com/ruromgar/freelance/main/images/clientes.png)
![Catálogo de artículos](https://raw.githubusercontent.com/ruromgar/freelance/main/images/articulos.png)
![Listado de facturas](https://raw.githubusercontent.com/ruromgar/freelance/main/images/facturas.png)
![Detalle de factura](https://raw.githubusercontent.com/ruromgar/freelance/main/images/factura.png)

### Fiscal

![Año fiscal](https://raw.githubusercontent.com/ruromgar/freelance/main/images/ano_fiscal.png)
![Trimestre](https://raw.githubusercontent.com/ruromgar/freelance/main/images/trimestre.png)

## Instalación

1. Instala [Docker Desktop](https://www.docker.com/products/docker-desktop/)
2. Clona o descarga el repositorio a alguna carpeta, digamos `proyecto_descargado`
3. Abre una terminal y ejecuta:

```bash
cd proyecto_descargado
cp .env.example .env
docker compose up
```

4. Abre `http://localhost:8000` en tu navegador

Tus datos se guardan en `.data/` y persisten entre ejecuciones. Para parar la aplicación, pulsa `Ctrl+C` en la terminal.

### Superusuario por defecto

En el primer arranque se crea automáticamente un superusuario:

- **Usuario**: `admin`
- **Contraseña**: `supersecret`

Cambia la contraseña tras el primer inicio de sesión desde el panel de admin en `/room/`.

## Setup de desarrollo

```bash
uv sync
cp .env.example .env   # rellenar con tus datos
make migrate
make run
```

## Stack

- **Backend**: Django 5.x
- **Frontend**: Tailwind CSS (CDN), HTMX
- **Admin**: Django Admin con tema Unfold (`/room/`)
- **Base de datos**: SQLite
- **Gestor de paquetes**: uv

freelance

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README