facto

Herramienta de contabilidad familiar

La herramienta de contabilidad familiar realiza un seguimiento de cada transacción que realiza su familia. Su objetivo es:

• Extraer estadísticas útiles de los datos
  EG: ¿Cuánto se gasta en comida cada mes?
• Calcular la deuda interna
  EG: Alice compra papel higiénico para toda la familia con su propio dinero. Esta herramienta luego registra que la familia le debe a Alice el costo del papel higiénico.
• Proporcione una forma de verificar si ningún dinero está desapareciendo en gastos inesperados
  EG: Notarás cuando hay costos bancarios ocultos

Captura de pantalla

Instalación desde la versión

• Instale Java 11 (JDK 11) en su servidor
• Descargue "binarios (archivos compilados) con configuración de demostración" de la última versión
• Desempaquete el archivo
• Abra conf/application.conf en la carpeta desempaquetada:
  • Configurar una base de datos. La forma más fácil es configurar un servidor MariadB localmente, crear una base de datos vacía llamada facto y configurarlo de la siguiente manera:

 db.default {
  driver = com.mysql.jdbc.Driver
  url = "jdbc:mysql://localhost/facto?user=mysqluser&password=mysqlpassword"
  slick.profile = "slick.jdbc.MySQLProfile$"
}

• Elija valores secretos para play.http.secret.key y app.setup.defaultPassword

• Abra una terminal en la carpeta desempaquetada

• Ejecute los siguientes comandos para ejecutar la aplicación:

   # Create database tables
  bin/server -DdropAndCreateNewDb
  
  # Create admin user
  bin/server -DcreateAdminUser
  
  # Run application
  bin/server
  

• Examine a http: // localhost: 9000/app/userAdMinistration (nombre de usuario: "administrador", contraseña: "Changeme")

Instalación con Docker (desanimado)

Advertencia: lo siguiente funciona bien para lanzar un servidor de demostración para echar un vistazo. Pero si desea ejecutar esto como un servicio con datos reales y configuración personalizada, se recomienda seguir la sección "Instalación desde la versión" (consulte este problema por los motivos por los cuales).

Los siguientes comandos iniciarán un nuevo servidor junto con una base de datos en Docker Containers:

 # Get the docker-compose.yml file
wget https://raw.githubusercontent.com/nymanjens/facto/master/docker-compose.yml

# Choose a unique random string here of sufficient length
export APPLICATION_SECRET="$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 32 | head -n 1)"

# Create an empty database with a single admin user
docker-compose run web sleep 5 # Wait for the database to be ready
docker-compose run web bin/server -DdropAndCreateNewDb
docker-compose run web bin/server -DcreateAdminUser

# Bring up the server
docker-compose up

Cuando termine, navegue a http: // localhost: 9000/(nombre de usuario: "admin", contraseña: "changeme")

Configuración

• conf/application.conf :
  Configurar y configurar una base de datos aquí.
• Agregar usuarios:
  Se crea un usuario predeterminado con el indicador -DcreateAdminUser (nombre de usuario: admin, contraseña: changeme). Esta cuenta puede crear nuevos usuarios.
• conf/accounting-config.yml :
  Edite este archivo para reflejar su situación y preferencias. Tenga en cuenta que userLoginName debe referirse a un usuario que ya existe en la base de datos (ver punto anterior)

Uso

Para usar esta herramienta de manera efectiva, debe aprender a ingresar las transacciones correctamente. Por lo tanto, es importante comprender el significado de categorías y cuentas.

Categorías

Estos se utilizan para dividir sus gastos en categorías. Cada cuenta tiene algunas categorías especiales:

• Categoría de contabilidad:
  Utilizado para ingresos/gastos no reales. Esta categoría se ignorará al analizar el excedente/déficit mensual en términos de gastos. Use esta categoría, por ejemplo, cuando su empleador le devuelva el gasto.
• Categoría de dotación:
  Usado para transferencia de dinero a la cuenta común (ver ejemplo en la siguiente sección)

Cuentas

Una cuenta puede referirse a una persona regular o a la cuenta común.

Ejemplo:

Una familia tiene dos miembros: Alice y Bob. Habrá tres cuentas:

• Alicia
• Chelín
• La cuenta común

Alice y Bob transferirán regularmente dinero a la cuenta común que puede usarse para hacer gastos comunes. Esta transferencia a la cuenta común se llama 'dotación' .

Introducción de transacciones

Campos especiales:

• Beneficiario:
  En caso de un gasto: el que se beneficiará del gasto
  En caso de ingresos: el que se pagó
• Pagado con/a:
  En caso de un gasto: pagado con
  En caso de ingresos: pagado a
• Fluir:
  En caso de un gasto: número negativo que representa el precio
  En caso de ingresos: número positivo

Uso de la descripción general del flujo de efectivo de manera efectiva

La descripción general del flujo de efectivo es una herramienta poderosa para verificar los gastos no contados.

Debería:

• Establezca la cantidad actual de dinero que tenga para cada método de pago (efectivo, tarjeta, ...). Puede hacer esto usando el botón "Establecer" .
• Siempre que realice una transacción, el saldo se actualizará automáticamente.
• Puede volver a contener su efectivo y ver si coincide con el valor calculado. Si es así, puede usar el botón de casilla de verificación para marcar esto. Si no es así, ha cometido un error o ha perdido dinero.

Sobre este proyecto

Este proyecto fue creado y mantenido por mí (Jens) en mi tiempo libre para mi familia, y lo hice de código abierto con la esperanza de que pudiera ser útil para los demás.

Si decide usar esto, es probable que lo use mucho o deje de usarlo después de un tiempo. Si está en la categoría anterior, envíeme un mensaje a [email protected] (o considere enviar una donación) para que sepa que otros están usando esto. Definitivamente también avíseme si tiene algún interés en actualizar a versiones más nuevas o usar las características más avanzadas (ocultas) como los tipos de cambio y la corrección de inflación.