History

rckrdmrd ea1879f4ad feat: Initial workspace structure with multi-level Git configuration - Configure workspace Git repository with comprehensive .gitignore - Add Odoo as submodule for ERP reference code - Include documentation: SETUP.md, GIT-STRUCTURE.md - Add gitignore templates for projects (backend, frontend, database) - Structure supports independent repos per project/subproject level Workspace includes: - core/ - Reusable patterns, modules, orchestration system - projects/ - Active projects (erp-suite, gamilit, trading-platform, etc.) - knowledge-base/ - Reference code and patterns (includes Odoo submodule) - devtools/ - Development tools and templates - customers/ - Client implementations template 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>		2025-12-08 10:44:23 -06:00
..
src	feat: Initial workspace structure with multi-level Git configuration	2025-12-08 10:44:23 -06:00
index.html	feat: Initial workspace structure with multi-level Git configuration	2025-12-08 10:44:23 -06:00
package.json	feat: Initial workspace structure with multi-level Git configuration	2025-12-08 10:44:23 -06:00
README.md	feat: Initial workspace structure with multi-level Git configuration	2025-12-08 10:44:23 -06:00
tsconfig.json	feat: Initial workspace structure with multi-level Git configuration	2025-12-08 10:44:23 -06:00
vite.config.ts	feat: Initial workspace structure with multi-level Git configuration	2025-12-08 10:44:23 -06:00

README.md

Frontend Web - MVP Sistema Administración de Obra

Stack: React 18 + Vite + TypeScript + Zustand Versión: 1.0.0 Fecha: 2025-11-20

📋 DESCRIPCIÓN

Aplicación web del sistema de administración de obra e INFONAVIT.

Portales incluidos:

Admin: Portal administrativo completo
Supervisor: Portal para supervisores de obra
Obra: Portal para personal en sitio

🚀 SETUP INICIAL

# Instalar dependencias
npm install

# Iniciar servidor de desarrollo
npm run dev

# Build para producción
npm run build

La aplicación estará disponible en http://localhost:5173

🏗️ ESTRUCTURA

src/
├── shared/                    # Código compartido entre portales
│   ├── components/
│   │   ├── ui/               # Componentes UI base (Button, Input, etc.)
│   │   └── layout/           # Componentes de layout (Header, Sidebar, etc.)
│   ├── hooks/                # Custom hooks
│   ├── stores/               # Zustand stores
│   ├── services/             # API services
│   ├── types/                # TypeScript types
│   ├── utils/                # Utilities
│   └── constants/            # Constantes
└── apps/                     # Portales específicos
    ├── admin/                # Portal administrador
    │   ├── pages/
    │   ├── components/
    │   └── routes.tsx
    ├── supervisor/           # Portal supervisor
    └── obra/                 # Portal obra

📝 SCRIPTS

Script	Descripción
`npm run dev`	Inicia servidor de desarrollo (port 5173)
`npm run build`	Build para producción
`npm run preview`	Preview del build de producción
`npm run lint`	Ejecuta ESLint
`npm run lint:fix`	Ejecuta ESLint y corrige
`npm run type-check`	Verifica tipos TypeScript

🎨 CONVENCIONES

Nomenclatura

Seguir ESTANDARES-NOMENCLATURA.md:

Componentes: PascalCase.tsx
Páginas: PascalCasePage.tsx
Hooks: useCamelCase.ts
Stores: camelCase.store.ts
Tipos: camelCase.types.ts

Path Aliases

import { Button } from '@components/ui/Button';
import { useAuth } from '@hooks/useAuth';
import { projectStore } from '@stores/project.store';
import type { Project } from '@types/project.types';

📚 REFERENCIAS

Mantenido por: Frontend-Agent Última actualización: 2025-11-20