Initial commit: ArchiTools modular dashboard platform

Complete Next.js 16 application with 13 fully implemented modules:
Email Signature, Word XML Generator, Registratura, Dashboard,
Tag Manager, IT Inventory, Address Book, Password Vault,
Mini Utilities, Prompt Generator, Digital Signatures,
Word Templates, and AI Chat.

Includes core platform systems (module registry, feature flags,
storage abstraction, i18n, theming, auth stub, tagging),
16 technical documentation files, Docker deployment config,
and legacy HTML tool reference.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

src/core/auth/auth-provider.tsx

@@ -0,0 +1,67 @@
+'use client';
+
+import { createContext, useContext, useMemo, useCallback } from 'react';
+import type { AuthContextValue, User, Role } from './types';
+
+const ROLE_HIERARCHY: Record<Role, number> = {
+  admin: 4,
+  manager: 3,
+  user: 2,
+  viewer: 1,
+  guest: 0,
+};
+
+const AuthContext = createContext<AuthContextValue | null>(null);
+
+// Stub user for development (no auth required)
+const STUB_USER: User = {
+  id: 'dev-user',
+  name: 'Utilizator Intern',
+  email: 'dev@architools.local',
+  role: 'admin',
+  company: 'beletage',
+};
+
+interface AuthProviderProps {
+  children: React.ReactNode;
+}
+
+export function AuthProvider({ children }: AuthProviderProps) {
+  // In the current phase, always return the stub user
+  // Future: replace with Authentik OIDC token resolution
+  const user = STUB_USER;
+
+  const hasRole = useCallback(
+    (requiredRole: Role) => {
+      return ROLE_HIERARCHY[user.role] >= ROLE_HIERARCHY[requiredRole];
+    },
+    [user.role]
+  );
+
+  const canAccessModule = useCallback(
+    (_moduleId: string) => {
+      // Future: check module-level permissions
+      return true;
+    },
+    []
+  );
+
+  const value: AuthContextValue = useMemo(
+    () => ({
+      user,
+      role: user.role,
+      isAuthenticated: true,
+      hasRole,
+      canAccessModule,
+    }),
+    [user, hasRole, canAccessModule]
+  );
+
+  return <AuthContext.Provider value={value}>{children}</AuthContext.Provider>;
+}
+
+export function useAuth(): AuthContextValue {
+  const ctx = useContext(AuthContext);
+  if (!ctx) throw new Error('useAuth must be used within AuthProvider');
+  return ctx;
+}

src/core/auth/index.ts

@@ -0,0 +1,2 @@
+export type { User, Role, CompanyId, AuthContextValue } from './types';
+export { AuthProvider, useAuth } from './auth-provider';

src/core/auth/types.ts

@@ -0,0 +1,19 @@
+export type Role = 'admin' | 'manager' | 'user' | 'viewer' | 'guest';
+
+export type CompanyId = 'beletage' | 'urban-switch' | 'studii-de-teren' | 'group';
+
+export interface User {
+  id: string;
+  name: string;
+  email: string;
+  role: Role;
+  company: CompanyId;
+}
+
+export interface AuthContextValue {
+  user: User | null;
+  role: Role;
+  isAuthenticated: boolean;
+  hasRole: (role: Role) => boolean;
+  canAccessModule: (moduleId: string) => boolean;
+}