App initiated.

.gitignore

@@ -0,0 +1,3 @@
+bin
+**/*__pycache__
+.env

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Isham Rashik
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

app.py

@@ -0,0 +1,79 @@
+import streamlit as st
+
+from bureaucracy import HRDepartment, FinanceDepartment, BureaucracyAnalyzer
+from utilities import initialize_session_state
+
+
+def main():
+    st.title("Bureaucracy Analyzer")
+
+    initialize_session_state()
+
+    # Sidebar for department selection
+    st.sidebar.title("Select Department")
+    department_choice = st.sidebar.selectbox(
+        "Choose a department", ["Human Resources", "Finance"]
+    )
+
+    # Update department if selection changes
+    if (
+        st.session_state.department is None
+        or st.session_state.department.name != department_choice
+    ):
+        if department_choice == "Human Resources":
+            st.session_state.department = HRDepartment()
+        else:
+            st.session_state.department = FinanceDepartment()
+        st.session_state.current_question_index = 0
+        st.session_state.answers = {}
+
+    department = st.session_state.department
+
+    # Display the current question
+    if st.session_state.current_question_index < len(department.questions):
+        st.subheader(f"Question for {department.name} Department:")
+        current_question = department.questions[st.session_state.current_question_index]
+        st.write(current_question)
+
+        # Use a form to handle the answer submission
+        with st.form(key=f"question_form_{st.session_state.current_question_index}"):
+            user_answer = st.text_area("Your answer:", height=100)
+            submit_button = st.form_submit_button("Next Question")
+
+        if submit_button:
+            if user_answer:
+                st.session_state.answers[current_question] = user_answer
+                st.session_state.current_question_index += 1
+                st.rerun()
+            else:
+                st.warning(
+                    "Please provide an answer before moving to the next question."
+                )
+
+    else:
+        st.subheader("Analysis Results")
+        if st.button("Analyze Bureaucracy"):
+            # Transfer answers to the department object
+            for question, answer in st.session_state.answers.items():
+                department.set_response(question, answer)
+
+            analyzer = BureaucracyAnalyzer()
+            analysis_placeholder = st.empty()
+            code_placeholder = st.empty()
+
+            full_response = ""
+            for chunk in analyzer.analyze_stream(department):
+                full_response += chunk.text
+                analysis_placeholder.markdown(full_response)
+
+            code_placeholder.code(full_response, language="markdown")
+
+        if st.button("Start Over"):
+            st.session_state.current_question_index = 0
+            st.session_state.department = None
+            st.session_state.answers = {}
+            st.rerun()
+
+
+if __name__ == "__main__":
+    main()

bureaucracy/__init__.py

@@ -0,0 +1,10 @@
+from .department import Department, HRDepartment, FinanceDepartment
+from .bureaucracy_analyzer import BureaucracyAnalyzer
+from .constants import (
+    HR_QUESTIONS,
+    FINANCIAL_QUESTIONS,
+    HR_EXAMPLE,
+    FINANCE_EXAMPLE,
+    GEMINI_API_KEY,
+    MODEL_NAME,
+)

bureaucracy/bureaucracy_analyzer.py

@@ -0,0 +1,53 @@
+import os, sys
+from os.path import dirname as up
+
+sys.path.append(os.path.abspath(os.path.join(up(__file__), os.pardir)))
+
+import google.generativeai as genai
+
+from bureaucracy.department import Department, HRDepartment
+from bureaucracy.constants import (
+    HR_EXAMPLE,
+    FINANCE_EXAMPLE,
+    GEMINI_API_KEY,
+    MODEL_NAME,
+)
+
+# Configure Gemini API
+genai.configure(api_key=GEMINI_API_KEY)
+
+
+class BureaucracyAnalyzer:
+    def __init__(self):
+        self.model = genai.GenerativeModel(MODEL_NAME)
+
+    def analyze_stream(self, department: Department) -> str:
+
+        example = (
+            HR_EXAMPLE if isinstance(department, HRDepartment) else FINANCE_EXAMPLE
+        )
+
+        prompt = f"""You are an AI assistant specialized in analyzing and reducing bureaucracy in various departments. Your task is to analyze responses from different departments, identify bottlenecks, calculate bureaucracy levels, propose actions to reduce bureaucracy, and estimate improvements. Use the provided examples as a guide for your analysis and recommendations.
+
+        {example}
+
+        Now, analyze the responses provided by the {department.name} Department below:
+
+        {department.get_response_string()}
+
+        1. Identify bottlenecks and pain points contributing to bureaucracy.
+        2. Calculate the bureaucracy level based on the responses, assigning points to reflect issues like approval levels, manual processes, delays, and interdepartmental coordination.
+        3. Propose specific actions to reduce bureaucracy. Provide examples for each proposed action.
+        4. Calculate the expected bureaucracy score after implementing the suggested actions.
+        5. Provide a summary of expected improvements, including the reduction percentage.
+
+        Key points to consider in your analysis:
+
+        - Assign scores to quantify the level of bureaucracy (e.g., number of approval levels, time delays, frequency of manual processes).
+        - Identify specific bottlenecks for each question and propose relevant actions.
+        - Suggest tools and technologies to simplify identified issues.
+        - Calculate before and after bureaucracy scores to demonstrate the impact of your solutions.
+
+        Final Output: Provide a clear and concise summary of the identified bottlenecks, proposed actions, expected improvements, and the calculated reduction in bureaucracy levels for the department.
+        """
+        return self.model.generate_content(prompt, stream=True)

bureaucracy/constants.py

@@ -0,0 +1,84 @@
+import os
+
+from dotenv import load_dotenv
+
+_ = load_dotenv()
+
+HR_QUESTIONS = [
+    "How many approval levels are required for posting a new job position?",
+    "How long does it typically take to approve a new job posting?",
+    "Are job postings often delayed due to missing information or approvals?",
+    "How many steps are involved from candidate selection to final approval?",
+    "How often do you receive incomplete applications that delay the hiring process?",
+    "Is there a system in place to provide real-time updates to applicants?",
+    "Are background checks and reference verifications automated or manual?",
+    "How often are hiring decisions delayed due to unavailability of decision-makers?",
+    "Could any steps in the hiring process be automated to reduce manual work?",
+    "How often do candidates withdraw due to delays in the hiring process?",
+    "Are there any other departments involved in the hiring approvals that are difficult to coordinate with?",
+]
+
+FINANCIAL_QUESTIONS = [
+    "How many levels of approval are required for travel requests?",
+    "How long does it usually take to approve a travel request?",
+    "Are there frequent delays in getting travel approvals? If yes, why?",
+    "What documents are required for a travel request? Are they digital or paper-based?",
+    "How many steps are involved in the purchase of an item?",
+    "How often are item purchase requests resubmitted due to missing documents?",
+    "Is the purchasing process primarily manual or automated?",
+    "How long does it typically take from request submission to item purchase completion?",
+    "Are there delays caused by miscommunication or lack of clear information?",
+    "Could any part of the travel or purchasing process be streamlined using automation?",
+    "Are there any other departments involved in the approvals for travel or purchases that are hard to coordinate with? ",
+]
+
+HR_EXAMPLE = f"""Human Resources Department Examples (New Hiring Process)
+
+1.	{HR_QUESTIONS[0]} Example Answers: 3 levels (department head, HR manager, dean).
+2.	{HR_QUESTIONS[1]} Example Answers: 7-10 days.
+3.	{HR_QUESTIONS[2]} Example Answers: Yes, frequently due to incomplete forms.
+4.	{HR_QUESTIONS[3]} Example Answers: 5 steps.
+5.	{HR_QUESTIONS[4]} Example Answers: About 30% of the time (i.e., from 10 applications, 3 usually incomplete).
+6.	{HR_QUESTIONS[5]} Example Answers: No, updates are communicated manually.
+7.	{HR_QUESTIONS[6]} Example Answers: Manual.
+8.	{HR_QUESTIONS[7]} Example Answers: About 40% of the time.
+9.	{HR_QUESTIONS[8]} Example Answers: Yes, candidate screening and document verification.
+10.	{HR_QUESTIONS[9]} Example Answers: 15% of the time.
+11.	{HR_QUESTIONS[10]} Example Answers: Yes, finance department for budget confirmation.
+
+Example Analysis:
+
+- Bottleneck: Too many approval levels for job postings and manual background checks.
+- Proposed Action: Implement workflow automation for job postings and digital background checks.
+- Example Tool: Use Microsoft Power Automate for approvals and a digital verification platform for background checks.
+- Expected Improvement: Reduce approval levels from 3 to 1, decrease delays by automating manual steps.
+- Bureaucracy Score Before: 14 points
+- Bureaucracy Score After: 7 points
+- Reduction: 50%"""
+
+FINANCE_EXAMPLE = f"""Financial Department Examples (Travel Request and Item Purchase)
+
+1.	{FINANCIAL_QUESTIONS[0]} Example Answers: 2 levels (department head, finance office).
+2.	{FINANCIAL_QUESTIONS[1]} Example Answers: 5-7 days.
+3.	{FINANCIAL_QUESTIONS[2]} Example Answers: Yes, due to incomplete supporting documents.
+4.	{FINANCIAL_QUESTIONS[3]} Example Answers: Travel form, approval letter; mostly paper-based.
+5.	{FINANCIAL_QUESTIONS[4]} Example Answers: 4 steps.
+6.	{FINANCIAL_QUESTIONS[5]} Example Answers: About 20% of the time.
+7.	{FINANCIAL_QUESTIONS[6]} Example Answers: Primarily manual.
+8.	{FINANCIAL_QUESTIONS[7]} Example Answers: 10-15 days.
+9.	{FINANCIAL_QUESTIONS[8]} Example Answers: Yes, often due to unclear requirements.
+10.	{FINANCIAL_QUESTIONS[9]} Example Answers: Yes, approval and notification processes.
+11.	{FINANCIAL_QUESTIONS[10]} Example Answers: Yes, logistics department for vendor verification.
+
+Example Analysis:
+
+- Bottleneck: Manual purchasing process and frequent resubmissions due to missing documents.
+- Proposed Action: Digitize purchasing documents and implement a shared platform for tracking requests.
+- Example Tool: Use Google Workspace for document digitization and Trello for tracking.
+- Expected Improvement: Reduce manual processes and minimize resubmission delays.
+- Bureaucracy Score Before: 13 points
+- Bureaucracy Score After: 10 points
+- Reduction: 23%"""
+
+GEMINI_API_KEY = os.getenv("GEMINI_API_KEY")
+MODEL_NAME = "gemini-1.5-pro-exp-0827"

bureaucracy/department.py

@@ -0,0 +1,30 @@
+import os, sys
+from os.path import dirname as up
+
+sys.path.append(os.path.abspath(os.path.join(up(__file__), os.pardir)))
+
+from typing import List
+from bureaucracy.constants import HR_QUESTIONS, FINANCIAL_QUESTIONS
+
+
+class Department:
+    def __init__(self, name: str, questions: List[str]):
+        self.name = name
+        self.questions = questions
+        self.responses = {}
+
+    def set_response(self, question: str, response: str):
+        self.responses[question] = response
+
+    def get_response_string(self) -> str:
+        return "\n".join([f"{q}: {self.responses.get(q, '')}" for q in self.questions])
+
+
+class HRDepartment(Department):
+    def __init__(self):
+        super().__init__("Human Resources", HR_QUESTIONS)
+
+
+class FinanceDepartment(Department):
+    def __init__(self):
+        super().__init__("Finance", FINANCIAL_QUESTIONS)

data/sample.txt

@@ -0,0 +1,27 @@
+finance_example = {
+    "Approval Levels for Travel Requests": "3 levels (department head, finance manager, CFO)",
+    "Average Time for Travel Request Approval": "10 days",
+    "Frequency of Delays in Travel Approvals": "Yes, often due to missing receipts or incomplete itineraries",
+    "Documents Required for Travel Request (Digital or Paper-Based)": "Mixture of digital forms and paper receipts",
+    "Number of Steps Involved in Item Purchase": "6 steps",
+    "Frequency of Resubmission Due to Missing Documents": "About 30% of the time",
+    "Purchasing Process (Manual or Automated)": "Mostly manual with some digital elements",
+    "Time from Request Submission to Item Purchase Completion": "20-25 days",
+    "Delays Due to Miscommunication or Lack of Information": "Yes, frequently due to unclear specifications or budget uncertainties",
+    "Opportunities for Streamlining Travel or Purchasing Process": "Yes, potential for full digitization and automation of approvals",
+    "Coordination Issues with Other Departments for Travel/Purchases": "Yes, often delays with HR for travel policy compliance and IT for tech purchases"
+}
+
+hr_example = {
+    How many approval levels are required for posting a new job position? Example Answers: 3 levels (department head, HR manager, dean).
+    How long does it typically take to approve a new job posting? Example Answers: 7-10 days.
+    Are job postings often delayed due to missing information or approvals? Example Answers: Yes, frequently due to incomplete forms.
+    How many steps are involved from candidate selection to final approval? Example Answers: 5 steps.
+    How often do you receive incomplete applications that delay the hiring process? Example Answers: About 30% of the time (i.e., from 10 applications, 3 usually incomplete).
+    Is there a system in place to provide real-time updates to applicants? Example Answers: No, updates are communicated manually.
+    Are background checks and reference verifications automated or manual? Example Answers: Manual.
+    How often are hiring decisions delayed due to unavailability of decision-makers? Example Answers: About 40% of the time.
+    Could any steps in the hiring process be automated to reduce manual work? Example Answers: Yes, candidate screening and document verification.
+    How often do candidates withdraw due to delays in the hiring process? Example Answers: 15% of the time.
+    Are there any other departments involved in the hiring approvals that are difficult to coordinate with? Example Answers: Yes, finance department for budget confirmation.
+}

requirements.txt

@@ -0,0 +1,4 @@
+streamlit
+google-generativeai
+python-dotenv
+pandas

utilities/__init__.py

@@ -0,0 +1 @@
+from .helper import initialize_session_state

utilities/helper.py

@@ -0,0 +1,15 @@
+import os, sys
+from os.path import dirname as up
+
+sys.path.append(os.path.abspath(os.path.join(up(__file__), os.pardir)))
+
+import streamlit as st
+
+
+def initialize_session_state():
+    if "department" not in st.session_state:
+        st.session_state.department = None
+    if "current_question_index" not in st.session_state:
+        st.session_state.current_question_index = 0
+    if "answers" not in st.session_state:
+        st.session_state.answers = {}