feat: implement CRUD APIs for projects and scenarios with validated schemas

alembic/versions/20251109_01_initial_schema.py

@@ -101,8 +101,10 @@ def upgrade() -> None:
         sa.Column("location", sa.String(length=255), nullable=True),
         sa.Column("operation_type", mining_operation_type, nullable=False),
         sa.Column("description", sa.Text(), nullable=True),
-        sa.Column("created_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
-        sa.Column("updated_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
+        sa.Column("created_at", sa.DateTime(timezone=True),
+                  server_default=sa.func.now(), nullable=False),
+        sa.Column("updated_at", sa.DateTime(timezone=True),
+                  server_default=sa.func.now(), nullable=False),
         sa.PrimaryKeyConstraint("id"),
         sa.UniqueConstraint("name"),
     )
@@ -117,16 +119,21 @@ def upgrade() -> None:
         sa.Column("status", scenario_status, nullable=False),
         sa.Column("start_date", sa.Date(), nullable=True),
         sa.Column("end_date", sa.Date(), nullable=True),
-        sa.Column("discount_rate", sa.Numeric(precision=5, scale=2), nullable=True),
+        sa.Column("discount_rate", sa.Numeric(
+            precision=5, scale=2), nullable=True),
         sa.Column("currency", sa.String(length=3), nullable=True),
         sa.Column("primary_resource", resource_type, nullable=True),
-        sa.Column("created_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
-        sa.Column("updated_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
-        sa.ForeignKeyConstraint(["project_id"], ["projects.id"], ondelete="CASCADE"),
+        sa.Column("created_at", sa.DateTime(timezone=True),
+                  server_default=sa.func.now(), nullable=False),
+        sa.Column("updated_at", sa.DateTime(timezone=True),
+                  server_default=sa.func.now(), nullable=False),
+        sa.ForeignKeyConstraint(
+            ["project_id"], ["projects.id"], ondelete="CASCADE"),
         sa.PrimaryKeyConstraint("id"),
     )
     op.create_index(op.f("ix_scenarios_id"), "scenarios", ["id"], unique=False)
-    op.create_index(op.f("ix_scenarios_project_id"), "scenarios", ["project_id"], unique=False)
+    op.create_index(op.f("ix_scenarios_project_id"),
+                    "scenarios", ["project_id"], unique=False)
 
     op.create_table(
         "financial_inputs",
@@ -139,13 +146,18 @@ def upgrade() -> None:
         sa.Column("currency", sa.String(length=3), nullable=True),
         sa.Column("effective_date", sa.Date(), nullable=True),
         sa.Column("notes", sa.Text(), nullable=True),
-        sa.Column("created_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
-        sa.Column("updated_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
-        sa.ForeignKeyConstraint(["scenario_id"], ["scenarios.id"], ondelete="CASCADE"),
+        sa.Column("created_at", sa.DateTime(timezone=True),
+                  server_default=sa.func.now(), nullable=False),
+        sa.Column("updated_at", sa.DateTime(timezone=True),
+                  server_default=sa.func.now(), nullable=False),
+        sa.ForeignKeyConstraint(
+            ["scenario_id"], ["scenarios.id"], ondelete="CASCADE"),
         sa.PrimaryKeyConstraint("id"),
     )
-    op.create_index(op.f("ix_financial_inputs_id"), "financial_inputs", ["id"], unique=False)
-    op.create_index(op.f("ix_financial_inputs_scenario_id"), "financial_inputs", ["scenario_id"], unique=False)
+    op.create_index(op.f("ix_financial_inputs_id"),
+                    "financial_inputs", ["id"], unique=False)
+    op.create_index(op.f("ix_financial_inputs_scenario_id"),
+                    "financial_inputs", ["scenario_id"], unique=False)
 
     op.create_table(
         "simulation_parameters",
@@ -155,28 +167,41 @@ def upgrade() -> None:
         sa.Column("distribution", distribution_type, nullable=False),
         sa.Column("variable", stochastic_variable, nullable=True),
         sa.Column("resource_type", resource_type, nullable=True),
-        sa.Column("mean_value", sa.Numeric(precision=18, scale=4), nullable=True),
-        sa.Column("standard_deviation", sa.Numeric(precision=18, scale=4), nullable=True),
-        sa.Column("minimum_value", sa.Numeric(precision=18, scale=4), nullable=True),
-        sa.Column("maximum_value", sa.Numeric(precision=18, scale=4), nullable=True),
+        sa.Column("mean_value", sa.Numeric(
+            precision=18, scale=4), nullable=True),
+        sa.Column("standard_deviation", sa.Numeric(
+            precision=18, scale=4), nullable=True),
+        sa.Column("minimum_value", sa.Numeric(
+            precision=18, scale=4), nullable=True),
+        sa.Column("maximum_value", sa.Numeric(
+            precision=18, scale=4), nullable=True),
         sa.Column("unit", sa.String(length=32), nullable=True),
-    sa.Column("metadata", sa.JSON(), nullable=True),
-        sa.Column("created_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
-        sa.Column("updated_at", sa.DateTime(timezone=True), server_default=sa.func.now(), nullable=False),
-        sa.ForeignKeyConstraint(["scenario_id"], ["scenarios.id"], ondelete="CASCADE"),
+        sa.Column("configuration", sa.JSON(), nullable=True),
+        sa.Column("created_at", sa.DateTime(timezone=True),
+                  server_default=sa.func.now(), nullable=False),
+        sa.Column("updated_at", sa.DateTime(timezone=True),
+                  server_default=sa.func.now(), nullable=False),
+        sa.ForeignKeyConstraint(
+            ["scenario_id"], ["scenarios.id"], ondelete="CASCADE"),
         sa.PrimaryKeyConstraint("id"),
     )
-    op.create_index(op.f("ix_simulation_parameters_id"), "simulation_parameters", ["id"], unique=False)
-    op.create_index(op.f("ix_simulation_parameters_scenario_id"), "simulation_parameters", ["scenario_id"], unique=False)
+    op.create_index(op.f("ix_simulation_parameters_id"),
+                    "simulation_parameters", ["id"], unique=False)
+    op.create_index(op.f("ix_simulation_parameters_scenario_id"),
+                    "simulation_parameters", ["scenario_id"], unique=False)
 
 
 def downgrade() -> None:
-    op.drop_index(op.f("ix_simulation_parameters_scenario_id"), table_name="simulation_parameters")
-    op.drop_index(op.f("ix_simulation_parameters_id"), table_name="simulation_parameters")
+    op.drop_index(op.f("ix_simulation_parameters_scenario_id"),
+                  table_name="simulation_parameters")
+    op.drop_index(op.f("ix_simulation_parameters_id"),
+                  table_name="simulation_parameters")
     op.drop_table("simulation_parameters")
 
-    op.drop_index(op.f("ix_financial_inputs_scenario_id"), table_name="financial_inputs")
-    op.drop_index(op.f("ix_financial_inputs_id"), table_name="financial_inputs")
+    op.drop_index(op.f("ix_financial_inputs_scenario_id"),
+                  table_name="financial_inputs")
+    op.drop_index(op.f("ix_financial_inputs_id"),
+                  table_name="financial_inputs")
     op.drop_table("financial_inputs")
 
     op.drop_index(op.f("ix_scenarios_project_id"), table_name="scenarios")