frontend-hamroun 1.1.85 → 1.1.86

package/README.md

@@ -1,11 +1,16 @@
-# Your Package Name
+# Frontend Hamroun
 
-A lightweight Virtual DOM and hooks implementation with JSX support.
+A lightweight JavaScript framework with Virtual DOM and hooks implementation inspired by modern frameworks.
+
+![npm](https://img.shields.io/npm/v/frontend-hamroun)
+![npm bundle size](https://img.shields.io/bundlephobia/minzip/frontend-hamroun)
+![npm](https://img.shields.io/npm/dt/frontend-hamroun)
+![GitHub license](https://img.shields.io/badge/license-MIT-blue.svg)
 
 ## Installation
 
 ```bash
-npm install your-package-name
+npm install frontend-hamroun
 ```
 
 ## Quick Start
@@ -28,7 +33,7 @@ npm run dev
 ## Usage
 
 ```jsx
-import { render, useState } from 'your-package-name';
+import { render, useState } from 'frontend-hamroun';
 
 function App() {
   const [count, setCount] = useState(0);
@@ -45,11 +50,15 @@ render(<App />, document.getElementById('root'));
 
 ## Features
 
-- Virtual DOM with efficient diffing
-- Hooks (useState, useEffect, useMemo, useRef)
+- Lightweight (<5KB gzipped)
+- Virtual DOM with efficient diffing algorithm
+- Hooks API (useState, useEffect, useMemo, useRef)
 - Context API
-- Batch updates
-- Hydration support
+- Server-Side Rendering
+- Error Boundaries
+- JSX support
+- TypeScript support
+- Built-in CLI for project scaffolding
 
 ## Hooks
 
@@ -57,7 +66,9 @@ render(<App />, document.getElementById('root'));
 Manages component state.
 
 ```tsx
-const [state, setState] = useState(initialValue);
+const [count, setCount] = useState(0);
+setCount(count + 1); // Direct value
+setCount(prev => prev + 1); // Using callback
 ```
 
 ### useEffect
@@ -65,25 +76,31 @@ Handles side effects in components.
 
 ```tsx
 useEffect(() => {
-  // Effect code
+  document.title = `Count: ${count}`;
+  
   return () => {
-    // Cleanup code
+    // Cleanup code runs before next effect or unmount
+    console.log('Cleanup effect');
   };
-}, [dependencies]);
+}, [count]); // Only re-run when count changes
 ```
 
 ### useMemo
 Memoizes expensive computations.
 
 ```tsx
-const memoizedValue = useMemo(() => computeExpensiveValue(a, b), [a, b]);
+const doubled = useMemo(() => {
+  console.log('Computing doubled value');
+  return count * 2;
+}, [count]);
 ```
 
 ### useRef
-Creates a mutable reference.
+Creates a mutable reference that persists across renders.
 
 ```tsx
-const ref = useRef(initialValue);
+const renderCount = useRef(0);
+renderCount.current += 1; // Update without triggering re-render
 ```
 
 ### useErrorBoundary
@@ -91,150 +108,104 @@ Handles component errors.
 
 ```tsx
 const [error, resetError] = useErrorBoundary();
+
+if (error) {
+  return (
+    <div>
+      <h1>Something went wrong!</h1>
+      <button onClick={resetError}>Try again</button>
+    </div>
+  );
+}
 ```
 
 ## Context API
 
-Create and use shared state across components.
+Share state across components without prop drilling.
 
 ```tsx
+// Create context
 const ThemeContext = createContext('light');
 
+// Provider component
 function App() {
+  const [theme, setTheme] = useState('light');
+  
   return (
-    <ThemeContext.Provider value="dark">
-      <Child />
+    <ThemeContext.Provider value={theme}>
+      <Button onClick={() => setTheme(theme === 'light' ? 'dark' : 'light')}>
+        Toggle Theme
+      </Button>
+      <ThemedComponent />
     </ThemeContext.Provider>
   );
 }
 
-function Child() {
+// Consumer component
+function ThemedComponent() {
   const theme = useContext(ThemeContext);
-  // Or use selector for performance
-  const isDark = ThemeContext.useSelector(theme => theme === 'dark');
+  return <div style={{ background: theme === 'dark' ? '#333' : '#fff' }}>
+    Current theme: {theme}
+  </div>;
 }
 ```
 
-## Performance Optimization
-
-### Batch Updates
-Group multiple state updates together.
-
-```tsx
-import { batchUpdates } from 'your-package-name';
-
-batchUpdates(() => {
-  setValue1(newValue1);
-  setValue2(newValue2);
-});
-```
-
-### Component Memoization
-Prevent unnecessary re-renders.
-
-```tsx
-const MemoizedComponent = useMemo(() => (
-  <ExpensiveComponent prop={value} />
-), [value]);
-```
-
 ## Server-Side Rendering
 
+Frontend Hamroun supports server-side rendering with hydration:
+
 ```tsx
-import { hydrate } from 'your-package-name';
+// Server-side
+import { renderToString } from 'frontend-hamroun';
+
+const html = await renderToString(<App />);
+res.send(`
+  <!DOCTYPE html>
+  <html>
+    <head><title>My App</title></head>
+    <body>
+      <div id="root">${html}</div>
+      <script src="/client.js"></script>
+    </body>
+  </html>
+`);
+
+// Client-side
+import { hydrate } from 'frontend-hamroun';
 
-// On the client
 hydrate(<App />, document.getElementById('root'));
 ```
 
-## Event Handling
-
-```tsx
-function Button() {
-  return (
-    <button 
-      onClick={(e) => handleClick(e)}
-      onMouseOver={(e) => handleHover(e)}
-    >
-      Click me
-    </button>
-  );
-}
-```
+## Performance Optimization
 
-## Styling
+### Batch Updates
+Group multiple state updates together to prevent unnecessary re-renders.
 
 ```tsx
-function StyledComponent() {
-  return (
-    <div style={{ 
-      color: 'blue',
-      padding: '20px'
-    }}>
-      Styled content
-    </div>
-  );
-}
-```
+import { batchUpdates } from 'frontend-hamroun';
 
-## Error Handling
-
-```tsx
-function ErrorBoundary() {
-  const [error, resetError] = useErrorBoundary();
-
-  if (error) {
-    return (
-      <div>
-        <h1>Something went wrong!</h1>
-        <button onClick={resetError}>Try again</button>
-      </div>
-    );
-  }
-
-  return <ComponentThatMightError />;
-}
+batchUpdates(() => {
+  setCount(count + 1);
+  setName('John');
+  setActive(true);
+});
 ```
 
-## Best Practices
-
-1. Use batch updates for multiple state changes
-2. Implement error boundaries for error handling
-3. Use context selectors for better performance
-4. Memoize expensive computations
-5. Clean up effects when components unmount
-6. Keep components small and focused
-7. Use proper TypeScript types for better development experience
-
-## API Reference
+## Project Templates
 
-### Core
-- `render(element, container)`
-- `hydrate(element, container)`
-- `createElement(vnode)`
+The framework comes with two project templates:
 
-### Hooks
-- `useState<T>(initial: T)`
-- `useEffect(callback, deps?)`
-- `useMemo(factory, deps)`
-- `useRef(initial)`
-- `useErrorBoundary()`
+1. **Basic App**: Client-side rendered application with TailwindCSS
+2. **SSR Template**: Server-side rendered application with Express
 
-### Context
-- `createContext(defaultValue)`
-- `useContext(Context)`
-- `Context.Provider`
-- `Context.Consumer`
-- `Context.useSelector`
+## Browser Compatibility
 
-### Performance
-- `batchUpdates(callback)`
+Frontend Hamroun works in all modern browsers (Chrome, Firefox, Safari, Edge).
 
 ## License
 
-MIT License - feel free to use in any project.
+MIT © Hamroun
 
 ## Contributing
 
-Contributions are welcome! Please read our contributing guidelines and submit pull requests.
-`````
+Contributions are welcome! Please feel free to submit a Pull Request.

package/bin/cli.js

@@ -11,11 +11,133 @@ import { createSpinner } from 'nanospinner';
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
 
+// Component templates
+const FUNCTION_COMPONENT_TEMPLATE = (name) => `import { useState, useEffect } from 'frontend-hamroun';
+
+export function ${name}(props) {
+  // State hooks
+  const [state, setState] = useState(null);
+
+  // Effect hooks
+  useEffect(() => {
+    // Component mounted
+    return () => {
+      // Component will unmount
+    };
+  }, []);
+
+  return (
+    <div className="${name.toLowerCase()}">
+      <h2>${name} Component</h2>
+      {/* Your JSX here */}
+    </div>
+  );
+}
+`;
+
+const CSS_TEMPLATE = (name) => `.${name.toLowerCase()} {
+  display: flex;
+  flex-direction: column;
+  padding: 1rem;
+  margin: 0.5rem;
+  border-radius: 4px;
+  box-shadow: 0 2px 4px rgba(0, 0, 0, 0.1);
+}
+`;
+
+const TEST_TEMPLATE = (name) => `import { render, screen } from '@testing-library/frontend-hamroun';
+import { ${name} } from './${name}';
+
+describe('${name} Component', () => {
+  test('renders correctly', () => {
+    render(<${name} />);
+    const element = screen.getByText('${name} Component');
+    expect(element).toBeInTheDocument();
+  });
+});
+`;
+
+// Dockerfile templates
+const DOCKERFILE_TEMPLATE = `# Stage 1: Build the application
+FROM node:18-alpine as build
+
+# Set working directory
+WORKDIR /app
+
+# Copy package files
+COPY package.json package-lock.json ./
+
+# Install dependencies
+RUN npm ci
+
+# Copy source files
+COPY . .
+
+# Build the application
+RUN npm run build
+
+# Stage 2: Serve the application
+FROM nginx:alpine
+
+# Copy the build output from the previous stage
+COPY --from=build /app/dist /usr/share/nginx/html
+
+# Expose port 80
+EXPOSE 80
+
+# Start nginx
+CMD ["nginx", "-g", "daemon off;"]
+`;
+
+const SSR_DOCKERFILE_TEMPLATE = `# Stage 1: Build the application
+FROM node:18-alpine as build
+
+# Set working directory
+WORKDIR /app
+
+# Copy package files
+COPY package.json package-lock.json ./
+
+# Install dependencies
+RUN npm ci
+
+# Copy source files
+COPY . .
+
+# Build the application
+RUN npm run build
+
+# Stage 2: Run the server
+FROM node:18-alpine
+
+WORKDIR /app
+
+# Copy package files and install production dependencies only
+COPY package.json package-lock.json ./
+RUN npm ci --production
+
+# Copy build artifacts
+COPY --from=build /app/dist ./dist
+COPY --from=build /app/server ./server
+
+# Expose port 3000
+EXPOSE 3000
+
+# Start the server
+CMD ["node", "server/index.js"]
+`;
+
 async function init() {
   const program = new Command();
 
   program
-    .name('create-frontend-app')
+    .name('frontend-hamroun')
+    .description('CLI for Frontend Hamroun framework')
+    .version('1.0.0');
+
+  // Create new project
+  program
+    .command('create')
     .description('Create a new Frontend Hamroun application')
     .argument('[name]', 'Project name')
     .action(async (name) => {
@@ -23,7 +145,75 @@ async function init() {
       await createProject(projectName);
     });
 
-  program.parse();
+  // Generate component
+  program
+    .command('generate')
+    .alias('g')
+    .description('Generate a new component')
+    .argument('<name>', 'Component name')
+    .option('-d, --directory <directory>', 'Target directory', './src/components')
+    .action(async (name, options) => {
+      await generateComponent(name, options.directory);
+    });
+
+  // Add Dockerfile
+  program
+    .command('docker')
+    .description('Add Dockerfile to project')
+    .option('-s, --ssr', 'Use SSR-compatible Dockerfile')
+    .action(async (options) => {
+      await addDockerfile(options.ssr);
+    });
+
+  // Interactive mode if no command provided
+  if (process.argv.length <= 2) {
+    await interactiveMode();
+  } else {
+    program.parse();
+  }
+}
+
+async function interactiveMode() {
+  const { action } = await inquirer.prompt([{
+    type: 'list',
+    name: 'action',
+    message: 'What would you like to do?',
+    choices: [
+      { name: 'Create a new project', value: 'create' },
+      { name: 'Generate a component', value: 'generate' },
+      { name: 'Add Dockerfile to project', value: 'docker' }
+    ]
+  }]);
+
+  if (action === 'create') {
+    const projectName = await askProjectName();
+    await createProject(projectName);
+  } else if (action === 'generate') {
+    const { name } = await inquirer.prompt([{
+      type: 'input',
+      name: 'name',
+      message: 'Component name:',
+      validate: (input) => input ? true : 'Component name is required'
+    }]);
+    
+    const { directory } = await inquirer.prompt([{
+      type: 'input',
+      name: 'directory',
+      message: 'Target directory:',
+      default: './src/components'
+    }]);
+    
+    await generateComponent(name, directory);
+  } else if (action === 'docker') {
+    const { isSSR } = await inquirer.prompt([{
+      type: 'confirm',
+      name: 'isSSR',
+      message: 'Is this a server-side rendered app?',
+      default: false
+    }]);
+    
+    await addDockerfile(isSSR);
+  }
 }
 
 async function askProjectName() {
@@ -69,13 +259,21 @@ async function createProject(projectName) {
     pkg.name = projectName;
     await fs.writeJson(pkgPath, pkg, { spaces: 2 });
 
-    spinner.success({ text: `Project ${chalk.green(projectName)} created successfully!` });
+    // Automatically add Dockerfile
+    const isSSR = template === 'ssr-template';
+    const dockerContent = isSSR ? SSR_DOCKERFILE_TEMPLATE : DOCKERFILE_TEMPLATE;
+    await fs.writeFile(path.join(targetDir, 'Dockerfile'), dockerContent);
+
+    spinner.success({ text: `Project ${chalk.green(projectName)} created successfully with Dockerfile!` });
 
     // Show next steps
     console.log('\nNext steps:');
     console.log(chalk.cyan(`  cd ${projectName}`));
     console.log(chalk.cyan('  npm install'));
     console.log(chalk.cyan('  npm run dev'));
+    console.log(chalk.yellow('\nTo build Docker image:'));
+    console.log(chalk.cyan('  docker build -t my-app .'));
+    console.log(chalk.cyan('  docker run -p 3000:' + (isSSR ? '3000' : '80') + ' my-app'));
 
   } catch (error) {
     spinner.error({ text: 'Failed to create project' });
@@ -84,4 +282,90 @@ async function createProject(projectName) {
   }
 }
 
+async function generateComponent(name, directory) {
+  const spinner = createSpinner(`Generating ${name} component...`).start();
+
+  try {
+    const targetDir = path.join(process.cwd(), directory, name);
+    
+    // Create component directory
+    await fs.ensureDir(targetDir);
+    
+    // Create component files
+    await fs.writeFile(
+      path.join(targetDir, `${name}.jsx`),
+      FUNCTION_COMPONENT_TEMPLATE(name)
+    );
+    
+    await fs.writeFile(
+      path.join(targetDir, `${name}.css`),
+      CSS_TEMPLATE(name)
+    );
+    
+    await fs.writeFile(
+      path.join(targetDir, `${name}.test.jsx`),
+      TEST_TEMPLATE(name)
+    );
+    
+    await fs.writeFile(
+      path.join(targetDir, 'index.js'),
+      `export { ${name} } from './${name}';\n`
+    );
+    
+    spinner.success({ text: `Component ${chalk.green(name)} generated successfully!` });
+    
+    console.log('\nFiles created:');
+    console.log(chalk.cyan(`  ${path.join(directory, name, `${name}.jsx`)}`));
+    console.log(chalk.cyan(`  ${path.join(directory, name, `${name}.css`)}`));
+    console.log(chalk.cyan(`  ${path.join(directory, name, `${name}.test.jsx`)}`));
+    console.log(chalk.cyan(`  ${path.join(directory, name, 'index.js')}`));
+    
+  } catch (error) {
+    spinner.error({ text: 'Failed to generate component' });
+    console.error(chalk.red(error));
+    process.exit(1);
+  }
+}
+
+async function addDockerfile(isSSR) {
+  const spinner = createSpinner('Adding Dockerfile...').start();
+  
+  try {
+    const dockerContent = isSSR ? SSR_DOCKERFILE_TEMPLATE : DOCKERFILE_TEMPLATE;
+    const targetPath = path.join(process.cwd(), 'Dockerfile');
+    
+    // Check if Dockerfile already exists
+    if (await fs.pathExists(targetPath)) {
+      spinner.stop();
+      const { overwrite } = await inquirer.prompt([{
+        type: 'confirm',
+        name: 'overwrite',
+        message: 'Dockerfile already exists. Overwrite?',
+        default: false
+      }]);
+      
+      if (!overwrite) {
+        console.log(chalk.yellow('Operation cancelled.'));
+        return;
+      }
+      
+      spinner.start();
+    }
+    
+    // Write Dockerfile
+    await fs.writeFile(targetPath, dockerContent);
+    
+    spinner.success({ text: 'Dockerfile added successfully!' });
+    
+    console.log('\nTo build and run Docker image:');
+    console.log(chalk.cyan('  docker build -t my-app .'));
+    console.log(chalk.cyan('  docker run -p 3000:' + (isSSR ? '3000' : '80') + ' my-app'));
+    
+  } catch (error) {
+    spinner.error({ text: 'Failed to add Dockerfile' });
+    console.error(chalk.red(error));
+    process.exit(1);
+  }
+}
+
 init().catch(console.error);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "frontend-hamroun",
-  "version": "1.1.85",
+  "version": "1.1.86",
   "description": "A lightweight frontend framework with hooks and virtual DOM",
   "type": "module",
   "main": "./dist/index.js",

package/templates/basic-app/docs/rapport_pfe.aux

@@ -0,0 +1,27 @@
+\relax 
+\providecommand\babel@aux[2]{}
+\@nameuse{bbl@beforestart}
+\catcode `:\active 
+\catcode `;\active 
+\catcode `!\active 
+\catcode `?\active 
+\providecommand\hyper@newdestlabel[2]{}
+\providecommand\HyField@AuxAddToFields[1]{}
+\providecommand\HyField@AuxAddToCoFields[2]{}
+\babel@aux{french}{}
+\@writefile{toc}{\contentsline {chapter}{\numberline {1}ÉTUDE PREALABLE}{2}{chapter.1}\protected@file@percent }
+\@writefile{lof}{\addvspace {10\p@ }}
+\@writefile{lot}{\addvspace {10\p@ }}
+\@writefile{toc}{\contentsline {section}{\numberline {1.1}Introduction}{2}{section.1.1}\protected@file@percent }
+\@writefile{toc}{\contentsline {section}{\numberline {1.2}Organisme d'accueil}{2}{section.1.2}\protected@file@percent }
+\@writefile{toc}{\contentsline {section}{\numberline {1.3}Étude et critique de l'existant}{2}{section.1.3}\protected@file@percent }
+\@writefile{toc}{\contentsline {subsection}{\numberline {1.3.1}Critique de l'existant}{2}{subsection.1.3.1}\protected@file@percent }
+\@writefile{toc}{\contentsline {subsection}{\numberline {1.3.2}Solution proposée}{2}{subsection.1.3.2}\protected@file@percent }
+\@writefile{toc}{\contentsline {section}{\numberline {1.4}Choix méthodologique}{3}{section.1.4}\protected@file@percent }
+\@writefile{toc}{\contentsline {subsection}{\numberline {1.4.1}Formalisme de modélisation}{3}{subsection.1.4.1}\protected@file@percent }
+\@writefile{toc}{\contentsline {subsection}{\numberline {1.4.2}Méthodologie}{3}{subsection.1.4.2}\protected@file@percent }
+\@writefile{toc}{\contentsline {subsubsection}{Présentation de la méthode SCRUM}{3}{section*.2}\protected@file@percent }
+\@writefile{toc}{\contentsline {subsubsection}{La répartition des rôles dans la méthode SCRUM}{3}{section*.3}\protected@file@percent }
+\@writefile{toc}{\contentsline {subsubsection}{Le processus de SCRUM}{3}{section*.4}\protected@file@percent }
+\@writefile{toc}{\contentsline {section}{\numberline {1.5}Conclusion}{3}{section.1.5}\protected@file@percent }
+\gdef \@abspage@last{4}

package/templates/basic-app/docs/rapport_pfe.log

@@ -0,0 +1,399 @@
+This is pdfTeX, Version 3.141592653-2.6-1.40.25 (MiKTeX 24.1) (preloaded format=pdflatex 2025.4.3)  11 APR 2025 21:21
+entering extended mode
+ restricted \write18 enabled.
+ %&-line parsing enabled.
+**./rapport_pfe.tex
+(rapport_pfe.tex
+LaTeX2e <2023-11-01> patch level 1
+L3 programming layer <2024-01-04>
+(C:\Program Files\MiKTeX\tex/latex/base\report.cls
+Document Class: report 2023/05/17 v1.4n Standard LaTeX document class
+(C:\Program Files\MiKTeX\tex/latex/base\size12.clo
+File: size12.clo 2023/05/17 v1.4n Standard LaTeX file (size option)
+)
+\c@part=\count187
+\c@chapter=\count188
+\c@section=\count189
+\c@subsection=\count190
+\c@subsubsection=\count191
+\c@paragraph=\count192
+\c@subparagraph=\count193
+\c@figure=\count194
+\c@table=\count195
+\abovecaptionskip=\skip48
+\belowcaptionskip=\skip49
+\bibindent=\dimen140
+)
+(C:\Program Files\MiKTeX\tex/latex/base\inputenc.sty
+Package: inputenc 2021/02/14 v1.3d Input encoding file
+\inpenc@prehook=\toks17
+\inpenc@posthook=\toks18
+)
+(C:\Program Files\MiKTeX\tex/generic/babel\babel.sty
+Package: babel 2024/01/07 v24.1 The Babel package
+\babel@savecnt=\count196
+\U@D=\dimen141
+\l@unhyphenated=\language79
+
+(C:\Program Files\MiKTeX\tex/generic/babel\txtbabel.def)
+\bbl@readstream=\read2
+\bbl@dirlevel=\count197
+
+*************************************
+* Local config file bblopts.cfg used
+*
+(C:\Program Files\MiKTeX\tex/latex/arabi\bblopts.cfg
+File: bblopts.cfg 2005/09/08 v0.1 add Arabic and Farsi to "declared" options of
+ babel
+)
+(C:\Program Files\MiKTeX\tex/generic/babel-french\french.ldf
+Language: french 2024-07-25 v3.6c French support from the babel system
+Package babel Info: Hyphen rules for 'acadian' set to \l@french
+(babel)             (\language22). Reported on input line 91.
+Package babel Info: Hyphen rules for 'canadien' set to \l@french
+(babel)             (\language22). Reported on input line 92.
+\FB@stdchar=\count198
+Package babel Info: Making : an active character on input line 421.
+Package babel Info: Making ; an active character on input line 422.
+Package babel Info: Making ! an active character on input line 423.
+Package babel Info: Making ? an active character on input line 424.
+\FBguill@level=\count199
+\FBold@everypar=\toks19
+\FB@Mht=\dimen142
+\mc@charclass=\count266
+\mc@charfam=\count267
+\mc@charslot=\count268
+\std@mcc=\count269
+\dec@mcc=\count270
+\FB@parskip=\dimen143
+\listindentFB=\dimen144
+\descindentFB=\dimen145
+\labelindentFB=\dimen146
+\labelwidthFB=\dimen147
+\leftmarginFB=\dimen148
+\parindentFFN=\dimen149
+\FBfnindent=\dimen150
+))
+(C:\Program Files\MiKTeX\tex/generic/babel/locale/fr\babel-french.tex
+Package babel Info: Importing font and identification data for french
+(babel)             from babel-fr.ini. Reported on input line 11.
+)
+(C:\Program Files\MiKTeX\tex/latex/carlisle\scalefnt.sty)
+(C:\Program Files\MiKTeX\tex/latex/graphics\graphicx.sty
+Package: graphicx 2021/09/16 v1.2d Enhanced LaTeX Graphics (DPC,SPQR)
+
+(C:\Program Files\MiKTeX\tex/latex/graphics\keyval.sty
+Package: keyval 2022/05/29 v1.15 key=value parser (DPC)
+\KV@toks@=\toks20
+)
+(C:\Program Files\MiKTeX\tex/latex/graphics\graphics.sty
+Package: graphics 2022/03/10 v1.4e Standard LaTeX Graphics (DPC,SPQR)
+
+(C:\Program Files\MiKTeX\tex/latex/graphics\trig.sty
+Package: trig 2021/08/11 v1.11 sin cos tan (DPC)
+)
+(C:\Program Files\MiKTeX\tex/latex/graphics-cfg\graphics.cfg
+File: graphics.cfg 2016/06/04 v1.11 sample graphics configuration
+)
+Package graphics Info: Driver file: pdftex.def on input line 107.
+
+(C:\Program Files\MiKTeX\tex/latex/graphics-def\pdftex.def
+File: pdftex.def 2022/09/22 v1.2b Graphics/color driver for pdftex
+))
+\Gin@req@height=\dimen151
+\Gin@req@width=\dimen152
+)
+(C:\Program Files\MiKTeX\tex/latex/fancyhdr\fancyhdr.sty
+Package: fancyhdr 2025/02/07 v5.2 Extensive control of page headers and footers
+
+\f@nch@headwidth=\skip50
+\f@nch@offset@elh=\skip51
+\f@nch@offset@erh=\skip52
+\f@nch@offset@olh=\skip53
+\f@nch@offset@orh=\skip54
+\f@nch@offset@elf=\skip55
+\f@nch@offset@erf=\skip56
+\f@nch@offset@olf=\skip57
+\f@nch@offset@orf=\skip58
+\f@nch@height=\skip59
+\f@nch@footalignment=\skip60
+\f@nch@widthL=\skip61
+\f@nch@widthC=\skip62
+\f@nch@widthR=\skip63
+\@temptokenb=\toks21
+)
+(C:\Program Files\MiKTeX\tex/latex/hyperref\hyperref.sty
+Package: hyperref 2023-11-26 v7.01g Hypertext links for LaTeX
+
+(C:\Program Files\MiKTeX\tex/generic/iftex\iftex.sty
+Package: iftex 2022/02/03 v1.0f TeX engine tests
+)
+(C:\Program Files\MiKTeX\tex/generic/infwarerr\infwarerr.sty
+Package: infwarerr 2019/12/03 v1.5 Providing info/warning/error messages (HO)
+)
+(C:\Program Files\MiKTeX\tex/latex/kvsetkeys\kvsetkeys.sty
+Package: kvsetkeys 2022-10-05 v1.19 Key value parser (HO)
+)
+(C:\Program Files\MiKTeX\tex/generic/kvdefinekeys\kvdefinekeys.sty
+Package: kvdefinekeys 2019-12-19 v1.6 Define keys (HO)
+)
+(C:\Program Files\MiKTeX\tex/generic/pdfescape\pdfescape.sty
+Package: pdfescape 2019/12/09 v1.15 Implements pdfTeX's escape features (HO)
+
+(C:\Program Files\MiKTeX\tex/generic/ltxcmds\ltxcmds.sty
+Package: ltxcmds 2023-12-04 v1.26 LaTeX kernel commands for general use (HO)
+)
+(C:\Program Files\MiKTeX\tex/generic/pdftexcmds\pdftexcmds.sty
+Package: pdftexcmds 2020-06-27 v0.33 Utility functions of pdfTeX for LuaTeX (HO
+)
+Package pdftexcmds Info: \pdf@primitive is available.
+Package pdftexcmds Info: \pdf@ifprimitive is available.
+Package pdftexcmds Info: \pdfdraftmode found.
+))
+(C:\Program Files\MiKTeX\tex/latex/hycolor\hycolor.sty
+Package: hycolor 2020-01-27 v1.10 Color options for hyperref/bookmark (HO)
+)
+(C:\Program Files\MiKTeX\tex/latex/letltxmacro\letltxmacro.sty
+Package: letltxmacro 2019/12/03 v1.6 Let assignment for LaTeX macros (HO)
+)
+(C:\Program Files\MiKTeX\tex/latex/auxhook\auxhook.sty
+Package: auxhook 2019-12-17 v1.6 Hooks for auxiliary files (HO)
+)
+(C:\Program Files\MiKTeX\tex/latex/hyperref\nameref.sty
+Package: nameref 2023-11-26 v2.56 Cross-referencing by name of section
+
+(C:\Program Files\MiKTeX\tex/latex/refcount\refcount.sty
+Package: refcount 2019/12/15 v3.6 Data extraction from label references (HO)
+)
+(C:\Program Files\MiKTeX\tex/generic/gettitlestring\gettitlestring.sty
+Package: gettitlestring 2019/12/15 v1.6 Cleanup title references (HO)
+
+(C:\Program Files\MiKTeX\tex/latex/kvoptions\kvoptions.sty
+Package: kvoptions 2022-06-15 v3.15 Key value format for package options (HO)
+))
+\c@section@level=\count271
+)
+(C:\Program Files\MiKTeX\tex/latex/etoolbox\etoolbox.sty
+Package: etoolbox 2020/10/05 v2.5k e-TeX tools for LaTeX (JAW)
+\etb@tempcnta=\count272
+)
+\@linkdim=\dimen153
+\Hy@linkcounter=\count273
+\Hy@pagecounter=\count274
+
+(C:\Program Files\MiKTeX\tex/latex/hyperref\pd1enc.def
+File: pd1enc.def 2023-11-26 v7.01g Hyperref: PDFDocEncoding definition (HO)
+Now handling font encoding PD1 ...
+... no UTF-8 mapping file for font encoding PD1
+)
+(C:\Program Files\MiKTeX\tex/generic/intcalc\intcalc.sty
+Package: intcalc 2019/12/15 v1.3 Expandable calculations with integers (HO)
+)
+\Hy@SavedSpaceFactor=\count275
+
+(C:\Program Files\MiKTeX\tex/latex/hyperref\puenc.def
+File: puenc.def 2023-11-26 v7.01g Hyperref: PDF Unicode definition (HO)
+Now handling font encoding PU ...
+... no UTF-8 mapping file for font encoding PU
+)
+Package hyperref Info: Hyper figures OFF on input line 4181.
+Package hyperref Info: Link nesting OFF on input line 4186.
+Package hyperref Info: Hyper index ON on input line 4189.
+Package hyperref Info: Plain pages OFF on input line 4196.
+Package hyperref Info: Backreferencing OFF on input line 4201.
+Package hyperref Info: Implicit mode ON; LaTeX internals redefined.
+Package hyperref Info: Bookmarks ON on input line 4448.
+\c@Hy@tempcnt=\count276
+
+(C:\Program Files\MiKTeX\tex/latex/url\url.sty
+\Urlmuskip=\muskip16
+Package: url 2013/09/16  ver 3.4  Verb mode for urls, etc.
+)
+LaTeX Info: Redefining \url on input line 4786.
+\XeTeXLinkMargin=\dimen154
+
+(C:\Program Files\MiKTeX\tex/generic/bitset\bitset.sty
+Package: bitset 2019/12/09 v1.3 Handle bit-vector datatype (HO)
+
+(C:\Program Files\MiKTeX\tex/generic/bigintcalc\bigintcalc.sty
+Package: bigintcalc 2019/12/15 v1.5 Expandable calculations on big integers (HO
+)
+))
+\Fld@menulength=\count277
+\Field@Width=\dimen155
+\Fld@charsize=\dimen156
+Package hyperref Info: Hyper figures OFF on input line 6065.
+Package hyperref Info: Link nesting OFF on input line 6070.
+Package hyperref Info: Hyper index ON on input line 6073.
+Package hyperref Info: backreferencing OFF on input line 6080.
+Package hyperref Info: Link coloring OFF on input line 6085.
+Package hyperref Info: Link coloring with OCG OFF on input line 6090.
+Package hyperref Info: PDF/A mode OFF on input line 6095.
+
+(C:\Program Files\MiKTeX\tex/latex/base\atbegshi-ltx.sty
+Package: atbegshi-ltx 2021/01/10 v1.0c Emulation of the original atbegshi
+package with kernel methods
+)
+\Hy@abspage=\count278
+\c@Item=\count279
+\c@Hfootnote=\count280
+)
+Package hyperref Info: Driver (autodetected): hpdftex.
+
+(C:\Program Files\MiKTeX\tex/latex/hyperref\hpdftex.def
+File: hpdftex.def 2023-11-26 v7.01g Hyperref driver for pdfTeX
+
+(C:\Program Files\MiKTeX\tex/latex/base\atveryend-ltx.sty
+Package: atveryend-ltx 2020/08/19 v1.0a Emulation of the original atveryend pac
+kage
+with kernel methods
+)
+\Fld@listcount=\count281
+\c@bookmark@seq@number=\count282
+
+(C:\Program Files\MiKTeX\tex/latex/rerunfilecheck\rerunfilecheck.sty
+Package: rerunfilecheck 2022-07-10 v1.10 Rerun checks for auxiliary files (HO)
+
+(C:\Program Files\MiKTeX\tex/generic/uniquecounter\uniquecounter.sty
+Package: uniquecounter 2019/12/15 v1.4 Provide unlimited unique counter (HO)
+)
+Package uniquecounter Info: New unique counter `rerunfilecheck' on input line 2
+85.
+)
+\Hy@SectionHShift=\skip64
+)
+Package hyperref Info: Option `colorlinks' set `true' on input line 13.
+
+(C:\Program Files\MiKTeX\tex/latex/l3backend\l3backend-pdftex.def
+File: l3backend-pdftex.def 2024-01-04 L3 backend support: PDF output (pdfTeX)
+\l__color_backend_stack_int=\count283
+\l__pdf_internal_box=\box51
+)
+(rapport_pfe.aux)
+\openout1 = `rapport_pfe.aux'.
+
+LaTeX Font Info:    Checking defaults for OML/cmm/m/it on input line 25.
+LaTeX Font Info:    ... okay on input line 25.
+LaTeX Font Info:    Checking defaults for OMS/cmsy/m/n on input line 25.
+LaTeX Font Info:    ... okay on input line 25.
+LaTeX Font Info:    Checking defaults for OT1/cmr/m/n on input line 25.
+LaTeX Font Info:    ... okay on input line 25.
+LaTeX Font Info:    Checking defaults for T1/cmr/m/n on input line 25.
+LaTeX Font Info:    ... okay on input line 25.
+LaTeX Font Info:    Checking defaults for TS1/cmr/m/n on input line 25.
+LaTeX Font Info:    ... okay on input line 25.
+LaTeX Font Info:    Checking defaults for OMX/cmex/m/n on input line 25.
+LaTeX Font Info:    ... okay on input line 25.
+LaTeX Font Info:    Checking defaults for U/cmr/m/n on input line 25.
+LaTeX Font Info:    ... okay on input line 25.
+LaTeX Font Info:    Checking defaults for PD1/pdf/m/n on input line 25.
+LaTeX Font Info:    ... okay on input line 25.
+LaTeX Font Info:    Checking defaults for PU/pdf/m/n on input line 25.
+LaTeX Font Info:    ... okay on input line 25.
+LaTeX Info: Redefining \degres on input line 25.
+LaTeX Info: Redefining \up on input line 25.
+
+
+Package french.ldf Warning: OT1 encoding should not be used for French.
+(french.ldf)                Add \usepackage[T1]{fontenc} to the preamble
+(french.ldf)                of your document; reported on input line 25.
+
+(C:\Program Files\MiKTeX\tex/context/base/mkii\supp-pdf.mkii
+[Loading MPS to PDF converter (version 2006.09.02).]
+\scratchcounter=\count284
+\scratchdimen=\dimen157
+\scratchbox=\box52
+\nofMPsegments=\count285
+\nofMParguments=\count286
+\everyMPshowfont=\toks22
+\MPscratchCnt=\count287
+\MPscratchDim=\dimen158
+\MPnumerator=\count288
+\makeMPintoPDFobject=\count289
+\everyMPtoPDFconversion=\toks23
+) (C:\Program Files\MiKTeX\tex/latex/epstopdf-pkg\epstopdf-base.sty
+Package: epstopdf-base 2020-01-24 v2.11 Base part for package epstopdf
+Package epstopdf-base Info: Redefining graphics rule for `.eps' on input line 4
+85.
+
+(C:\Program Files\MiKTeX\tex/latex/00miktex\epstopdf-sys.cfg
+File: epstopdf-sys.cfg 2021/03/18 v2.0 Configuration of epstopdf for MiKTeX
+))
+(C:\Program Files\MiKTeX\tex/latex/graphics\color.sty
+Package: color 2022/01/06 v1.3d Standard LaTeX Color (DPC)
+
+(C:\Program Files\MiKTeX\tex/latex/graphics-cfg\color.cfg
+File: color.cfg 2016/01/02 v1.6 sample color configuration
+)
+Package color Info: Driver file: pdftex.def on input line 149.
+
+(C:\Program Files\MiKTeX\tex/latex/graphics\mathcolor.ltx))
+Package hyperref Info: Link coloring ON on input line 25.
+ (rapport_pfe.out)
+(rapport_pfe.out)
+\@outlinefile=\write3
+\openout3 = `rapport_pfe.out'.
+
+LaTeX Font Info:    External font `cmex10' loaded for size
+(Font)              <14.4> on input line 28.
+LaTeX Font Info:    External font `cmex10' loaded for size
+(Font)              <7> on input line 28.
+ [1
+
+{C:/Users/hamro/AppData/Local/MiKTeX/fonts/map/pdftex/pdftex.map}] (rapport_pfe
+.toc
+LaTeX Font Info:    External font `cmex10' loaded for size
+(Font)              <12> on input line 3.
+LaTeX Font Info:    External font `cmex10' loaded for size
+(Font)              <8> on input line 3.
+LaTeX Font Info:    External font `cmex10' loaded for size
+(Font)              <6> on input line 3.
+)
+\tf@toc=\write4
+\openout4 = `rapport_pfe.toc'.
+
+
+pdfTeX warning (ext4): destination with the same identifier (name{page.1}) has 
+been already used, duplicate ignored
+<to be read again> 
+                   \relax 
+l.29 \newpage
+              [1
+
+]
+Chapitre 1.
+[2
+
+]
+
+Package fancyhdr Warning: \headheight is too small (12.0pt): 
+(fancyhdr)                Make it at least 15.71667pt, for example:
+(fancyhdr)                \setlength{\headheight}{15.71667pt}.
+(fancyhdr)                You might also make \topmargin smaller:
+(fancyhdr)                \addtolength{\topmargin}{-3.71667pt}.
+
+[3] (rapport_pfe.aux)
+ ***********
+LaTeX2e <2023-11-01> patch level 1
+L3 programming layer <2024-01-04>
+ ***********
+Package rerunfilecheck Info: File `rapport_pfe.out' has not changed.
+(rerunfilecheck)             Checksum: 3EE8BAE7C5596D6C97ACEA2FBAB7472C;1532.
+ ) 
+Here is how much of TeX's memory you used:
+ 10770 strings out of 474486
+ 174935 string characters out of 5753571
+ 1930542 words of memory out of 5000000
+ 32928 multiletter control sequences out of 15000+600000
+ 563843 words of font info for 55 fonts, out of 8000000 for 9000
+ 1141 hyphenation exceptions out of 8191
+ 75i,12n,79p,274b,475s stack positions out of 10000i,1000n,20000p,200000b,200000s
+<C:/Program Files/MiKTeX/fonts/type1/public/amsfonts/cm/cmbx12.pfb><C:/Progra
+m Files/MiKTeX/fonts/type1/public/amsfonts/cm/cmr12.pfb><C:/Program Files/MiKTe
+X/fonts/type1/public/amsfonts/cm/cmr17.pfb>
+Output written on rapport_pfe.pdf (4 pages, 59939 bytes).
+PDF statistics:
+ 95 PDF objects out of 1000 (max. 8388607)
+ 18 named destinations out of 1000 (max. 500000)
+ 81 words of extra memory for PDF output out of 10000 (max. 10000000)
+

package/templates/basic-app/docs/rapport_pfe.out

@@ -0,0 +1,10 @@
+\BOOKMARK [0][-]{chapter.1}{\376\377\000\311\000T\000U\000D\000E\000\040\000P\000R\000E\000A\000L\000A\000B\000L\000E}{}% 1
+\BOOKMARK [1][-]{section.1.1}{\376\377\000I\000n\000t\000r\000o\000d\000u\000c\000t\000i\000o\000n}{chapter.1}% 2
+\BOOKMARK [1][-]{section.1.2}{\376\377\000O\000r\000g\000a\000n\000i\000s\000m\000e\000\040\000d\000'\000a\000c\000c\000u\000e\000i\000l}{chapter.1}% 3
+\BOOKMARK [1][-]{section.1.3}{\376\377\000\311\000t\000u\000d\000e\000\040\000e\000t\000\040\000c\000r\000i\000t\000i\000q\000u\000e\000\040\000d\000e\000\040\000l\000'\000e\000x\000i\000s\000t\000a\000n\000t}{chapter.1}% 4
+\BOOKMARK [2][-]{subsection.1.3.1}{\376\377\000C\000r\000i\000t\000i\000q\000u\000e\000\040\000d\000e\000\040\000l\000'\000e\000x\000i\000s\000t\000a\000n\000t}{section.1.3}% 5
+\BOOKMARK [2][-]{subsection.1.3.2}{\376\377\000S\000o\000l\000u\000t\000i\000o\000n\000\040\000p\000r\000o\000p\000o\000s\000\351\000e}{section.1.3}% 6
+\BOOKMARK [1][-]{section.1.4}{\376\377\000C\000h\000o\000i\000x\000\040\000m\000\351\000t\000h\000o\000d\000o\000l\000o\000g\000i\000q\000u\000e}{chapter.1}% 7
+\BOOKMARK [2][-]{subsection.1.4.1}{\376\377\000F\000o\000r\000m\000a\000l\000i\000s\000m\000e\000\040\000d\000e\000\040\000m\000o\000d\000\351\000l\000i\000s\000a\000t\000i\000o\000n}{section.1.4}% 8
+\BOOKMARK [2][-]{subsection.1.4.2}{\376\377\000M\000\351\000t\000h\000o\000d\000o\000l\000o\000g\000i\000e}{section.1.4}% 9
+\BOOKMARK [1][-]{section.1.5}{\376\377\000C\000o\000n\000c\000l\000u\000s\000i\000o\000n}{chapter.1}% 10

package/templates/basic-app/docs/rapport_pfe.tex

@@ -0,0 +1,68 @@
+\documentclass[12pt,a4paper]{report}
+\usepackage[utf8]{inputenc}
+\usepackage[french]{babel}
+\usepackage{graphicx}
+\usepackage{fancyhdr}
+\usepackage{hyperref}
+
+\hypersetup{
+    colorlinks=true,
+    linkcolor=blue,
+    filecolor=magenta,
+    urlcolor=cyan,
+}
+
+\pagestyle{fancy}
+\fancyhf{}
+\rhead{Projet de Fin d'Études}
+\lhead{Rapport de Stage}
+\rfoot{Page \thepage}
+
+\title{Rapport de Projet de Fin d'Études}
+\author{Votre Nom}
+\date{\today}
+
+\begin{document}
+
+\maketitle
+\tableofcontents
+\newpage
+
+\chapter{ÉTUDE PREALABLE}
+
+\section{Introduction}
+Cette section présente une introduction générale au projet, incluant le contexte, les objectifs et la problématique abordée dans ce projet de fin d'études.
+
+\section{Organisme d'accueil}
+Cette section décrit l'organisme d'accueil où s'est déroulé le stage, incluant sa présentation, ses activités principales et sa structure organisationnelle.
+
+\section{Étude et critique de l'existant}
+Cette section analyse la situation actuelle avant l'implémentation du projet.
+
+\subsection{Critique de l'existant}
+Cette partie détaille les limitations, problèmes et défis identifiés dans le système existant qui ont motivé le développement d'une nouvelle solution.
+
+\subsection{Solution proposée}
+Cette partie présente la solution proposée pour résoudre les problèmes identifiés, en décrivant ses principales caractéristiques et avantages.
+
+\section{Choix méthodologique}
+
+\subsection{Formalisme de modélisation}
+Cette section détaille les formalismes de modélisation utilisés pour concevoir et représenter la solution.
+
+\subsection{Méthodologie}
+Cette partie décrit l'approche méthodologique adoptée pour la réalisation du projet.
+
+\subsubsection{Présentation de la méthode SCRUM}
+Cette partie introduit la méthode SCRUM, ses principes fondamentaux et ses avantages dans le contexte du développement logiciel.
+
+\subsubsection{La répartition des rôles dans la méthode SCRUM}
+Cette section explique les différents rôles dans la méthode SCRUM (Product Owner, Scrum Master, équipe de développement) et leurs responsabilités.
+
+\subsubsection{Le processus de SCRUM}
+Cette partie détaille le processus SCRUM avec ses différentes cérémonies (Sprint Planning, Daily Scrum, Sprint Review, Sprint Retrospective) et artefacts (Product Backlog, Sprint Backlog, Increment).
+
+\section{Conclusion}
+Cette section résume les points clés abordés dans ce chapitre et fait la transition vers le chapitre suivant.
+
+\end{document}

package/templates/basic-app/docs/rapport_pfe.toc

@@ -0,0 +1,14 @@
+\babel@toc {french}{}\relax 
+\contentsline {chapter}{\numberline {1}ÉTUDE PREALABLE}{2}{chapter.1}%
+\contentsline {section}{\numberline {1.1}Introduction}{2}{section.1.1}%
+\contentsline {section}{\numberline {1.2}Organisme d'accueil}{2}{section.1.2}%
+\contentsline {section}{\numberline {1.3}Étude et critique de l'existant}{2}{section.1.3}%
+\contentsline {subsection}{\numberline {1.3.1}Critique de l'existant}{2}{subsection.1.3.1}%
+\contentsline {subsection}{\numberline {1.3.2}Solution proposée}{2}{subsection.1.3.2}%
+\contentsline {section}{\numberline {1.4}Choix méthodologique}{3}{section.1.4}%
+\contentsline {subsection}{\numberline {1.4.1}Formalisme de modélisation}{3}{subsection.1.4.1}%
+\contentsline {subsection}{\numberline {1.4.2}Méthodologie}{3}{subsection.1.4.2}%
+\contentsline {subsubsection}{Présentation de la méthode SCRUM}{3}{section*.2}%
+\contentsline {subsubsection}{La répartition des rôles dans la méthode SCRUM}{3}{section*.3}%
+\contentsline {subsubsection}{Le processus de SCRUM}{3}{section*.4}%
+\contentsline {section}{\numberline {1.5}Conclusion}{3}{section.1.5}%