Saltar al contenido principal

Guía de instalación local

Pasos para levantar la documentación y ubicar el backend y frontend que aparecen en los adjuntos.

Requisitos previos​

  • Node.js 20 o superior para correr este sitio de documentación.
  • Docker si vas a levantar SQL Server localmente.
  • Un cliente SQL como Azure Data Studio, SSMS o sqlcmd.
  • Git.

1. Clonar o abrir los repositorios​

Este repositorio contiene solo la documentación. El backend y el frontend viven en sus propios proyectos.

2. Levantar la documentación​

npm install
npm run start

Abre http://localhost:3000.

3. Levantar SQL Server localmente​

Si necesitas reproducir el núcleo de datos:

docker run -e "ACCEPT_EULA=Y" -e "MSSQL_SA_PASSWORD=<TuPasswordSegura123!>" \
  -p 1433:1433 --name raftdb-sqlserver \
  -d mcr.microsoft.com/mssql/server:2022-latest

Ver Servidor y puertos para revisar el alcance de 1433.

4. Ejecutar scripts SQL relevantes​

El backend adjunto maneja un esquema DB-first. Los scripts importantes viven en Database/Scripts/ del proyecto backend y en Database/sql-server-schema.md.

Entre los más útiles están:

  • init-postgres.sql
  • init-mysql.sql
  • init-dns-tables-and-sps.sql
  • add_ai_usage_logs_table_and_sps.sql
  • update_profile_and_organization.sql
  • update_profile_full_migration.sql
  • usp_Users_ResetPasswordDirect.sql

5. Levantar el backend .NET​

Según el README.md del backend adjunto, el arranque local usa http://localhost:5133 y requiere configurar, como mínimo:

  • ConnectionStrings:RaftDb
  • Jwt
  • OAuth
  • Frontend:BaseUrl
  • MySqlProvisioning
  • DnsProvisioning
  • AiService
  • N8nProvisioning
  • DataProtection

El backend vive en una solución modular. Si vas a ejecutarlo localmente, revisa también:

  • Modules/Platform
  • Modules/Data
  • Modules/Domain
  • Modules/Provisioning
  • Modules/Hosting

6. Levantar el frontend Flutter​

El frontend adjunto es Flutter. Su instalación depende del target de desarrollo, pero el flujo general es:

  • instalar Flutter;
  • resolver dependencias con flutter pub get;
  • configurar la URL base del backend;
  • ejecutar la app en el dispositivo o emulador elegido.

Para el detalle exacto de endpoints y callbacks que consume, ver Frontend Flutter.

Verificación​

Antes de dar por buena la instalación local, confirmar que:

  • La documentación corre en localhost:3000.
  • SQL Server responde en localhost:1433.
  • El backend resuelve su configuración y arranca en localhost:5133.
  • El frontend Flutter llega al backend y autentica correctamente.