feat: add feature for generating presentation files

.env.example

@@ -1 +1,14 @@
-JWT_KEY=xxx
+OPENAI_API_KEY=PLACEHOLDER_REPLACE_WITH_YOUR_OPENAI_API_KEY_BEFORE_USE
+MAX_IMAGES=5
+OPENAI_MODEL=gpt-5-mini
+
+JWT_KEY=PLACEHOLDER_REPLACE_WITH_STRONG_KEY_MIN_32_CHARS_BEFORE_USE
+
+REDIS_URL=redis:6379
+
+REDIS_HOST=redis
+REDIS_PORT=6379
+
+SERVER_PORT=5000
+
+COMPOSE_PROJECT_NAME=osmodoc

.github/PULL_REQUEST_TEMPLATE/pull_request_template_api.md

@@ -2,7 +2,7 @@
 
 ### Pre-requisites
 
-- [ ] I have gone through the Contributing guidelines for [Submitting a Pull Request (PR)](https://github.com/OsmosysSoftware/document-service/blob/main/CONTRIBUTING.md#submitting-a-pull-request-pr) and ensured that this is not a duplicate PR.
+- [ ] I have gone through the Contributing guidelines for [Submitting a Pull Request (PR)](https://github.com/OsmosysSoftware/osmodoc/blob/main/CONTRIBUTING.md#submitting-a-pull-request-pr) and ensured that this is not a duplicate PR.
 - [ ] I have performed unit testing for the new feature added or updated to ensure the new features added are working as expected.
 - [ ] I have performed preliminary testing to ensure that any existing features are not impacted and any new features are working as expected as a whole.
 - [ ] I have added/updated the `.env.example` file with the required values as applicable.

.gitignore

@@ -352,3 +352,9 @@ MigrationBackup/
 
 # Ionide (cross platform F# VS Code tools) working folder
 .ionide/
+
+# Docker mount volumes
+Temp/
+
+# Additonal Folders
+Generated/

.vscode/launch.json

@@ -0,0 +1,25 @@
+{
+    "version": "0.2.0",
+    "configurations": [
+        {
+            "name": ".NET Core Launch (web)",
+            "type": "coreclr",
+            "request": "launch",
+            "preLaunchTask": "build",
+            "program": "${workspaceFolder}/OsmoDoc.API/bin/Debug/net8.0/OsmoDoc.API.dll",
+            "args": [],
+            "cwd": "${workspaceFolder}",
+            "stopAtEntry": false,
+            "serverReadyAction": {
+                "action": "openExternally",
+                "pattern": "\\\\bNow listening on:\\\\s+(https?://\\\\S+)"
+            },
+            "env": {
+                "ASPNETCORE_ENVIRONMENT": "Development"
+            },
+            "sourceFileMap": {
+                "/Views": "${workspaceFolder}/Views"
+            }
+        }
+    ]
+}

.vscode/tasks.json

@@ -0,0 +1,41 @@
+{
+    "version": "2.0.0",
+    "tasks": [
+        {
+            "label": "build",
+            "command": "dotnet",
+            "type": "process",
+            "args": [
+                "build",
+                "${workspaceFolder}/OsmoDoc.API/OsmoDoc.API.csproj",
+                "/property:GenerateFullPaths=true",
+                "/consoleloggerparameters:NoSummary"
+            ],
+            "problemMatcher": "$msCompile"
+        },
+        {
+            "label": "publish",
+            "command": "dotnet",
+            "type": "process",
+            "args": [
+                "publish",
+                "${workspaceFolder}/OsmoDoc.API/OsmoDoc.API.csproj",
+                "/property:GenerateFullPaths=true",
+                "/consoleloggerparameters:NoSummary"
+            ],
+            "problemMatcher": "$msCompile"
+        },
+        {
+            "label": "watch",
+            "command": "dotnet",
+            "type": "process",
+            "args": [
+                "watch",
+                "run",
+                "--project",
+                "${workspaceFolder}/OsmoDoc.API/OsmoDoc.API.csproj"
+            ],
+            "problemMatcher": "$msCompile"
+        }
+    ]
+}

CONTRIBUTING.md

@@ -1,5 +1,5 @@
-# Contributing to DocumentService
-Welcome to the document-service project! We appreciate your interest in contributing to the project and making it even better. As a contributor, 
+# Contributing to OsmoDoc
+Welcome to the osmodoc project! We appreciate your interest in contributing to the project and making it even better. As a contributor, 
 please follow the guidelines outlined below:
 
 ## Table of contents
@@ -13,8 +13,8 @@ please follow the guidelines outlined below:
 ## Got a question or problem?
 
 **If you have questions or encounter problems, please refrain from opening issues for general support questions**. GitHub issues are primarily for bug 
-reports and feature requests. For general questions and support, consider using [Stack Overflow](https://stackoverflow.com/questions/tagged/document-service) 
-and tag your questions with the `document-service` tag. Here's why Stack Overflow is a preferred platform:
+reports and feature requests. For general questions and support, consider using [Stack Overflow](https://stackoverflow.com/questions/tagged/osmodoc) 
+and tag your questions with the `osmodoc` tag. Here's why Stack Overflow is a preferred platform:
 
 	- Questions and answers are publicly available, helping others.
 	- The voting system on Stack Overflow highlights the best answers.
@@ -23,8 +23,8 @@ To save time for both you and us, we will close issues related to general suppor
 
 ## Found any issues and bugs
 
-If you find a bug in the source code, you can help us by [submitting an issue](https://github.com/OsmosysSoftware/document-service/issues/new) 
-to our GitHub Repository. Even better, you can submit a [pull request](https://github.com/OsmosysSoftware/document-service/pulls) with a fix.
+If you find a bug in the source code, you can help us by [submitting an issue](https://github.com/OsmosysSoftware/osmodoc/issues/new) 
+to our GitHub Repository. Even better, you can submit a [pull request](https://github.com/OsmosysSoftware/osmodoc/pulls) with a fix.
 
 ## Submission guidelines
 
@@ -34,19 +34,19 @@ Before you submit an issue, please check the issue tracker to see if a similar i
 
 For us to address and fix a bug, we need to reproduce it. Thus when submitting a bug report, we will ask for a minimal reproduction scenario using a repository or [Gist](https://gist.github.com/). Providing a live, reproducible scenario helps us understand the issue better. Information to include:
 
-- The version of the document-service you are using.
+- The version of the osmodoc you are using.
 - Any third-party libraries and their versions.
 - A use-case that demonstrates the issue.
 
 Without a minimal reproduction, we may need to close the issue due to insufficient information.
 
-You can file new issues using our [new issue form](https://github.com/OsmosysSoftware/document-service/issues/new).
+You can file new issues using our [new issue form](https://github.com/OsmosysSoftware/osmodoc/issues/new).
 
 ### Submitting a pull request (PR)
 
 Before submitting a Pull Request (PR), please follow these guidelines:
 
-1. Search GitHub [pull requests](https://github.com/OsmosysSoftware/document-service/pulls) to ensure there is no open or closed PR 
+1. Search GitHub [pull requests](https://github.com/OsmosysSoftware/osmodoc/pulls) to ensure there is no open or closed PR 
    related to your submission.
 2. Fork this repository.
 3. Make your changes in a new Git branch.
@@ -63,12 +63,12 @@ Before submitting a Pull Request (PR), please follow these guidelines:
    ```shell
    git push origin my-fix-branch
    ```
-7. Send a pull request to the `document-service:main`.
+7. Send a pull request to the `osmodoc:main`.
 
-- <strong style="color:black">�</strong> **If we suggest changes, then:**
-  - � Make the required updates.
-  - � Ensure that your changes do not break existing functionality or introduce new issues.
-  - � Rebase your branch and force push to your GitHub repository. This will update your Pull Request.
+- <strong style="color:black">�</strong> **If we suggest changes, then:**
+  - � Make the required updates.
+  - � Ensure that your changes do not break existing functionality or introduce new issues.
+  - � Rebase your branch and force push to your GitHub repository. This will update your Pull Request.
 
   That's it! Thank you for your contribution!
 
@@ -90,7 +90,7 @@ To ensure consistency throughout the source code, follow these rules as you work
 ## Commit message guidelines
 
 In this project, we have specific rules for formatting our Git commit messages. These guidelines result in more readable messages that are easy 
-to follow when reviewing the project's history. Additionally, we use these commit messages to **generate the document-service change log**.
+to follow when reviewing the project's history. Additionally, we use these commit messages to **generate the osmodoc change log**.
 
 ### Commit message format
 
@@ -110,7 +110,7 @@ on GitHub as well as in various git tools.
 
 Footer should contain a [closing reference to an issue](https://docs.github.com/en/issues/tracking-your-work-with-issues/linking-a-pull-request-to-an-issue) if any.
 
-Samples: (even more [samples](https://github.com/OsmosysSoftware/document-service/commits/main))
+Samples: (even more [samples](https://github.com/OsmosysSoftware/osmodoc/commits/main))
 `docs: update change log to beta.5`
 `fix: need to depend on latest rxjs and zone.js`
 

Dockerfile

@@ -2,47 +2,51 @@
 FROM mcr.microsoft.com/dotnet/sdk:8.0 AS build
 WORKDIR /app
 
-# Expose the desired port
-ENV ASPNETCORE_ENVIRONMENT=Development
-EXPOSE 5000
-
-# Build configuration variable. Debug as default
-ENV BUILD_CONFIGURATION=Debug
+# Build configuration variable. Debug for development, Release for production
+ENV BUILD_CONFIGURATION=Release
+ENV ASPNETCORE_ENVIRONMENT=Production
 
-# Copy data
-COPY ["DocumentService.API/DocumentService.API.csproj", "DocumentService.API/"]
-COPY ["DocumentService/DocumentService.csproj", "DocumentService/"]
+# Copy the solution and project files
+COPY *.sln ./
+COPY ./OsmoDoc.API/OsmoDoc.API.csproj OsmoDoc.API/
+COPY ./OsmoDoc/OsmoDoc.csproj OsmoDoc/
 
-# Restore the project dependencies
-RUN dotnet restore "./DocumentService.API/./DocumentService.API.csproj"
-RUN dotnet restore "./DocumentService/./DocumentService.csproj"
+# Restore dependencies
+RUN dotnet restore OsmoDoc.API/OsmoDoc.API.csproj
 
-# Copy the rest of the data
-COPY . .
-WORKDIR "/app/DocumentService.API"
+# Copy required project files
+COPY ./OsmoDoc.API/ OsmoDoc.API/
+COPY ./OsmoDoc/ OsmoDoc/
+COPY .env .
 
 # Build the project and store artifacts in /out folder
-RUN dotnet publish "./DocumentService.API.csproj" -c BUILD_CONFIGURATION -o /app/out
+RUN dotnet publish OsmoDoc.API/OsmoDoc.API.csproj -c $BUILD_CONFIGURATION -o out
 
 # Use the official ASP.NET runtime image as the base image
 FROM mcr.microsoft.com/dotnet/aspnet:8.0 AS base
+
 WORKDIR /app
 
+ENV ASPNETCORE_URLS=http://+:5000
+
 # Copy the published artifacts from the build stage
 COPY --from=build /app/out .
 
 # Install only necessary dependencies for wkhtmltopdf, Node.js and npm
-RUN apt-get update \
-    && apt-get install -y --fix-missing wkhtmltopdf \
-    && apt-get install -y --fix-missing nodejs \
-    && apt-get install -y --no-install-recommends npm \
-    && rm -rf /var/lib/apt/lists/*
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    wkhtmltopdf \
+    nodejs \
+    npm && \
+    rm -rf /var/lib/apt/lists/*
 
 # Install wkhtmltopdf and allow execute access
 RUN chmod 755 /usr/bin/wkhtmltopdf
 
-# Install ejs globally without unnecessary dependencies
+# Install EJS globally
 RUN npm install -g --only=prod ejs
 
+# Expose the API port
+EXPOSE 5000
+
 # Set the entry point for the container
-ENTRYPOINT ["dotnet", "DocumentService.API.dll"]
+ENTRYPOINT ["dotnet", "OsmoDoc.API.dll"]