grÜppe projekt dotcom
HOMEPROJEKTSSERVICESABOUTKONTAKT
SYSTEM ACCEPTING PROJECTS

GRÜPPE
PROJEKT
DOTCOM

Building the infrastructure of tomorrow's web

NAVIGATION

  • Home
  • Projekts
  • Services
  • About
  • Kontakt

KONTAKT

  • nick@gruppeprojekt.com
  • Abita Springs ,LA

© 2026 GRÜPPE PROJEKT DOTCOM. ALL RIGHTS RESERVED.

ADMIN
← RETURN_TO_OVERVIEW
REL_DOC: SOLARI_ARCH_V1.0.0
ARCHITECTURAL_WHITEPAPER

SOLARI ARCHITECTURE

A comprehensive technical analysis of the Solari Construction ERP: full-stack architecture, the Machined Brutalism design system, relational data model, security framework, and the 16 integrated modules that power construction business operations.

SECTION_01

MACHINED BRUTALISM

A design philosophy synthesizing Dieter Rams' "Good Design" principles with Neo-Brutalist structural honesty. The interface is not decoration—it is a high-efficiency tool for business management, prioritizing informational density and functional clarity above all else.

VISUAL_RULES
TYPOGRAPHY

Monospace for all technical data. JetBrains Mono. Every character aligned for precision readouts.

STRUCTURE

High-contrast border-1.5px borders. Technical drawing aesthetic. Modular containers with explicit grid lines.

SHADOWS

Hard offset: shadow-4px_4px_0px_0px. No softness. UI elements feel like machined metal panels.

DENSITY

Zero wasted space. Information-first layouts. Built for high-frequency data retrieval.

COLOR

Signal Orange (#ea580c) is the ONLY accent. Reserved exclusively for primary actions and critical alerts.

UX_PRINCIPLES
OPTIMISTIC UPDATES

UI responds instantly, assuming success. On API failure, state auto-rollbacks. Preserves data integrity while delivering responsive UX.

KEYBOARD SHORTCUTS

Universal shortcuts: Enter to confirm, Escape to close. Power user efficiency for high-frequency operations.

COLLAPSIBLE SIDEBAR

Admin panel sidebar collapses to maximize workspace. Essential for dense data tables on any screen size.

TACTILE FEEDBACK

Micro-animations simulate physical switch presses. Button states reinforce user-system connection.

SECTION_02

FULL-STACK ARCHITECTURE

A modern, monolithic web application architected for performance, type safety, and streamlined deployment. Every technology choice is deliberate—prioritizing developer experience and zero-configuration production deployment.

TECHNOLOGY_STACK
FRAMEWORKNEXT.JS 16
ROUTERAPP ROUTER + TURBOPACK
LANGUAGETYPESCRIPT 5.X STRICT
DATABASESQLITE
ORMPRISMA
3D_ENGINEREACT THREE FIBER
STYLINGTAILWIND CSS 4.0
AUTHCOOKIE SESSIONS + JWT
FRONTEND_LAYER

Next.js 16 App Router with Server-Side Rendering for SEO-optimized public pages. TypeScript strict mode enforces complete type safety. Custom Tailwind design system codifies Machined Brutalism into reusable utility classes.

BACKEND_LAYER

Co-located API Routes within src/app/api/. Resource-based modular structure—each subdirectory corresponds to a feature (bills, clients, invoices). Single monolithic deployment artifact simplifies the pipeline.

DATABASE_STRATEGY

SQLite for zero-configuration deployment—entire database in a single file. Ideal for single-tenant owner-operated businesses. Pre-planned PostgreSQL migration path via Prisma for multi-user scaling. One-line schema change.

SECTION_03

RELATIONAL DATA MODEL

A well-defined, interconnected schema that mirrors real-world construction business processes. Strict relational constraints ensure data consistency from lead capture through final reconciliation.

CLIENT

Central entity for customer information. Root for all projects, estimates, and invoices.

HAS_MANY: Project, Estimate, Invoice
ESTIMATE

Quote or proposal for potential jobs. Converts to Project and Invoice upon acceptance.

BELONGS_TO: Client
PROJECT

Core operational entity. Tracks job from inception to completion. Hub for all cost data.

HAS_MANY: Invoice, Bill, TimeEntry, DailyLog
INVOICE

Accounts receivable. Status workflow: DRAFT → SENT → PAID → OVERDUE.

BELONGS_TO: Project, Client
BILL

Accounts payable (expenses). Links to Vendor. Optional Project allocation for job costing.

BELONGS_TO: Vendor, Project?
TIME_ENTRY

Labor hours by CrewMember against Project. Auto-calculates cost from pay rates.

BELONGS_TO: CrewMember, Project
DATA_LIFECYCLE_EXAMPLE

1. Client "John Smith" created in CRM

2. Estimate "40x60 Post-Frame Shop" linked to Client

3. Client accepts → Estimate converts to Project + Invoice

4. Bills entered: "Atlantic Lumber" → $14,500 lumber package

5. TimeEntry: Ryan Miller logs 8hrs @ $35/hr = $280 labor cost

6. Job Costing aggregates: Labor + Materials = Real-time P&L

SECTION_04

DATA INTEGRITY & AUDITING

Multiple safeguards at both database and application layers ensure data integrity, prevent accidental data loss, and maintain a complete audit trail for compliance.

REFERENTIAL_LOCKS

ON DELETE RESTRICT

Prevents accidental deletion of critical entities with financial dependencies. A Client with active invoice history cannot be deleted. Preserves accounting integrity.

BLOCKED: DELETE Client WHERE invoices.length > 0
CASCADE_DELETION

Controlled Cleanup

Used sparingly for tightly-coupled, non-critical entities where automatic cleanup is safe. Restrictive policies favored for most relationships.

CASCADE: DailyLog entries when Project deleted
OPTIMISTIC_ROLLBACK

UI State Protection

Optimistic updates serve dual purpose: instant UX response AND data integrity. If backend API fails, UI auto-reverts to prevent users acting on inconsistent data.

FLOW: UI updates → API call → Success OR Rollback
ACTIVITY_LOG

Immutable Audit Trail

Comprehensive logging of all significant actions: creation, update, deletion, status changes. Timestamped with user attribution. Essential for compliance.

RECORD: action, entityType, entityId, userId, timestamp
SECTION_05

SECURITY MODEL

Defense-in-depth strategy with multiple layers of protection. Cookie-based sessions, JWT verification, CSRF protection, and security headers hardened against common vulnerabilities.

SESSION_LAYER

Cookie-Based Sessions

  • →Secure, HTTP-only cookie tokens
  • →XSS attack mitigation
  • →jose library for JWT verification
  • →Environment variable secret management
MIDDLEWARE_LAYER

Route Protection

  • →Token verification on /admin and /api/admin
  • →CSRF check via x-csrf-token header
  • →Invalid token → 401 or login redirect
  • →Centralized gatekeeper pattern
HEADERS_LAYER

Security Headers

  • →X-Frame-Options: DENY
  • →X-Content-Type-Options: nosniff
  • →Referrer-Policy: strict-origin
  • →CSP: upgrade-insecure-requests
SECTION_06

3D BUILDING CONFIGURATOR

A WebGL-powered interactive designer built on React Three Fiber. Real-time 3D rendering in the browser, enabling potential clients to visualize and configure their post-frame building before requesting a quote.

3D_STACK
RENDERERREACT THREE FIBER
HELPERSDREI
ENGINETHREE.JS
TARGETWebGL 2.0
CONFIGURATION_OPTIONS
DIMENSIONSWidth × Length × Height
ROOF_STYLEGable, Gambrel, Mono-slope
COLORSSiding, Roofing, Trim
OPENINGSDoors, Windows, Overheads
BUSINESS_VALUE
Lead Qualification

Captures highly qualified leads with specific requirements. Direct CRM integration.

Competitive Edge

Differentiates from competitors using static forms. Modern, engaging sales tool.

Accurate Quoting

Configuration data feeds directly into estimate generation. Precise proposals.

SECTION_07

MODULAR ARCHITECTURE

16 integrated modules organized into three user-facing portals and a comprehensive administrative backend. Clean separation of concerns with seamless data flow between components.

PUBLIC_WEBSITE

/

  • • Dynamic homepage
  • • Product catalog with specs
  • • SEO-optimized service pages
  • • 3D Building Designer (lead capture)
CLIENT_PORTAL

/portal

  • • Project status & progress logs
  • • Invoice history & PDF downloads
  • • Estimate Accept/Decline workflow
  • • Token-based access (no password)
CREW_PORTAL

/crew

  • • Work schedule viewing
  • • Job assignment details
  • • Timesheet submission & status
  • • Mobile-optimized interface
ADMIN_CONTROL_PANEL
COMMAND_DASH
CRM
PROJECT_MGT
ESTIMATES
INVOICING
BILLS_AP
CREW_MGT
TIMESHEETS
JOB_COSTING
REPORTS
CALENDAR
NOTIFICATIONS
GALLERY
CATALOG
SETTINGS
ACTIVITY_LOG
PRODUCTION_READY

THE UNIFIED COMMAND CENTER
FOR CONSTRUCTION.

Solari Construction ERP is production-ready. Replace your fragmented software stack with a single, self-hosted platform. Zero monthly fees. Total operational control.

REQUEST DEMO← BACK TO OVERVIEW
← RETURN_TO_OVERVIEW
SOLARI_ARCH_V1.0.0 | CLASSIFICATION: PUBLIC | STATUS: PRODUCTION